GCKUIMediaController-Klasse

Instanzmethoden | Eigenschaften

GCKUIMediaController-Klassenreferenz

Übersicht

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

Die Anrufanwendung registriert ihre mediabezogenen UI-Steuerelemente beim Controller, indem sie die entsprechenden Eigenschaften festlegt. Der Controller reagiert dann auf Berührungsereignisse auf den Steuerelementen, indem er die entsprechenden Medienbefehle an den Empfänger sendet, und aktualisiert die Steuerelemente basierend auf Statusinformationen und Medienmetadaten, die vom Empfänger empfangen werden. Der Controller aktiviert und deaktiviert die UI-Steuerelemente automatisch entsprechend der aktuellen Sitzung und dem Status des Media Players. Außerdem werden alle Steuerelemente deaktiviert, während eine Anfrage läuft.

Das Delegatenprotokoll finden Sie unter GCKUIMediaControllerDelegate.

Seit

3.0

Erbt von NSObject.

Zusammenfassung der Instanzmethoden
(instancetype)	- init
	Initialisiert eine Instanz. Weitere Informationen
(void)	- bindLabel:toMetadataKey:
	Bindet ein UILabel an einen Metadatenschlüssel. Weitere Informationen
(void)	- bindLabel:toMetadataKey:withFormatter:
	Bindet ein UILabel an einen Metadatenschlüssel. Weitere Informationen
(void)	- bindTextView:toMetadataKey:
	Bindet ein UITextView an einen Metadatenschlüssel. Weitere Informationen
(void)	- bindTextView:toMetadataKey:withFormatter:
	Bindet ein UITextView an einen Metadatenschlüssel. Weitere Informationen
(void)	- bindImageView:toImageHints:
	Bindet ein UIImageView an eine GCKUIImageHints-Instanz. Weitere Informationen
(void)	- unbindView:
	Hebt die Bindung der angegebenen Ansicht auf. Weitere Informationen
(void)	- unbindAllViews
	Hebt die Bindung aller gebundenen Ansichten auf. Weitere Informationen
(GCKMediaRepeatMode)	- cycleRepeatMode
	Ändert den Wiederholungsmodus für die Warteschlange in den nächsten Modus im Zyklus: Weitere Informationen
(void)	- selectTracks
	Eine Hilfsmethode zum Anzeigen der UI für die Auswahl von Mediatracks. Weitere Informationen

Zusammenfassung der Property
id< GCKUIMediaControllerDelegate >	delegate
	Der Delegat für den Empfang von Benachrichtigungen von GCKUIMediaController. Weitere Informationen
GCKSession *	session
	Die Sitzung, die diesem Controller zugeordnet ist. Weitere Informationen
BOOL	mediaLoaded
	Gibt an, ob auf dem Empfängergerät gerade Medien geladen werden. Weitere Informationen
BOOL	hasCurrentQueueItem
	Gibt an, ob sich derzeit ein Element in der Warteschlange befindet. Weitere Informationen
BOOL	hasLoadingQueueItem
	Gibt an, ob ein Element in der Warteschlange vorab geladen wird. Weitere Informationen
GCKMediaPlayerState	lastKnownPlayerState
	Der letzte bekannte Status des Mediaplayers. Weitere Informationen
NSTimeInterval	lastKnownStreamPosition
	Die letzte bekannte Position des Media-Streams. Weitere Informationen
UIButton *	playButton
	Eine Wiedergabeschaltfläche. Weitere Informationen
UIButton *	pauseButton
	Eine Schaltfläche zum Pausieren. Weitere Informationen
GCKUIButton *	playPauseToggleButton
	Eine Ein/Aus-Schaltfläche für „Wiedergabe/Pause“. Weitere Informationen
GCKUIPlayPauseToggleController *	playPauseToggleController
	Ein Controller zum Umschalten zwischen Wiedergabe und Pause. Weitere Informationen
UIButton *	stopButton
	Eine Stoppschaltfläche. Weitere Informationen
GCKUIButton *	forward30SecondsButton
	Eine Schaltfläche zum Vorspulen um 30 Sekunden im aktuell wiedergegebenen Media-Element. Weitere Informationen
GCKUIButton *	rewind30SecondsButton
	Eine Schaltfläche zum Zurückspulen des aktuell wiedergegebenen Media-Elements um 30 Sekunden. Weitere Informationen
UIButton *	pauseQueueButton
	Eine Schaltfläche zum Pausieren der Wiedergabe der Warteschlange, sobald das aktuelle Element wiedergegeben wurde. Weitere Informationen
UIButton *	nextButton
	Eine Schaltfläche „Weiter“ Weitere Informationen
UIButton *	previousButton
	Eine Schaltfläche „Zurück“. Weitere Informationen
GCKUIButton *	repeatModeButton
	Eine Schaltfläche zum Durchlaufen der verfügbaren Wiederholungsmodi für die Warteschlange. Weitere Informationen
UISlider *	streamPositionSlider
	Ein Schieberegler zum Anzeigen und Ändern der aktuellen Streamposition. Weitere Informationen
UIProgressView *	streamProgressView
	Eine Ansicht zur Anzeige des aktuellen Streamfortschritts. Weitere Informationen
UILabel *	streamPositionLabel
	Ein Label zur Anzeige der aktuellen Streamposition in Minuten und Sekunden. Weitere Informationen
UILabel *	streamDurationLabel
	Ein Label zur Anzeige der aktuellen Streamdauer in Minuten und Sekunden. Weitere Informationen
UILabel *	streamTimeRemainingLabel
	Ein Label zur Anzeige der verbleibenden Streamingzeit (Dauer minus Position) in Minuten und Sekunden. Weitere Informationen
GCKUIStreamPositionController *	streamPositionController
	Ein Stream-Positionscontroller. Weitere Informationen
BOOL	displayTimeRemainingAsNegativeValue
	Gibt an, ob die verbleibende Streamingzeit als negativer Wert angezeigt wird, z. B. „-1:23:45“. Weitere Informationen
UIButton *	tracksButton
	Eine Schaltfläche zum Auswählen von Audio-Tracks und/oder Untertiteln. Weitere Informationen
UILabel *	smartSubtitleLabel
	Ein Label zum Anzeigen eines Untertitels für die aktuell geladenen Medien. Weitere Informationen
UIActivityIndicatorView *	mediaLoadingIndicator
	Eine Aktivitätsanzeige, die angibt, dass Medien geladen werden. Weitere Informationen

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 der vordefinierten Metadatenschlüssel finden Sie unter GCKMediaMetadata.

Parameters

label	The UILabel that will display the value.
key	The 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 der vordefinierten Metadatenschlüssel finden Sie unter GCKMediaMetadata.

Parameters

label	The UILabel that will display the value.
key	The metadata key.
formatter	A block that will produce the desired string representation of the value.

- (void) bindTextView:		(UITextView *)	textView
toMetadataKey:		(NSString *)	key

Bindet ein UITextView an einen Metadatenschlüssel.

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

Eine Liste der vordefinierten Metadatenschlüssel finden Sie unter GCKMediaMetadata.

Parameters

textView	The UITextView that will display the value.
key	The metadata key.

- (void) bindTextView:		(UITextView *)	textView
toMetadataKey:		(NSString *)	key
withFormatter:		(GCKUIValueFormatter)	formatter

Bindet ein UITextView an einen Metadatenschlüssel.

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

Eine Liste der vordefinierten Metadatenschlüssel finden Sie unter GCKMediaMetadata.

Parameters

textView	The UITextView that will display the value.
key	The metadata key.
formatter	A block that will produce the desired string representation of the value.

- (void) bindImageView:		(UIImageView *)	imageView
toImageHints:		(GCKUIImageHints *)	imageHints

Bindet ein UIImageView an eine GCKUIImageHints-Instanz.

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

Parameters

imageView	The UIImageView that will display the selected image.
imageHints	The image hints.

- (void) unbindView:

(UIView *)

view

Hebt die Bindung der angegebenen Ansicht auf.

Parameters

view	The 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:

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

Ausgabe

Der neue Wiederholungsmodus.

- (void) selectTracks

Eine Hilfsmethode zum Anzeigen der UI für die Auswahl von Mediatracks.

Property-Details

- (id<GCKUIMediaControllerDelegate>) delegate

readwritenonatomicweak

Der Delegat für den Empfang von Benachrichtigungen von GCKUIMediaController.

- (GCKSession*) session

readnonatomicstrong

Die Sitzung, die diesem Controller zugeordnet ist.

- (BOOL) mediaLoaded

readnonatomicassign

Gibt an, ob auf dem Empfängergerät gerade Medien geladen werden.

Wenn keine Übertragungssitzung aktiv ist, ist der Wert NO.

- (BOOL) hasCurrentQueueItem

readnonatomicassign

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

- (BOOL) hasLoadingQueueItem

readnonatomicassign

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

- (GCKMediaPlayerState) lastKnownPlayerState

readnonatomicassign

Der letzte bekannte Status des Mediaplayers.

Wenn keine Cast-Sitzung aktiv ist, ist dies der Playerstatus kurz vor dem Ende der letzten Sitzung. Wenn es keine vorherige Sitzung gab, ist der Wert GCKMediaPlayerStateUnknown.

- (NSTimeInterval) lastKnownStreamPosition

readnonatomicassign

Die letzte bekannte Position des Media-Streams.

Wenn keine Cast-Sitzung aktiv ist, ist dies die Streamposition des Mediums kurz vor dem Ende der letzten Sitzung. Wenn es keine vorherige Sitzung gab, ist der Wert kGCKInvalidTimeInterval.

- (UIButton*) playButton

readwritenonatomicweak

Eine Wiedergabeschaltfläche.

Wenn die Taste gedrückt wird, wird die Wiedergabe der aktuell geladenen Medien auf dem Empfänger gestartet oder fortgesetzt. Die Schaltfläche ist deaktiviert, wenn die Wiedergabe bereits läuft, wenn derzeit keine Medien geladen sind oder wenn keine Cast-Sitzung aktiv ist.

- (UIButton*) pauseButton

readwritenonatomicweak

Eine Schaltfläche zum Pausieren.

Wenn auf die Schaltfläche getippt wird, wird die Wiedergabe der aktuell geladenen Medien auf dem Empfänger pausiert. Die Schaltfläche ist deaktiviert, wenn das aktuell geladene Medium das Pausieren nicht unterstützt, die Wiedergabe derzeit nicht läuft, kein Medium geladen ist oder keine Cast-Sitzung aktiv ist.

- (GCKUIButton*) playPauseToggleButton

readwritenonatomicweak

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

Der Aufrufer sollte geeignete Symbole für die Status GCKUIControlStatePlay und GCKUIControlStatePause der Schaltfläche festlegen, nämlich 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 auf dem Empfänger wiederzugeben. Wenn die Taste gedrückt wird, wird die Wiedergabe der aktuell geladenen Medien auf dem Empfänger pausiert oder fortgesetzt. Die Schaltfläche ist deaktiviert, wenn das aktuell geladene Medium das Pausieren nicht unterstützt, die Wiedergabe derzeit nicht läuft oder pausiert ist, derzeit keine Medien geladen sind oder keine Cast-Sitzung aktiv ist.

- (GCKUIPlayPauseToggleController*) playPauseToggleController

readwritenonatomicstrong

Ein Controller zum Umschalten zwischen Wiedergabe und Pause.

Wird als Ersatz für eine benutzerdefinierte, von der Anwendung bereitgestellte UI zum Umschalten zwischen Wiedergabe und Pause verwendet. Weitere Informationen findest du unter GCKUIPlayPauseToggleController.

Seit

3.4

- (UIButton*) stopButton

readwritenonatomicweak

Eine Stoppschaltfläche.

Wenn die Taste gedrückt wird, wird die Wiedergabe der aktuell geladenen Medien auf dem Empfänger beendet. Die Schaltfläche ist deaktiviert, wenn derzeit keine Medien geladen sind oder keine Cast-Sitzung aktiv ist.

- (GCKUIButton*) forward30SecondsButton

readwritenonatomicweak

Eine Schaltfläche zum Vorspulen um 30 Sekunden im aktuell wiedergegebenen Media-Element.

Die Schaltfläche ist deaktiviert, wenn derzeit keine Medien geladen sind oder keine Cast-Sitzung aktiv ist.

- (GCKUIButton*) rewind30SecondsButton

readwritenonatomicweak

Eine Schaltfläche zum Zurückspulen des aktuell wiedergegebenen Media-Elements um 30 Sekunden.

Die Schaltfläche ist deaktiviert, wenn derzeit keine Medien geladen sind oder keine Cast-Sitzung aktiv ist.

- (UIButton*) pauseQueueButton

readwritenonatomicweak

Eine Schaltfläche zum Pausieren der Wiedergabe der Warteschlange, sobald das aktuelle Element wiedergegeben wurde.

- (UIButton*) nextButton

readwritenonatomicweak

Eine Schaltfläche „Weiter“

Wenn auf die Schaltfläche getippt wird, wird das nächste Media-Element in der Warteschlange wiedergegeben. Die Schaltfläche ist deaktiviert, wenn der Vorgang nicht unterstützt wird, wenn derzeit keine Medien geladen sind oder wenn derzeit keine Cast-Sitzung aktiv ist.

- (UIButton*) previousButton

readwritenonatomicweak

Eine Schaltfläche „Zurück“.

Wenn auf die Schaltfläche getippt wird, wird das vorherige Media-Element in der Warteschlange wiedergegeben. Die Schaltfläche ist deaktiviert, wenn der Vorgang nicht unterstützt wird, wenn derzeit keine Medien geladen sind oder wenn derzeit keine Cast-Sitzung aktiv ist.

- (GCKUIButton*) repeatModeButton

readwritenonatomicweak

Eine Schaltfläche zum Durchlaufen der verfügbaren Wiederholungsmodi für die Warteschlange.

(Siehe GCKMediaRepeatMode.) Der Aufrufer sollte geeignete Symbole für die Status UIControlStateNormal (Wiederholung aus), GCKUIControlStateRepeatSingle, GCKUIControlStateRepeatAll und GCKUIControlStateShuffle der Schaltfläche festlegen. Der Status der Schaltfläche wird automatisch aktualisiert, um den aktuellen Wiederholungsmodus der Warteschlange auf dem Empfänger wiederzugeben. Durch Tippen auf die Schaltfläche wird zum nächsten Wiederholungsmodus gewechselt, und zwar in der folgenden Reihenfolge:

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

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

- (UISlider*) streamPositionSlider

readwritenonatomicweak

Ein Schieberegler zum Anzeigen und Ändern der aktuellen Streamposition.

Wenn der Wert des Schiebereglers vom Nutzer geändert wird, wird die Streamposition der aktuell geladenen Medien auf dem Empfänger aktualisiert. Während die Medien auf dem Empfänger wiedergegeben werden, wird der Wert des Schiebereglers in Echtzeit aktualisiert, um die aktuelle Streamposition widerzuspiegeln. Der Schieberegler wird deaktiviert, wenn die aktuell geladenen Medien keine Suche unterstützen, wenn derzeit keine Medien geladen sind oder wenn derzeit keine Cast-Sitzung aktiv ist.

- (UIProgressView*) streamProgressView

readwritenonatomicweak

Eine Ansicht zur Anzeige des aktuellen Streamfortschritts.

Während die Wiedergabe von Media auf dem Empfänger läuft, wird der Wert der Ansicht in Echtzeit aktualisiert, um die aktuelle Streamposition widerzuspiegeln. Die Ansicht wird deaktiviert, wenn die aktuell geladenen Medien ein Livestream sind, wenn derzeit keine Medien geladen sind oder wenn derzeit keine Cast-Sitzung aktiv ist.

- (UILabel*) streamPositionLabel

readwritenonatomicweak

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

Wenn derzeit keine Medien geladen sind oder keine Cast-Sitzung aktiv ist, wird im Label eine lokalisierte Form von „–:–“ angezeigt.

- (UILabel*) streamDurationLabel

readwritenonatomicweak

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

Wenn die aktuell geladenen Media keine Dauer haben (z. B. bei einem Livestream), wenn derzeit keine Media geladen sind oder wenn derzeit keine Cast-Sitzung aktiv ist, wird im Label eine lokalisierte Form von „–:–“ angezeigt.

- (UILabel*) streamTimeRemainingLabel

readwritenonatomicweak

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

Wenn die aktuell geladenen Media keine Dauer haben (z. B. bei einem Livestream), wenn derzeit keine Media geladen sind oder wenn derzeit keine Cast-Sitzung aktiv ist, wird im Label eine lokalisierte Form von „–:–“ angezeigt.

- (GCKUIStreamPositionController*) streamPositionController

readwritenonatomicstrong

Ein Stream-Positionscontroller.

Wird als Platzhalter für eine benutzerdefinierte, von der Anwendung bereitgestellte Streamposition und/oder Benutzeroberfläche für die Suche verwendet. Weitere Informationen findest du unter GCKUIStreamPositionController.

Seit

3.4

- (BOOL) displayTimeRemainingAsNegativeValue

readwritenonatomicassign

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

Standardmäßig ist dieses Attribut auf YES festgelegt.

- (UIButton*) tracksButton

readwritenonatomicweak

Eine Schaltfläche zum Auswählen von Audio-Tracks und/oder Untertiteln.

Wenn der Nutzer auf die Schaltfläche tippt, wird die Benutzeroberfläche zur Auswahl der Mediatracks angezeigt. Die Schaltfläche ist deaktiviert, wenn für die aktuell geladenen Medien keine auswählbaren Mediatracks vorhanden sind, wenn derzeit keine Medien geladen sind oder wenn derzeit keine Cast-Sitzung aktiv ist.

- (UILabel*) smartSubtitleLabel

readwritenonatomicweak

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

Wenn in den Metadaten kein Untertitelfeld explizit festgelegt ist, wird im Label das am besten geeignete Metadatenfeld basierend auf dem Medientyp angezeigt, z. B. der Name des Studios für einen Film oder der Name des Künstlers für einen Musiktitel.

- (UIActivityIndicatorView*) mediaLoadingIndicator

readwritenonatomicweak

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