GCKUIMediaController-Klasse

Referenz zur GCKUIMediaController-Klasse

Übersicht

Ein Controller für UI-Ansichten, mit dem der Status der Medienwiedergabe auf einem Cast-Empfänger gesteuert oder angezeigt wird.

Die aufrufende Anwendung registriert ihre medienbezogenen UI-Steuerelemente beim Controller, indem sie die entsprechenden Eigenschaften festlegt. Der Controller reagiert dann auf Touch-Ereignisse in den Steuerelementen, indem er die entsprechenden Medienbefehle an den Empfänger ausgibt und die Steuerelemente basierend auf Statusinformationen und Medienmetadaten aktualisiert, die er vom Empfänger empfangen hat. Der Controller aktiviert bzw. deaktiviert automatisch die UI-Steuerelemente gemäß dem aktuellen Sitzungs- und Mediaplayerstatus. Während eine Anfrage ausgeführt wird, werden außerdem alle Steuerelemente deaktiviert.

Weitere Informationen zum Delegatprotokoll finden Sie unter GCKUIMediaControllerDelegate.

Sincé
3,0

Übernimmt NSObject.

Zusammenfassung der Instanzmethoden

(instancetype) - init
 Initialisiert eine Instanz. Mehr...
 
(void) - bindLabel:toMetadataKey:
 Bindet ein UILabel an einen Metadatenschlüssel. Mehr...
 
(void) - bindLabel:toMetadataKey:withFormatter:
 Bindet ein UILabel an einen Metadatenschlüssel. Mehr...
 
(void) - bindTextView:toMetadataKey:
 Bindet eine UITextView an einen Metadatenschlüssel. Mehr...
 
(void) - bindTextView:toMetadataKey:withFormatter:
 Bindet eine UITextView an einen Metadatenschlüssel. Mehr...
 
(void) - bindImageView:toImageHints:
 Bindet eine UIImageView an eine GCKUIImageHints-Instanz. Mehr...
 
(void) - unbindView:
 Hebt die Bindung der angegebenen Ansicht auf Mehr...
 
(void) - unbindAllViews
 Hebt die Bindung aller gebundenen Ansichten auf Mehr...
 
(GCKMediaRepeatMode- cycleRepeatMode
 Ändert den Wiederholungsmodus für die Warteschlange in den nächsten Modus im Zyklus: Mehr...
 
(void) - selectTracks
 Eine praktische Methode zum Anzeigen der Benutzeroberfläche für die Auswahl des Media-Tracks. Mehr...
 

Property-Zusammenfassung

id< GCKUIMediaControllerDelegatedelegate
 Der Bevollmächtigte für den Empfang von Benachrichtigungen von GCKUIMediaController. Mehr...
 
GCKSessionsession
 Die Sitzung, die mit diesem Controller verknüpft ist. Mehr...
 
BOOL mediaLoaded
 Gibt an, ob derzeit Medien auf dem Empfänger geladen oder geladen werden. Mehr...
 
BOOL hasCurrentQueueItem
 Gibt an, ob sich ein aktuelles Element in der Warteschlange befindet. Mehr...
 
BOOL hasLoadingQueueItem
 Gibt an, ob ein Element in der Warteschlange vorab geladen wird. Mehr...
 
GCKMediaPlayerState lastKnownPlayerState
 Der aktuelle bekannte Medienplayerstatus. Mehr...
 
NSTimeInterval lastKnownStreamPosition
 Die aktuelle Position des bekannten Medienstreams. Mehr...
 
UIButton * playButton
 Eine Wiedergabeschaltfläche Mehr...
 
UIButton * pauseButton
 Die Schaltfläche „Pause“. Mehr...
 
GCKUIButtonplayPauseToggleButton
 Ein-/Aus-Schaltfläche für Wiedergabe/Pause. Mehr...
 
GCKUIPlayPauseToggleControllerplayPauseToggleController
 Ein Schieberegler für Wiedergabe/Pause. Mehr...
 
UIButton * stopButton
 Schaltfläche „Stopp“ Mehr...
 
GCKUIButtonforward30SecondsButton
 Eine Schaltfläche zum Vorspulen um 30 Sekunden im aktuell wiedergegebenen Medienelement. Mehr...
 
GCKUIButtonrewind30SecondsButton
 Schaltfläche, mit der Sie sich 30 Sekunden zurückspulen können Mehr...
 
UIButton * pauseQueueButton
 Eine Schaltfläche zum Pausieren der Wiedergabeliste, sobald die Wiedergabe des aktuellen Elements beendet ist. Mehr...
 
UIButton * nextButton
 Schaltfläche „Weiter“ Mehr...
 
UIButton * previousButton
 Schaltfläche „Zurück“ Mehr...
 
GCKUIButtonrepeatModeButton
 Schaltfläche zum Wechseln durch die verfügbaren Wiederholungsmodi für Warteschlangen. Mehr...
 
UISlider * streamPositionSlider
 Ein Schieberegler zum Anzeigen und Ändern der aktuellen Streamposition. Mehr...
 
UIProgressView * streamProgressView
 Eine Ansicht zum Anzeigen des aktuellen Streamfortschritts. Mehr...
 
UILabel * streamPositionLabel
 Ein Label zur Anzeige der aktuellen Streamposition in Minuten und Sekunden. Mehr...
 
UILabel * streamDurationLabel
 Ein Label zur Anzeige der aktuellen Streamdauer in Minuten und Sekunden. Mehr...
 
UILabel * streamTimeRemainingLabel
 Ein Label zur Anzeige der verbleibenden Streamingzeit (Dauer abzüglich der Position) in Minuten und Sekunden. Mehr...
 
GCKUIStreamPositionControllerstreamPositionController
 Ein Streampositionierungs-Controller. Mehr...
 
BOOL displayTimeRemainingAsNegativeValue
 Gibt an, ob die verbleibende Streamingzeit als negativer Wert angezeigt wird, z. B. „-1:23:45“. Mehr...
 
UIButton * tracksButton
 Eine Schaltfläche zur Auswahl von Audiotracks und/oder Untertiteln. Mehr...
 
UILabel * smartSubtitleLabel
 Ein Label zum Anzeigen eines Untertitels für die aktuell geladenen Medien. Mehr...
 
UIActivityIndicatorView * mediaLoadingIndicator
 Eine Aktivitätsanzeige, die angibt, dass die Medien geladen werden. Mehr...
 

Methodendetail

- (instancetype) init

Initialisiert eine Instanz.

- (void) bindLabel: (UILabel *)  label
toMetadataKey: (NSString *)  key 

Bindet ein UILabel an einen Metadatenschlüssel.

In der Ansicht wird der aktuelle Wert des entsprechenden Metadatenfelds angezeigt.

Eine Liste vordefinierter Metadatenschlüssel finden Sie unter GCKMediaMetadata.

Parameters
labelThe UILabel that will display the value.
keyThe metadata key.
- (void) bindLabel: (UILabel *)  label
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

Bindet ein UILabel an einen Metadatenschlüssel.

In der Ansicht wird der aktuelle Wert des entsprechenden Metadatenfelds angezeigt.

Eine Liste vordefinierter Metadatenschlüssel finden Sie unter GCKMediaMetadata.

Parameters
labelThe UILabel that will display the value.
keyThe metadata key.
formatterA block that will produce the desired string representation of the value.
- (void) bindTextView: (UITextView *)  textView
toMetadataKey: (NSString *)  key 

Bindet eine UITextView an einen Metadatenschlüssel.

In der Ansicht wird der aktuelle Wert des entsprechenden Metadatenfelds angezeigt.

Eine Liste vordefinierter Metadatenschlüssel finden Sie unter GCKMediaMetadata.

Parameters
textViewThe UITextView that will display the value.
keyThe metadata key.
- (void) bindTextView: (UITextView *)  textView
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

Bindet eine UITextView an einen Metadatenschlüssel.

In der Ansicht wird der aktuelle Wert des entsprechenden Metadatenfelds angezeigt.

Eine Liste vordefinierter Metadatenschlüssel finden Sie unter GCKMediaMetadata.

Parameters
textViewThe UITextView that will display the value.
keyThe metadata key.
formatterA block that will produce the desired string representation of the value.
- (void) bindImageView: (UIImageView *)  imageView
toImageHints: (GCKUIImageHints *)  imageHints 

Bindet eine UIImageView an eine GCKUIImageHints-Instanz.

Der aktuell installierte UIImagePicker wird verwendet, um ein Bild aus den Metadaten für die Ansicht auszuwählen.

Parameters
imageViewThe UIImageView that will display the selected image.
imageHintsThe image hints.
- (void) unbindView: (UIView *)  view

Hebt die Bindung der angegebenen Ansicht auf

Parameters
viewThe view to unbind.
- (void) unbindAllViews

Hebt die Bindung aller gebundenen Ansichten auf

- (GCKMediaRepeatMode) cycleRepeatMode

Ändert den Wiederholungsmodus für die Warteschlange in den nächsten Modus im Zyklus:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

Gibt Folgendes zurück:
Der neue Wiederholungsmodus.
- (void) selectTracks

Eine praktische Methode zum Anzeigen der Benutzeroberfläche für die Auswahl des Media-Tracks.

Property-Details

- (id<GCKUIMediaControllerDelegate>) delegate
readwritenonatomicweak

Der Bevollmächtigte für den Empfang von Benachrichtigungen von GCKUIMediaController.

- (GCKSession*) session
readnonatomicstrong

Die Sitzung, die mit diesem Controller verknüpft ist.

- (BOOL) mediaLoaded
readnonatomicassign

Gibt an, ob derzeit Medien auf dem Empfänger geladen oder geladen werden.

Wenn keine Streamingsitzung aktiv ist, lautet der Wert NO.

- (BOOL) hasCurrentQueueItem
readnonatomicassign

Gibt an, ob sich ein aktuelles Element in der Warteschlange befindet.

- (BOOL) hasLoadingQueueItem
readnonatomicassign

Gibt an, ob ein Element in der Warteschlange vorab geladen wird.

- (GCKMediaPlayerState) lastKnownPlayerState
readnonatomicassign

Der aktuelle bekannte Medienplayerstatus.

Wenn keine Übertragungssitzung aktiv ist, wird der Player-Status kurz vor dem Ende der letzten Sitzung angezeigt. Wenn keine vorherige Sitzung stattgefunden hat, ist dies GCKMediaPlayerStateUnknown.

- (NSTimeInterval) lastKnownStreamPosition
readnonatomicassign

Die aktuelle Position des bekannten Medienstreams.

Wenn keine Streamingsitzung aktiv ist, wird dies die Streamposition der Medien unmittelbar vor dem Ende der letzten Sitzung. Wenn keine vorherige Sitzung stattgefunden hat, ist dies kGCKInvalidTimeInterval.

- (UIButton*) playButton
readwritenonatomicweak

Eine Wiedergabeschaltfläche

Wenn der Nutzer auf die Schaltfläche tippt, wird die Wiedergabe der aktuell geladenen Medien auf dem Empfänger gestartet oder fortgesetzt. Die Schaltfläche wird deaktiviert, wenn die Wiedergabe bereits läuft, gerade keine Medien geladen sind oder keine Übertragungssitzung aktiv ist.

- (UIButton*) pauseButton
readwritenonatomicweak

Die Schaltfläche „Pause“.

Wenn der Nutzer auf die Schaltfläche tippt, wird die Wiedergabe der aktuell geladenen Medien auf dem Empfänger pausiert. Die Schaltfläche wird deaktiviert, wenn die aktuell geladenen Medien nicht pausiert werden, die Wiedergabe derzeit nicht läuft oder wenn gerade keine Medien geladen werden bzw. keine Streamingsitzung aktiv ist.

- (GCKUIButton*) playPauseToggleButton
readwritenonatomicweak

Ein-/Aus-Schaltfläche für Wiedergabe/Pause.

Der Anrufer sollte entsprechende Symbole für die Status GCKUIControlStatePlay und GCKUIControlStatePause der Schaltfläche festlegen: ein „Pause“-Symbol für den Wiedergabestatus und ein „Wiedergabe“-Symbol für den Pausenstatus. Der Status der Schaltfläche wird automatisch aktualisiert, um den aktuellen Wiedergabestatus des Empfängers widerzuspiegeln. Wenn auf die Schaltfläche getippt wird, wird die Wiedergabe der aktuell geladenen Medien auf dem Empfänger pausiert oder fortgesetzt. Die Schaltfläche wird deaktiviert, wenn die derzeit geladenen Medien nicht pausiert werden, die Wiedergabe gerade nicht läuft oder pausiert ist, wenn gerade keine Medien geladen werden oder wenn gerade keine Übertragungssitzung aktiv ist.

- (GCKUIPlayPauseToggleController*) playPauseToggleController
readwritenonatomicstrong

Ein Schieberegler für Wiedergabe/Pause.

Wird als eigenständige, benutzerdefinierte Ein-/Aus-Schaltfläche zum Umschalten zwischen Wiedergabe und Pause verwendet. Weitere Informationen findest du unter GCKUIPlayPauseToggleController.

Sincé
3,4
- (UIButton*) stopButton
readwritenonatomicweak

Schaltfläche „Stopp“

Beim Tippen auf die Schaltfläche wird die Wiedergabe der aktuell geladenen Medien auf dem Empfänger beendet. Die Schaltfläche wird deaktiviert, wenn derzeit keine Medien geladen sind oder keine Übertragungssitzung aktiv ist.

- (GCKUIButton*) forward30SecondsButton
readwritenonatomicweak

Eine Schaltfläche zum Vorspulen um 30 Sekunden im aktuell wiedergegebenen Medienelement.

Die Schaltfläche wird deaktiviert, wenn derzeit keine Medien geladen sind oder keine Übertragungssitzung aktiv ist.

- (GCKUIButton*) rewind30SecondsButton
readwritenonatomicweak

Schaltfläche, mit der Sie sich 30 Sekunden zurückspulen können

Die Schaltfläche wird deaktiviert, wenn derzeit keine Medien geladen sind oder keine Übertragungssitzung aktiv ist.

- (UIButton*) pauseQueueButton
readwritenonatomicweak

Eine Schaltfläche zum Pausieren der Wiedergabeliste, sobald die Wiedergabe des aktuellen Elements beendet ist.

- (UIButton*) nextButton
readwritenonatomicweak

Schaltfläche „Weiter“

Wenn der Nutzer auf die Schaltfläche tippt, wird die Wiedergabe zum nächsten Medienelement in der Warteschlange verschoben. Die Schaltfläche wird deaktiviert, wenn der Vorgang nicht unterstützt wird, derzeit keine Medien geladen sind oder keine Übertragungssitzung aktiv ist.

- (UIButton*) previousButton
readwritenonatomicweak

Schaltfläche „Zurück“

Beim Tippen auf die Schaltfläche wird die Wiedergabe zum vorherigen Medienelement in der Warteschlange verschoben. Die Schaltfläche wird deaktiviert, wenn der Vorgang nicht unterstützt wird, derzeit keine Medien geladen sind oder keine Übertragungssitzung aktiv ist.

- (GCKUIButton*) repeatModeButton
readwritenonatomicweak

Schaltfläche zum Wechseln durch die verfügbaren Wiederholungsmodi für Warteschlangen.

(Siehe GCKMediaRepeatMode.) Der Aufrufer sollte entsprechende Symbole für die Status UIControlStateNormal (Wiederholen) der Schaltfläche, GCKUIControlStateRepeatSingle, GCKUIControlStateRepeatAll und GCKUIControlStateShuffle festlegen. Der Status der Schaltfläche wird automatisch aktualisiert, um den aktuellen Wiederholungsmodus der Warteschlange auf dem Empfänger widerzuspiegeln. Wenn Sie auf die Schaltfläche tippen, gelangen Sie zum nächsten Wiederholungsmodus in der folgenden Reihenfolge:

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

Die Schaltfläche wird deaktiviert, wenn derzeit keine Cast-Sitzung aktiv ist.

- (UISlider*) streamPositionSlider
readwritenonatomicweak

Ein Schieberegler zum Anzeigen und Ändern der aktuellen Streamposition.

Wenn der Nutzer den Wert des Schiebereglers ändert, wird die Streamposition des aktuell geladenen Mediums auf dem Empfänger aktualisiert. Während der Wiedergabe von Medien auf dem Empfänger wird der Wert des Schiebereglers in Echtzeit aktualisiert, um die aktuelle Streamposition widerzuspiegeln. Der Schieberegler wird deaktiviert, wenn die Suche nach momentan geladenen Medien nicht unterstützt wird, wenn keine Medien geladen sind oder wenn gerade keine Streamingsitzung aktiv ist.

- (UIProgressView*) streamProgressView
readwritenonatomicweak

Eine Ansicht zum Anzeigen des aktuellen Streamfortschritts.

Während der Wiedergabe von Medien auf dem Empfänger wird der Wert der Aufrufe in Echtzeit aktualisiert, um die aktuelle Streamposition widerzuspiegeln. Die Ansicht wird deaktiviert, wenn es sich bei den derzeit geladenen Medien um einen Livestream handelt, wenn keine Medien geladen sind oder wenn gerade keine Streamingsitzung aktiv ist.

- (UILabel*) streamPositionLabel
readwritenonatomicweak

Ein Label zur Anzeige der aktuellen Streamposition in Minuten und Sekunden.

Wenn derzeit keine Medien geladen oder keine Streamingsitzung aktiv ist, wird auf dem Label die lokalisierte Form „--:--“ angezeigt.

- (UILabel*) streamDurationLabel
readwritenonatomicweak

Ein Label zur Anzeige der aktuellen Streamdauer in Minuten und Sekunden.

Wenn die derzeit geladenen Medien keine Dauer haben (z. B. bei einem Livestream), oder wenn derzeit keine Medien geladen sind oder keine Streamingsitzung aktiv ist, wird für das Label die lokalisierte Form „--:--“ angezeigt.

- (UILabel*) streamTimeRemainingLabel
readwritenonatomicweak

Ein Label zur Anzeige der verbleibenden Streamingzeit (Dauer abzüglich der Position) in Minuten und Sekunden.

Wenn die derzeit geladenen Medien keine Dauer haben (z. B. bei einem Livestream), oder wenn derzeit keine Medien geladen sind oder keine Streamingsitzung aktiv ist, wird für das Label die lokalisierte Form „--:--“ angezeigt.

- (GCKUIStreamPositionController*) streamPositionController
readwritenonatomicstrong

Ein Streampositionierungs-Controller.

Wird als Stand-by für eine benutzerdefinierte Position des Streams und/oder eine Such-UI verwendet. Weitere Informationen findest du unter GCKUIStreamPositionController.

Sincé
3,4
- (BOOL) displayTimeRemainingAsNegativeValue
readwritenonatomicassign

Gibt an, ob die verbleibende Streamingzeit als negativer Wert angezeigt wird, z. B. „-1:23:45“.

Diese Eigenschaft ist standardmäßig auf YES festgelegt.

- (UIButton*) tracksButton
readwritenonatomicweak

Eine Schaltfläche zur Auswahl von Audiotracks und/oder Untertiteln.

Wenn der Nutzer auf die Schaltfläche tippt, wird die UI zur Auswahl der Medien-Tracks angezeigt. Die Schaltfläche wird deaktiviert, wenn die derzeit geladenen Medien keine auswählbaren Medientracks enthalten oder wenn derzeit keine Medien geladen sind oder keine Streamingsitzungen aktiv sind.

- (UILabel*) smartSubtitleLabel
readwritenonatomicweak

Ein Label zum Anzeigen eines Untertitels für die aktuell geladenen Medien.

Wenn in den Metadaten kein Untertitelfeld explizit festgelegt ist, zeigt das Label das am besten geeignete Metadatenfeld basierend auf dem Medientyp an, z. B. den Studionamen für einen Film oder den Künstlernamen für einen Musiktitel.

- (UIActivityIndicatorView*) mediaLoadingIndicator
readwritenonatomicweak

Eine Aktivitätsanzeige, die angibt, dass die Medien geladen werden.