Überblick
Controller für UI-Ansichten, mit denen der Status der Medienwiedergabe auf einem Streamingempfänger gesteuert oder angezeigt wird.
Die aufrufende Anwendung registriert ihre medienbezogenen UI-Steuerelemente beim Controller, indem die entsprechenden Eigenschaften festgelegt werden. Der Controller reagiert dann auf Touch-Ereignisse auf den Steuerelementen, indem er die entsprechenden Medienbefehle an den Empfänger ausgibt und die Steuerelemente auf der Grundlage von Statusinformationen und Medienmetadaten aktualisiert, die vom Empfänger empfangen werden. Der Controller aktiviert und deaktiviert die UI-Steuerelemente automatisch je nach aktueller Sitzung und Status des Mediaplayers. Außerdem werden während der Ausführung einer Anfrage alle Steuerelemente deaktiviert.
Weitere Informationen zum Delegatprotokoll finden Sie unter GCKUIMediaControllerDelegate.
- Seit
- 3,0
Übernimmt NSObject.
Übersicht über Instanzmethoden | |
| (instancetype) | - init |
| Initialisiert eine Instanz. Mehr... | |
| (void) | - bindLabel:toMetadataKey: |
| Bindet ein UILabel-Element an einen Metadatenschlüssel. Mehr... | |
| (void) | - bindLabel:toMetadataKey:withFormatter: |
| Bindet ein UILabel-Element 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: |
| Verknüpft eine UIImageView mit einer GCKUIImageHints-Instanz. Mehr... | |
| (void) | - bindControlView:toRewindForTime: |
Verbindet einen UIControl, um die Wiedergabe des aktuellen Elements anhand des übergebenen Werts in Sekunden zurückzuspulen. Mehr... | |
| (void) | - bindControlView:toForwardForTime: |
Bindet einen UIControl, um die Wiedergabe des aktuellen Elements anhand des übergebenen Werts in Sekunden vorzuspulen. Mehr... | |
| (void) | - unbindView: |
| Hebt die Bindung an die angegebene Ansicht auf Mehr... | |
| (void) | - unbindAllViews |
| Hebt die Bindung aller gebundenen Ansichten auf. Mehr... | |
| (GCKMediaRepeatMode) | - cycleRepeatMode |
| Ändert den Wiederholungsmodus für die Warteschlange auf den nächsten Modus im Zyklus: Mehr... | |
| (void) | - selectTracks |
| Eine praktische Methode zum Anzeigen der Benutzeroberfläche für die Auswahl von Medientiteln. Mehr... | |
| (void) | - skipAd |
| Sendet und überwacht die Anfrage zum Überspringen der Anzeige. Mehr... | |
Property-Zusammenfassung | |
| id< GCKUIMediaControllerDelegate > | delegate |
| Der Bevollmächtigte für den Empfang von Benachrichtigungen von GCKUIMediaController. Mehr... | |
| GCKSession * | session |
| Die Sitzung, die mit diesem Controller verknüpft ist. Mehr... | |
| BOOL | mediaLoaded |
| Gibt an, ob Medien derzeit auf dem Empfänger geladen sind (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 vorab in die Warteschlange geladen wird. Mehr... | |
| GCKMediaPlayerState | lastKnownPlayerState |
| Letzter bekannter Mediaplayer-Status. Mehr... | |
| NSTimeInterval | lastKnownStreamPosition |
| Die letzte bekannte Position in einem Medienstream. Mehr... | |
| UIButton * | playButton |
| Eine Wiedergabeschaltfläche Mehr... | |
| UIButton * | pauseButton |
| Schaltfläche „Pause“ Mehr... | |
| GCKUIMultistateButton * | playPauseToggleButton |
| Eine Schaltfläche zum Wechseln zwischen Wiedergabe und Pause Mehr... | |
| GCKUIPlayPauseToggleController * | playPauseToggleController |
| Ein Schieberegler zum Wechseln zwischen Wiedergabe und Pause. Mehr... | |
| UIButton * | stopButton |
| Eine Stopp-Schaltfläche Mehr... | |
| UIButton * | forward30SecondsButton |
| Schaltfläche, mit der im aktuell wiedergegebenen Medienelement 30 Sekunden vorwärts gesucht werden kann Mehr... | |
| UIButton * | rewind30SecondsButton |
| Schaltfläche, mit der Sie im aktuell wiedergegebenen Medienelement 30 Sekunden zurückspulen können Mehr... | |
| UIButton * | pauseQueueButton |
| Eine Schaltfläche zum Anhalten der Wiedergabeliste, nachdem die aktuelle Wiedergabe beendet ist. Mehr... | |
| UIButton * | nextButton |
| Schaltfläche „Weiter“ Mehr... | |
| UIButton * | previousButton |
| Schaltfläche "Zurück" Mehr... | |
| GCKUIMultistateButton * | repeatModeButton |
| Schaltfläche zum Wechseln durch die verfügbaren Wiederholungsmodi für Wiedergabelisten. Mehr... | |
| UISlider * | streamPositionSlider |
| Ein Schieberegler zum Anzeigen und Ändern der aktuellen Streamposition. Mehr... | |
| UIProgressView * | streamProgressView |
| Eine Ansicht zur Anzeige 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 Streamzeit (Dauer minus Position) in Minuten und Sekunden Mehr... | |
| GCKUIStreamPositionController * | streamPositionController |
| Ein Stream-Positionierungs-Controller. Mehr... | |
| GCKUIPlaybackRateController * | playbackRateController |
| Einen Controller für die Stream-Wiedergabegeschwindigkeit. Mehr... | |
| BOOL | displayTimeRemainingAsNegativeValue |
| Gibt an, ob die verbleibende Streamzeit als negativer Wert angezeigt wird, z. B. "-1:23:45". Mehr... | |
| BOOL | hideStreamPositionControlsForLiveContent |
| Gibt an, ob Steuerelemente für die Streamposition (einschließlich des Schiebereglers für die Streamposition, das Label für die Streamposition, das Label für die Streamdauer und die Ansicht zum Fortschritt des Streams) für Liveinhalte ausgeblendet werden sollen. Mehr... | |
| UIButton * | tracksButton |
| Eine Schaltfläche zum Auswählen 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 anzeigt, dass das Medium geladen wird. Mehr... | |
| UILabel * | skipAdLabel |
| Ein Label für die Anzeige der verbleibenden Zeit, bis die Anzeige übersprungen werden kann. Mehr... | |
| UIButton * | skipAdButton |
| Schaltfläche zum Überspringen der aktuellen Anzeige Mehr... | |
Methodendetail
| - (instancetype) init |
Initialisiert eine Instanz.
| - (void) bindLabel: | (UILabel *) | label | |
| toMetadataKey: | (NSString *) | key | |
Bindet ein UILabel-Element 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
-
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-Element 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
-
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 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
-
textView The UITextView that will display the value. key The 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
-
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 | |
Verknüpft eine UIImageView mit einer GCKUIImageHints-Instanz.
Das aktuell installierte GCKUIImagePicker wird zur Auswahl eines Image aus den Metadaten für die Ansicht verwendet.
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The image hints.
| - (void) bindControlView: | (UIControl *) | control | |
| toRewindForTime: | (NSTimeInterval) | rewindSeconds | |
Verbindet einen UIControl, um die Wiedergabe des aktuellen Elements anhand des übergebenen Werts in Sekunden zurückzuspulen.
Die Ansicht wird auf Grundlage des GCKCastSession-Status, des Remote-Wiedergabestatus und danach aktualisiert, ob es sich um einen Livestream handelt. Außerdem wird UIControl ein Ziel hinzugefügt, um das Ereignis UIControlEventTouchUpInside zu erfassen. Fügen Sie kein Ziel dieses Typs in UIControl hinzu. Verwenden Sie stattdessen die Methoden GCKUIMediaControllerDelegate, um das Ereignis zu erfassen.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton.rewindSeconds The number of seconds to rewind the media.
| - (void) bindControlView: | (UIControl *) | control | |
| toForwardForTime: | (NSTimeInterval) | forwardSeconds | |
Bindet einen UIControl, um die Wiedergabe des aktuellen Elements anhand des übergebenen Werts in Sekunden vorzuspulen.
Die Ansicht wird auf Grundlage des GCKCastSession-Status, des Remote-Wiedergabestatus und danach aktualisiert, ob es sich um einen Livestream handelt. Außerdem wird UIControl ein Ziel hinzugefügt, um das Ereignis UIControlEventTouchUpInside zu erfassen. Fügen Sie kein Ziel dieses Typs in UIControl hinzu. Verwenden Sie stattdessen die Methoden GCKUIMediaControllerDelegate, um das Ereignis zu erfassen.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton.forwardSeconds The number of seconds to skip the media.
| - (void) unbindView: | (UIView *) | view |
Hebt die Bindung an die angegebene 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 auf den nächsten Modus im Zyklus:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- Rückgaben
- Der neue Wiederholungsmodus.
| - (void) selectTracks |
Eine praktische Methode zum Anzeigen der Benutzeroberfläche für die Auswahl von Medientiteln.
| - (void) skipAd |
Sendet und überwacht die Anfrage zum Überspringen der Anzeige.
- Seit
- 4,3
Objektdetails
|
readwritenonatomicweak |
Der Bevollmächtigte für den Empfang von Benachrichtigungen von GCKUIMediaController.
|
readnonatomicstrong |
Die Sitzung, die mit diesem Controller verknüpft ist.
|
readnonatomicassign |
Gibt an, ob Medien derzeit auf dem Empfänger geladen sind (oder geladen) werden.
Wenn keine Sitzung aktiv ist, lautet dies NO.
|
readnonatomicassign |
Gibt an, ob sich ein aktuelles Element in der Warteschlange befindet.
|
readnonatomicassign |
Gibt an, ob ein Element vorab in die Warteschlange geladen wird.
|
readnonatomicassign |
Letzter bekannter Mediaplayer-Status.
Wenn keine Übertragungssitzung aktiv ist, wird der Player-Status kurz vor dem Ende der letzten Sitzung angezeigt. Wenn es keine vorherige Sitzung gab, lautet der Wert „GCKMediaPlayerStateUnknown“.
|
readnonatomicassign |
Die letzte bekannte Position in einem Medienstream.
Wenn keine Sitzung aktiv ist, wird die Streamposition der Medien unmittelbar vor dem Ende der letzten Sitzung angezeigt. Wenn es keine vorherige Sitzung gab, ist dies kGCKInvalidTimeInterval.
|
readwritenonatomicweak |
Eine Wiedergabeschaltfläche
Wenn auf die Schaltfläche getippt wird, wird die Wiedergabe der aktuell geladenen Medien auf dem Receiver gestartet oder fortgesetzt. Die Schaltfläche wird deaktiviert, wenn die Wiedergabe bereits läuft, gerade keine Medien geladen sind oder keine Übertragung aktiv ist.
|
readwritenonatomicweak |
Schaltfläche „Pause“
Wenn auf die Schaltfläche getippt wird, wird die Wiedergabe der aktuell geladenen Medien auf dem Receiver angehalten. Die Schaltfläche ist deaktiviert, wenn die aktuell geladenen Medien das Pausieren nicht unterstützen, wenn die Wiedergabe gerade nicht läuft, keine Medien geladen sind oder gerade keine Übertragung aktiv ist.
|
readwritenonatomicweak |
Eine Schaltfläche zum Wechseln zwischen Wiedergabe und Pause
Der Aufrufer sollte geeignete Symbole für die Schaltflächen GCKUIButtonStatePlay, GCKUIButtonStatePlayLive und GCKUIButtonStatePause festlegen: ein Pausensymbol für den Wiedergabestatus, ein Stoppsymbol für den Live-Wiedergabestatus und ein Wiedergabesymbol für den Pausenstatus. Der Schaltflächenstatus wird automatisch aktualisiert, um den aktuellen Wiedergabestatus auf dem Empfänger widerzuspiegeln. Wenn auf die Schaltfläche getippt wird, wird die Wiedergabe der aktuell geladenen Medien auf dem Receiver pausiert oder fortgesetzt. Die Schaltfläche ist deaktiviert, wenn die aktuell geladenen Medien das Pausieren nicht unterstützen, die Wiedergabe gerade nicht läuft oder pausiert ist, keine Medien geladen sind oder gerade keine Übertragung läuft.
|
readwritenonatomicstrong |
Ein Schieberegler zum Wechseln zwischen Wiedergabe und Pause.
Wird als Ersatz für eine benutzerdefinierte, von der Anwendung bereitgestellte Benutzeroberfläche zum Umschalten zwischen Wiedergabe und Pause verwendet. Weitere Informationen findest du unter GCKUIPlayPauseToggleController.
- Seit
- 3,4
|
readwritenonatomicweak |
Eine Stopp-Schaltfläche
Wenn die Taste angetippt wird, wird die Wiedergabe der aktuell geladenen Medien auf dem Receiver gestoppt. Die Schaltfläche wird deaktiviert, wenn derzeit keine Medien geladen werden oder keine Streaming-Sitzung aktiv ist.
|
readwritenonatomicweak |
Schaltfläche, mit der im aktuell wiedergegebenen Medienelement 30 Sekunden vorwärts gesucht werden kann
Die Schaltfläche wird deaktiviert, wenn derzeit keine Medien geladen werden oder keine Streaming-Sitzung aktiv ist.
|
readwritenonatomicweak |
Schaltfläche, mit der Sie im aktuell wiedergegebenen Medienelement 30 Sekunden zurückspulen können
Die Schaltfläche wird deaktiviert, wenn derzeit keine Medien geladen werden oder keine Streaming-Sitzung aktiv ist.
|
readwritenonatomicweak |
Eine Schaltfläche zum Anhalten der Wiedergabeliste, nachdem die aktuelle Wiedergabe beendet ist.
|
readwritenonatomicweak |
Schaltfläche „Weiter“
Wenn auf die Schaltfläche getippt wird, wird das nächste Medienelement in der Wiedergabeliste abgespielt. Die Schaltfläche ist deaktiviert, wenn der Vorgang nicht unterstützt wird, keine Medien geladen sind oder gerade keine Streamingsitzung aktiv ist.
|
readwritenonatomicweak |
Schaltfläche "Zurück"
Wenn auf die Schaltfläche getippt wird, springt die Wiedergabe zum vorherigen Medienelement in der Wiedergabeliste. Die Schaltfläche ist deaktiviert, wenn der Vorgang nicht unterstützt wird, keine Medien geladen sind oder gerade keine Streamingsitzung aktiv ist.
|
readwritenonatomicweak |
Schaltfläche zum Wechseln durch die verfügbaren Wiederholungsmodi für Wiedergabelisten.
(Siehe GCKMediaRepeatMode.) Der Anrufer sollte entsprechende Symbole für die Schaltflächen GCKUIButtonStateRepeatOff, GCKUIButtonStateRepeatSingle, GCKUIButtonStateRepeatAll und GCKUIButtonStateShuffle festlegen. Der Schaltflächenstatus wird automatisch aktualisiert, um den aktuellen Wiedergabelisten-Wiederholungsmodus auf dem Empfänger widerzuspiegeln. 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 wird deaktiviert, wenn derzeit keine Streamingsitzung aktiv ist.
|
readwritenonatomicweak |
Ein Schieberegler zum Anzeigen und Ändern der aktuellen Streamposition.
Wenn der Nutzer den Wert des Schiebereglers ändert, wird die Streamposition der aktuell geladenen Medien auf dem Empfänger aktualisiert. Während die Medienwiedergabe auf dem Empfänger läuft, wird der Wert des Schiebereglers in Echtzeit aktualisiert, um die aktuelle Position des Streams widerzuspiegeln. Der Schieberegler ist deaktiviert, wenn die derzeit geladenen Medien die Suche nicht unterstützen, keine Medien geladen sind oder gerade keine Streamingsitzung aktiv ist.
|
readwritenonatomicweak |
Eine Ansicht zur Anzeige des aktuellen Streamfortschritts
Während die Medienwiedergabe auf dem Receiver läuft, wird der Wert der Aufrufe in Echtzeit aktualisiert, um die aktuelle Stream-Position widerzuspiegeln. Die Ansicht wird deaktiviert, wenn es sich bei den derzeit geladenen Medien um einen Livestream oder um keine Medien handelt oder wenn gerade keine Streamingsitzung aktiv ist.
|
readwritenonatomicweak |
Ein Label zur Anzeige der aktuellen Streamposition in Minuten und Sekunden.
Wenn gerade keine Medien geladen sind oder keine Streaming-Sitzung aktiv ist, wird für das Label die lokalisierte Form "--:--" angezeigt.
|
readwritenonatomicweak |
Ein Label zur Anzeige der aktuellen Streamdauer in Minuten und Sekunden.
Wenn die aktuell geladenen Medien keine Dauer haben (z. B. bei einem Livestream) oder wenn gerade keine Medien geladen sind oder gerade keine Streamingsitzung aktiv ist, wird für das Label die lokalisierte Form „--:--“ angezeigt.
|
readwritenonatomicweak |
Ein Label zur Anzeige der verbleibenden Streamzeit (Dauer minus Position) in Minuten und Sekunden
Wenn die aktuell geladenen Medien keine Dauer haben (z. B. bei einem Livestream) oder wenn gerade keine Medien geladen sind oder gerade keine Streamingsitzung aktiv ist, wird für das Label die lokalisierte Form „--:--“ angezeigt.
|
readwritenonatomicstrong |
Ein Stream-Positionierungs-Controller.
Wird als Ersatz für eine benutzerdefinierte, von der Anwendung bereitgestellte Streamposition und/oder Such-UI verwendet. Weitere Informationen findest du unter GCKUIStreamPositionController.
- Seit
- 3,4
|
readwritenonatomicstrong |
Einen Controller für die Stream-Wiedergabegeschwindigkeit.
Weitere Informationen findest du unter GCKUIPlaybackRateController.
- Seit
- 4,0
|
readwritenonatomicassign |
Gibt an, ob die verbleibende Streamzeit als negativer Wert angezeigt wird, z. B. "-1:23:45".
Standardmäßig ist dieses Attribut auf YES festgelegt.
|
readwritenonatomicassign |
Gibt an, ob Steuerelemente für die Streamposition (einschließlich des Schiebereglers für die Streamposition, das Label für die Streamposition, das Label für die Streamdauer und die Ansicht zum Fortschritt des Streams) für Liveinhalte ausgeblendet werden sollen.
Der Standardwert ist NO.
- Seit
- 4,0
|
readwritenonatomicweak |
Eine Schaltfläche zum Auswählen von Audiotracks und/oder Untertiteln.
Wenn auf die Schaltfläche getippt wird, wird dem Nutzer die Benutzeroberfläche zur Auswahl der Medientitel angezeigt. Die Schaltfläche ist deaktiviert, wenn die aktuell geladenen Medien keine auswählbaren Medientracks haben, keine Medien geladen sind oder keine Streamingsitzung aktiv ist.
|
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 je nach Medientyp das am besten geeignete Metadatenfeld an, z. B. den Studionamen bei einem Film oder den Künstlernamen bei einem Musiktitel.
|
readwritenonatomicweak |
Eine Aktivitätsanzeige, die anzeigt, dass das Medium geladen wird.
|
readwritenonatomicweak |
Ein Label für die Anzeige der verbleibenden Zeit, bis die Anzeige übersprungen werden kann.
- Seit
- 4,3
|
readwritenonatomicweak |
Schaltfläche zum Überspringen der aktuellen Anzeige
- Seit
- 4,3