GCKCastContext-Klasse

GCKCastContext-Klassenreferenz

Überblick

Eine Klasse, die globale Objekte und einen Status für das Framework enthält.

Der Kontext muss früh im Lebenszyklus der Anwendung über einen Aufruf von setSharedInstanceWithOptions: (GCKCastContext) initialisiert werden.

Seit
3,0

Übernimmt NSObject.

Übersicht über Instanzmethoden

(void) - registerDeviceProvider:
 Registriert einen Geräteanbieter, wodurch ein neuer Gerätetyp (kein Cast-Gerät) unterstützt wird. Mehr...
 
(void) - unregisterDeviceProviderForCategory:
 Hebt die Registrierung des Geräteanbieters für eine bestimmte Gerätekategorie auf Mehr...
 
(void) - setLaunchCredentialsData:
 Legt die Anmeldedatendaten des aktuellen Nutzers fest. Mehr...
 
(void) - presentCastDialog
 Zeigt das Cast-Dialogfeld an. Mehr...
 
(GCKUICastContainerViewController *) - createCastContainerControllerForViewController:
 Erstellt ein GCKUICastContainerViewController, das den angegebenen Ansichts-Controller einbettet. Mehr...
 
(GCKUIMiniMediaControlsViewController *) - createMiniMediaControlsViewController
 Erstellt einen GCKUIMiniMediaControlsViewController. Mehr...
 
(BOOL) - presentCastInstructionsViewControllerOnce
 Falls noch nicht geschehen, wird ein modaler Ansichts-Controller im Vollbildmodus angezeigt, der die Aufmerksamkeit auf das Cast-Symbol lenkt und eine kurze Anleitung zur Verwendung anzeigt. Mehr...
 
(BOOL) - presentCastInstructionsViewControllerOnceWithCastButton:
 Falls nicht bereits geschehen, wird ein modaler Ansichts-Controller im Vollbildmodus angezeigt, der die Aufmerksamkeit auf das Cast-Symbol lenkt, dessen Ansicht übergeben wird, und eine kurze Anleitung zur Verwendung anzeigt. Mehr...
 
(void) - clearCastInstructionsShownFlag
 Löscht das permanente Flag, das aufzeichnet, ob der modale Ansichts-Controller für die Cast-Anleitung angezeigt wurde. Mehr...
 
(void) - presentDefaultExpandedMediaControls
 Zeigt die standardmäßigen erweiterten Mediensteuerelemente von Cast an. Mehr...
 

Klassenmethodenzusammenfassung

(void) + setSharedInstanceWithOptions:
 Legt die gemeinsam genutzte Instanz mit einem Cast-Optionsobjekt fest. Mehr...
 
(BOOL) + setSharedInstanceWithOptions:error:
 Legt die gemeinsam genutzte Instanz mit einem Cast-Optionsobjekt fest. Mehr...
 
(instancetype) + sharedInstance
 Gibt die Singleton-Instanz zurück. Mehr...
 
(BOOL) + isSharedInstanceInitialized
 Prüft, ob die Singleton-Instanz bereits initialisiert wurde. Mehr...
 

Öffentliche Attribute

NSString *const kGCKNotificationKeyCastState
 Der userInfo-Schlüssel für den neuen Übertragungsstatus in einer Benachrichtigung über eine Änderung des Übertragungsstatus. Mehr...
 
NSString *const kGCKCastStateDidChangeNotification
 Der Name der Benachrichtigung, die veröffentlicht wird, wenn sich der Übertragungsstatus ändert. Mehr...
 
NSString *const kGCKExpandedMediaControlsTriggeredNotification
 Der Name der Benachrichtigung, die veröffentlicht wird, wenn Nutzern die maximierten Mediensteuerelemente angezeigt werden sollen. Mehr...
 
NSString *const kGCKUICastDialogWillShowNotification
 Der Name der Benachrichtigung, die kurz vor dem Erscheinen des Cast-Dialogfelds veröffentlicht wird. Mehr...
 
NSString *const kGCKUICastDialogDidHideNotification
 Der Name der Benachrichtigung, die veröffentlicht wird, wenn das Cast-Dialogfeld geschlossen wird. Mehr...
 

Property-Zusammenfassung

GCKCastState castState
 Der aktuelle Übertragungsstatus für die Anwendung. Mehr...
 
GCKDiscoveryManagerdiscoveryManager
 Der Discovery Manager. Mehr...
 
GCKSessionManagersessionManager
 Der Sitzungsmanager. Mehr...
 
id< GCKUIImageCacheimageCache
 Die Implementierung des Bildcaches, die vom Framework zum Abrufen von Bildern verwendet wird, auf die in Medienmetadaten verwiesen wird. Mehr...
 
id< GCKUIImagePickerimagePicker
 Die Implementierung für die Bildauswahl, mit der ein Bild für einen bestimmten Zweck ausgewählt wird. Mehr...
 
BOOL useDefaultExpandedMediaControls
 Mit dieser Richtlinie wird das Verhalten des Frameworks konfiguriert, wenn eine Nutzeraktion dazu führen soll, dass die maximierten Steuerelemente eingeblendet werden. Mehr...
 
GCKUIExpandedMediaControlsViewControllerdefaultExpandedMediaControlsViewController
 Die Instanz des standardmäßigen Ansicht-Controllers für erweiterte Mediensteuerelemente für „Streamen“. Mehr...
 

Methodendetail

+ (void) setSharedInstanceWithOptions: (GCKCastOptions *)  options

Legt die gemeinsam genutzte Instanz mit einem Cast-Optionsobjekt fest.

Wenn die gemeinsam genutzte Instanz bereits initialisiert ist, wird eine Ausnahme ausgelöst.

Parameters
optionsThe Cast options.
+ (BOOL) setSharedInstanceWithOptions: (GCKCastOptions *)  options
error: (GCKError *_Nullable *_Nullable)  error 

Legt die gemeinsam genutzte Instanz mit einem Cast-Optionsobjekt fest.

Der Aufruf schlägt fehl, wenn der Kontext bereits initialisiert ist. Diese Methode muss im Hauptthread aufgerufen werden.

Parameters
optionsThe Cast options.
errorA pointer at which to store the error in case of a failure.
Rückgaben
YES bei Erfolg, NO bei Fehler.
Seit
4,0
+ (instancetype) sharedInstance

Gibt die Singleton-Instanz zurück.

Wenn eine freigegebene Instanz noch nicht initialisiert wurde, wird eine Ausnahme ausgelöst.

+ (BOOL) isSharedInstanceInitialized

Prüft, ob die Singleton-Instanz bereits initialisiert wurde.

Seit
3.5.4
- (void) registerDeviceProvider: (GCKDeviceProvider *)  deviceProvider

Registriert einen Geräteanbieter, wodurch ein neuer Gerätetyp (kein Cast-Gerät) unterstützt wird.

Parameters
deviceProviderAn instance of a GCKDeviceProvider subclass for managing the devices.
- (void) unregisterDeviceProviderForCategory: (NSString *)  category

Hebt die Registrierung des Geräteanbieters für eine bestimmte Gerätekategorie auf

Parameters
categoryA string that uniquely identifies the type of device.
- (void) setLaunchCredentialsData: (GCKCredentialsData *_Nullable)  credentialsData

Legt die Anmeldedatendaten des aktuellen Nutzers fest.

Rufen Sie diese API mit den aktuellen Nutzerinformationen auf, bevor Sie eine Streamingsitzung starten und jedes Mal, wenn das Nutzerkonto geändert wird.

Die Anmeldedaten werden in die Startanfrage eingebettet. Wenn eine Android TV-App gestartet werden soll, kann die App anhand der Anmeldedaten feststellen, ob die App diesen bestimmten Nutzer unterstützt. Andernfalls wird die Cast App gestartet.

Wenn eine Android TV-App gestartet wird, werden die Anmeldedaten innerhalb des Start-Intents an die App übergeben. Die App kann diese Daten verwenden, um die Nutzererfahrung zu personalisieren.

Parameters
credentialsDataAn instance of GCKCredentialsData. May be nil.
- (void) presentCastDialog

Zeigt das Cast-Dialogfeld an.

Bereitgestellt von der Kategorie „GCKCastContext(UI)“.

- (GCKUICastContainerViewController *) createCastContainerControllerForViewController: (UIViewController *)  viewController

Erstellt ein GCKUICastContainerViewController, das den angegebenen Ansichts-Controller einbettet.

Bereitgestellt von der Kategorie „GCKCastContext(UI)“.

- (GCKUIMiniMediaControlsViewController *) createMiniMediaControlsViewController

Erstellt einen GCKUIMiniMediaControlsViewController.

Bereitgestellt von der Kategorie „GCKCastContext(UI)“.

- (BOOL) presentCastInstructionsViewControllerOnce

Falls noch nicht geschehen, wird ein modaler Ansichts-Controller im Vollbildmodus angezeigt, der die Aufmerksamkeit auf das Cast-Symbol lenkt und eine kurze Anleitung zur Verwendung anzeigt.

Rückgaben
YES, wenn der Ansichts-Controller angezeigt wurde, NO, wenn er nicht angezeigt wurde, weil er bereits eingeblendet wurde. Ab Version 4.1 wird NO auch dann zurückgegeben, wenn das Cast-Symbol nicht gefunden wurde.
Deprecated:
Verwende „PresentCastInstructionsViewControllerOnceWithCastButton:“.

Bereitgestellt von der Kategorie „GCKCastContext(UI)“.

- (BOOL) presentCastInstructionsViewControllerOnceWithCastButton: (GCKUICastButton *)  castButton

Falls nicht bereits geschehen, wird ein modaler Ansichts-Controller im Vollbildmodus angezeigt, der die Aufmerksamkeit auf das Cast-Symbol lenkt, dessen Ansicht übergeben wird, und eine kurze Anleitung zur Verwendung anzeigt.

Rückgaben
YES, wenn der Ansichts-Controller angezeigt wurde, NO, wenn er nicht angezeigt wurde, weil er bereits eingeblendet wurde. NO wird auch zurückgegeben, wenn das Cast-Symbol nicht gefunden wurde.
Seit
4,1

Bereitgestellt von der Kategorie „GCKCastContext(UI)“.

- (void) clearCastInstructionsShownFlag

Löscht das permanente Flag, das aufzeichnet, ob der modale Ansichts-Controller für die Cast-Anleitung angezeigt wurde.

Bereitgestellt von der Kategorie „GCKCastContext(UI)“.

- (void) presentDefaultExpandedMediaControls

Zeigt die standardmäßigen erweiterten Mediensteuerelemente von Cast an.

Bereitgestellt von der Kategorie „GCKCastContext(UI)“.

Dokumentation zu Mitgliederdaten

- (NSString* const) kGCKNotificationKeyCastState

Der userInfo-Schlüssel für den neuen Übertragungsstatus in einer Benachrichtigung über eine Änderung des Übertragungsstatus.

- (NSString* const) kGCKCastStateDidChangeNotification

Der Name der Benachrichtigung, die veröffentlicht wird, wenn sich der Übertragungsstatus ändert.

- (NSString* const) kGCKExpandedMediaControlsTriggeredNotification

Der Name der Benachrichtigung, die veröffentlicht wird, wenn Nutzern die maximierten Mediensteuerelemente angezeigt werden sollen.

- (NSString* const) kGCKUICastDialogWillShowNotification

Der Name der Benachrichtigung, die kurz vor dem Erscheinen des Cast-Dialogfelds veröffentlicht wird.

Seit
3,4
- (NSString* const) kGCKUICastDialogDidHideNotification

Der Name der Benachrichtigung, die veröffentlicht wird, wenn das Cast-Dialogfeld geschlossen wird.

Seit
3,4

Objektdetails

- (GCKCastState) castState
readnonatomicassign

Der aktuelle Übertragungsstatus für die Anwendung.

Änderungen an dieser Property können per KVO oder durch Warten auf kGCKCastStateDidChangeNotification-Benachrichtigungen überwacht werden.

- (GCKDiscoveryManager*) discoveryManager
readnonatomicstrong

Der Discovery Manager.

Dieses Objekt übernimmt die Erkennung von Empfängergeräten.

- (GCKSessionManager*) sessionManager
readnonatomicstrong

Der Sitzungsmanager.

Dieses Objekt verwaltet die Interaktion mit Empfängergeräten.

- (id<GCKUIImageCache>) imageCache
readwritenonatomicstrong

Die Implementierung des Bildcaches, die vom Framework zum Abrufen von Bildern verwendet wird, auf die in Medienmetadaten verwiesen wird.

Eine Standardimplementierung wird verwendet, wenn von der Anwendung keine bereitgestellt wird. Kann auf nil gesetzt werden, um den Standard-Bild-Cache wiederherzustellen.

Bereitgestellt von der Kategorie „GCKCastContext(UI)“.

- (id<GCKUIImagePicker>) imagePicker
readwritenonatomicstrong

Die Implementierung für die Bildauswahl, mit der ein Bild für einen bestimmten Zweck ausgewählt wird.

Eine Standardimplementierung wird verwendet, wenn von der Anwendung keine bereitgestellt wird. Kann auf nil gesetzt sein, um die Standardbildauswahl wiederherzustellen.

Bereitgestellt von der Kategorie „GCKCastContext(UI)“.

- (BOOL) useDefaultExpandedMediaControls
readwritenonatomicassign

Mit dieser Richtlinie wird das Verhalten des Frameworks konfiguriert, wenn eine Nutzeraktion dazu führen soll, dass die maximierten Steuerelemente eingeblendet werden.

Bei YES zeigt das Framework die standardmäßige, erweiterte Ansicht der Steuerelemente an. Bei NO löst das Framework nur einen GCKCastContext::kGCKExpandedMediaControlsTriggeredNotification aus.

Bereitgestellt von der Kategorie „GCKCastContext(UI)“.

- (GCKUIExpandedMediaControlsViewController*) defaultExpandedMediaControlsViewController
readnonatomicstrong

Die Instanz des standardmäßigen Ansicht-Controllers für erweiterte Mediensteuerelemente für „Streamen“.

Bereitgestellt von der Kategorie „GCKCastContext(UI)“.