Clase GCKCastContext

Referencia de la clase GCKCastContext

Descripción general

Una clase que contiene objetos globales y el estado del framework.

El contexto debe inicializarse con anticipación en el ciclo de vida de la aplicación mediante una llamada a setSharedInstanceWithOptions: (GCKCastContext).

Since
3.0

Hereda NSObject.

Resumen del método de instancia

(void) - registerDeviceProvider:
 Registra un proveedor de dispositivos, que agrega compatibilidad con un nuevo tipo de dispositivo (que no es Cast). Más...
 
(void) - unregisterDeviceProviderForCategory:
 Cancela el registro del proveedor del dispositivo para una categoría de dispositivo determinada. Más...
 
(void) - setLaunchCredentialsData:
 Establece los datos de las credenciales del usuario actual. Más...
 
(void) - presentCastDialog
 Muestra el cuadro de diálogo de transmisión. Más...
 
(GCKUICastContainerViewController *) - createCastContainerControllerForViewController:
 Construye un GCKUICastContainerViewController que incorpora el controlador de vista determinado. Más...
 
(GCKUIMiniMediaControlsViewController *) - createMiniMediaControlsViewController
 Construye un GCKUIMiniMediaControlsViewController. Más...
 
(BOOL) - presentCastInstructionsViewControllerOnce
 Si no se mostró antes, presenta un controlador de vista modal en pantalla completa que llama la atención al botón para transmitir y muestra un breve texto instructivo sobre su uso. Más...
 
(BOOL) - presentCastInstructionsViewControllerOnceWithCastButton:
 Si no se mostró antes, presenta un controlador de vista modal en pantalla completa que llama la atención al botón para transmitir, cuya vista se pasa, y muestra un breve texto instructivo sobre su uso. Más...
 
(void) - clearCastInstructionsShownFlag
 Borra la marca persistente que rastrea si se mostró el controlador de vista modal de instrucciones de Cast. Más...
 
(void) - presentDefaultExpandedMediaControls
 Muestra los controles multimedia de transmisión expandidos predeterminados. Más...
 

Resumen del método de clase

(void) + setSharedInstanceWithOptions:
 Establece la instancia compartida y proporciona un objeto de opciones de Cast. Más...
 
(BOOL) + setSharedInstanceWithOptions:error:
 Establece la instancia compartida y proporciona un objeto de opciones de Cast. Más...
 
(instancetype) + sharedInstance
 Muestra la instancia singleton. Más...
 
(BOOL) + isSharedInstanceInitialized
 Comprueba si se inicializó la instancia singleton. Más...
 

Atributos públicos

NSString *const kGCKNotificationKeyCastState
 La clave userInfo para el nuevo estado de transmisión en una notificación de cambio de estado de Cast. Más...
 
NSString *const kGCKCastStateDidChangeNotification
 El nombre de la notificación que se publicará cuando cambie el estado de transmisión. Más...
 
NSString *const kGCKExpandedMediaControlsTriggeredNotification
 Es el nombre de la notificación que se publicará cuando se les presenten los controles de contenido multimedia a los usuarios. Más...
 
NSString *const kGCKUICastDialogWillShowNotification
 Es el nombre de la notificación que se publicará cuando el diálogo de transmisión esté a punto de mostrarse. Más...
 
NSString *const kGCKUICastDialogDidHideNotification
 El nombre de la notificación que se publicará cuando se descarte el diálogo de transmisión Más...
 

Resumen de la propiedad

GCKCastState castState
 El estado de transmisión actual de la aplicación. Más...
 
GCKDiscoveryManagerdiscoveryManager
 El administrador de descubrimiento. Más...
 
GCKSessionManagersessionManager
 El administrador de sesiones. Más...
 
id< GCKUIImageCacheimageCache
 Es la implementación de caché de imagen que usará el framework para recuperar imágenes a las que se hace referencia en los metadatos multimedia. Más...
 
id< GCKUIImagePickerimagePicker
 Es la implementación del selector de imágenes que se usará para seleccionar una imagen con un propósito específico. Más...
 
BOOL useDefaultExpandedMediaControls
 Configura el comportamiento del marco de trabajo cuando hay una acción del usuario que debe dar como resultado la presentación de los controles expandidos. Más...
 
GCKUIExpandedMediaControlsViewControllerdefaultExpandedMediaControlsViewController
 La instancia del controlador de vista predeterminado de los controles multimedia de transmisión expandidos. Más...
 

Detalle del método

+ (void) setSharedInstanceWithOptions: (GCKCastOptions *)  options

Establece la instancia compartida y proporciona un objeto de opciones de Cast.

Si ya se inicializó la instancia compartida, se arrojará una excepción.

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

Establece la instancia compartida y proporciona un objeto de opciones de Cast.

La llamada fallará si el contexto ya se inicializó. Se debe llamar a este método en el subproceso principal.

Parameters
optionsThe Cast options.
errorA pointer at which to store the error in case of a failure.
Resultado que se muestra
YES si tiene éxito, NO si se produce un error
Since
4.0
+ (instancetype) sharedInstance

Muestra la instancia singleton.

Si aún no se inicializó una instancia compartida, se arrojará una excepción.

+ (BOOL) isSharedInstanceInitialized

Comprueba si se inicializó la instancia singleton.

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

Registra un proveedor de dispositivos, que agrega compatibilidad con un nuevo tipo de dispositivo (que no es Cast).

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

Cancela el registro del proveedor del dispositivo para una categoría de dispositivo determinada.

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

Establece los datos de las credenciales del usuario actual.

Debes llamar a esta API con la información del usuario actual antes de iniciar una sesión de transmisión y cada vez que se modifique la cuenta de usuario.

Los datos de las credenciales se incorporarán en la solicitud de lanzamiento. Si se trata de iniciar una app para Android TV, esta puede usar los datos de las credenciales a fin de determinar si es compatible con este usuario específico. De lo contrario, se iniciará la app de Cast.

Si se inicia una app de Android TV, los datos de las credenciales se pasarán a la app, dentro del intent de lanzamiento. La app puede usar estos datos para personalizar la experiencia del usuario.

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

Muestra el cuadro de diálogo de transmisión.

Proporcionado por la categoría GCKCastContext(UI).

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

Construye un GCKUICastContainerViewController que incorpora el controlador de vista determinado.

Proporcionado por la categoría GCKCastContext(UI).

- (GCKUIMiniMediaControlsViewController *) createMiniMediaControlsViewController

Construye un GCKUIMiniMediaControlsViewController.

Proporcionado por la categoría GCKCastContext(UI).

- (BOOL) presentCastInstructionsViewControllerOnce

Si no se mostró antes, presenta un controlador de vista modal en pantalla completa que llama la atención al botón para transmitir y muestra un breve texto instructivo sobre su uso.

Resultado que se muestra
YES si se mostró el controlador de vista; NO, si no se mostró, porque ya se había mostrado. A partir de la versión 4.1, también se muestra NO si no se encontró el botón para transmitir.
Deprecated:
Usa presentCastInstructionsViewControllerOnceWithCastButton:

Proporcionado por la categoría GCKCastContext(UI).

- (BOOL) presentCastInstructionsViewControllerOnceWithCastButton: (GCKUICastButton *)  castButton

Si no se mostró antes, presenta un controlador de vista modal en pantalla completa que llama la atención al botón para transmitir, cuya vista se pasa, y muestra un breve texto instructivo sobre su uso.

Resultado que se muestra
YES si se mostró el controlador de vista; NO, si no se mostró, porque ya se había mostrado. También se muestra NO si no se encontró el botón para transmitir.
Since
4.1

Proporcionado por la categoría GCKCastContext(UI).

- (void) clearCastInstructionsShownFlag

Borra la marca persistente que rastrea si se mostró el controlador de vista modal de instrucciones de Cast.

Proporcionado por la categoría GCKCastContext(UI).

- (void) presentDefaultExpandedMediaControls

Muestra los controles multimedia de transmisión expandidos predeterminados.

Proporcionado por la categoría GCKCastContext(UI).

Documentación de datos del miembro

- (NSString* const) kGCKNotificationKeyCastState

La clave userInfo para el nuevo estado de transmisión en una notificación de cambio de estado de Cast.

- (NSString* const) kGCKCastStateDidChangeNotification

El nombre de la notificación que se publicará cuando cambie el estado de transmisión.

- (NSString* const) kGCKExpandedMediaControlsTriggeredNotification

Es el nombre de la notificación que se publicará cuando se les presenten los controles de contenido multimedia a los usuarios.

- (NSString* const) kGCKUICastDialogWillShowNotification

Es el nombre de la notificación que se publicará cuando el diálogo de transmisión esté a punto de mostrarse.

Since
3.4
- (NSString* const) kGCKUICastDialogDidHideNotification

El nombre de la notificación que se publicará cuando se descarte el diálogo de transmisión

Since
3.4

Detalles de la propiedad

- (GCKCastState) castState
readnonatomicassign

El estado de transmisión actual de la aplicación.

Los cambios en esta propiedad se pueden supervisar con KVO o escuchando las notificaciones de kGCKCastStateDidChangeNotification.

- (GCKDiscoveryManager*) discoveryManager
readnonatomicstrong

El administrador de descubrimiento.

Este objeto controla la detección de los dispositivos receptores.

- (GCKSessionManager*) sessionManager
readnonatomicstrong

El administrador de sesiones.

Este objeto administra la interacción con los dispositivos receptores.

- (id<GCKUIImageCache>) imageCache
readwritenonatomicstrong

Es la implementación de caché de imagen que usará el framework para recuperar imágenes a las que se hace referencia en los metadatos multimedia.

Se usará una implementación predeterminada si la aplicación no proporciona una. Se puede establecer en nil para restablecer la caché de imagen predeterminada.

Proporcionado por la categoría GCKCastContext(UI).

- (id<GCKUIImagePicker>) imagePicker
readwritenonatomicstrong

Es la implementación del selector de imágenes que se usará para seleccionar una imagen con un propósito específico.

Se usará una implementación predeterminada si la aplicación no proporciona una. Se puede establecer en nil para restablecer el selector de imágenes predeterminado.

Proporcionado por la categoría GCKCastContext(UI).

- (BOOL) useDefaultExpandedMediaControls
readwritenonatomicassign

Configura el comportamiento del marco de trabajo cuando hay una acción del usuario que debe dar como resultado la presentación de los controles expandidos.

Si es YES, el framework presentará la vista predeterminada de controles expandidos. Si es NO, el framework solo activará un GCKCastContext::kGCKExpandedMediaControlsTriggeredNotification.

Proporcionado por la categoría GCKCastContext(UI).

- (GCKUIExpandedMediaControlsViewController*) defaultExpandedMediaControlsViewController
readnonatomicstrong

La instancia del controlador de vista predeterminado de los controles multimedia de transmisión expandidos.

Proporcionado por la categoría GCKCastContext(UI).