Clase GCKDeviceManager

Métodos de instancia | Propiedades

Referencia de la clase GCKDeviceManager

Descripción general

Es un controlador para dispositivos Cast.

Esta clase puede enviar y recibir mensajes, iniciar y cerrar aplicaciones que se ejecutan en un dispositivo Cast.

La instancia de GCKDeviceManager debe permanecer dentro del alcance mientras se establezca una conexión con el dispositivo Cast o esté en proceso de creación o finalización. Es seguro liberar el objeto antes de que se inicie una conexión con connect (GCKDeviceManager) o después de que se haya invocado la devolución de llamada del delegado deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) o deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p).

Deprecated:

Usa GCKSessionManager y GCKCastSession para interactuar con los receptores de Cast.

Hereda de NSObject.

Resumen de métodos de instancia
(instancetype)	- initWithDevice:clientPackageName:
	Crea un nuevo GCKDeviceManager con el dispositivo determinado. Más…
(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	Es el inicializador designado. Más…
(void)	- connect
	Se conecta al dispositivo. Más…
(void)	- disconnect
	Se desconecta del dispositivo. Más…
(void)	- disconnectWithLeave:
	Se desconecta del dispositivo. Más…
(BOOL)	- addChannel:
	Agrega un canal que puede enviar y recibir mensajes para este dispositivo en un espacio de nombres en particular. Más…
(BOOL)	- removeChannel:
	Quita un canal agregado anteriormente. Más…
(NSInteger)	- launchApplication:
	Inicia una aplicación. Más…
(NSInteger)	- launchApplication:withLaunchOptions:
	Inicia una aplicación con las opciones de inicio proporcionadas. Más…
(NSInteger)	- launchApplication:relaunchIfRunning:
	Inicia una aplicación y, de manera opcional, la reinicia si ya se está ejecutando. Más…
(NSInteger)	- joinApplication:
	Se une a una aplicación. Más…
(NSInteger)	- joinApplication:sessionID:
	Une una aplicación con un ID de sesión de aplicación en particular. Más…
(BOOL)	- leaveApplication
	Salir de la aplicación actual Más…
(NSInteger)	- stopApplication
	Detiene las aplicaciones en ejecución. Más…
(NSInteger)	- stopApplicationWithSessionID:
	Detiene la aplicación con el ID de sesión de aplicación determinado. Más…
(NSInteger)	- setVolume:
	Establece el volumen del sistema. Más…
(NSInteger)	- setMuted:
	Activa o desactiva el silencio. Más información…
(NSInteger)	- requestDeviceStatus
	Solicita el estado actual del dispositivo. Más…

Resumen de la propiedad
BOOL	ignoreAppStateNotifications
	Indica si este objeto escuchará las notificaciones de estado de la app. Más…
GCKConnectionState	connectionState
	Es el estado de conexión actual del administrador de dispositivos. Más…
GCKConnectionState	applicationConnectionState
	Es el estado actual de la conexión de la aplicación del administrador de dispositivos. Más…
BOOL	isConnected
	Es verdadero si el administrador de dispositivos estableció una conexión con el dispositivo. Más…
BOOL	isConnectedToApp
	Es verdadero si el administrador de dispositivos estableció una conexión con una aplicación en el dispositivo. Más…
BOOL	isReconnecting
	Es verdadero si el administrador de dispositivos está desconectado debido a un evento potencialmente transitorio (por ejemplo, la app se ejecuta en segundo plano o hubo un error de red que se podría resolver con una reconexión). Más…
NSTimeInterval	reconnectTimeout
	Se intentará la reconexión durante este tiempo en caso de que el socket se desconecte con un error potencialmente transitorio. Más…
GCKDevice *	device
	Es el dispositivo que controla este GCKDeviceManager. Más…
id< GCKDeviceManagerDelegate >	delegate
	Es el delegado para recibir notificaciones de GCKDeviceManager. Más…
float	deviceVolume
	Volumen actual del dispositivo en el rango [0.0, 1.0], si se conoce; de lo contrario, 0. Más…
BOOL	deviceMuted
	Es el estado de silencio actual del dispositivo, si se conoce; de lo contrario, es NO. Más…
GCKActiveInputStatus	activeInputStatus
	Es el estado actual de "entrada activa" del dispositivo. Más…
GCKStandbyStatus	standbyStatus
	Es el estado actual de "espera" del dispositivo. Más…
NSString *	applicationSessionID
	Es el ID de sesión de la aplicación del receptor conectada actualmente, si existe; de lo contrario, es nil. Más…
GCKApplicationMetadata *	applicationMetadata
	Son los metadatos de la aplicación del receptor que se está ejecutando en el receptor, si hay alguno; de lo contrario, es nil. Más…
NSString *	applicationStatusText
	Es el texto de estado informado más recientemente de la aplicación del receptor que se está ejecutando actualmente, si corresponde; de lo contrario, es nil. Más…

Detalle del método

- (instancetype) initWithDevice:		(GCKDevice *)	device
clientPackageName:		(NSString *)	clientPackageName

Crea un nuevo GCKDeviceManager con el dispositivo determinado.

El objeto escuchará las notificaciones de estado de la app y se desconectará automáticamente del dispositivo cuando la app pase a segundo plano, y tratará de volver a conectarse al dispositivo cuando la app regrese a primer plano.

Parameters

device	The device to control.
clientPackageName	The client package name.

- (instancetype) initWithDevice:		(GCKDevice *)	device
clientPackageName:		(NSString *)	clientPackageName
ignoreAppStateNotifications:		(BOOL)	ignoreAppStateNotifications

Es el inicializador designado.

Construye un nuevo GCKDeviceManager para controlar el dispositivo determinado.

Si ignoreAppStateNotifications es NO, el objeto escuchará los cambios en el estado de la app y se desconectará automáticamente del dispositivo cuando la app pase a segundo plano, y tratará de volver a conectarse al dispositivo cuando la app regrese a primer plano.

Si ignoreAppStateNotifications es YES, el objeto no escuchará estas notificaciones y será responsabilidad de la app administrar el ciclo de vida de la conexión. Ten en cuenta que, en general, una app para iOS en segundo plano no puede seguir ejecutándose de forma indefinida, y el sistema operativo cerrará sus conexiones de red activas.

Parameters

device	The device to control.
clientPackageName	The client package name.
ignoreAppStateNotifications	Whether this object will ignore app state notifications.

- (void) connect

Se conecta al dispositivo.

- (void) disconnect

Se desconecta del dispositivo.

Esta es una desconexión explícita.

Se debe llamar a uno de los métodos de desconexión en algún momento después de que se llamó a connect y antes de que el propietario libere este objeto.

- (void) disconnectWithLeave:

(BOOL)

leaveApplication

Se desconecta del dispositivo.

Se debe llamar a uno de los métodos de desconexión en algún momento después de que se llamó a connect y antes de que el propietario libere este objeto.

Parameters

leaveApplication

YES if this is an explicit disconnect that should disconnect from ("leave") the receiver application before closing the connection; NO if this is an implicit disconnect that should just close the connection.

- (BOOL) addChannel:

(GCKCastChannel *)

channel

Agrega un canal que puede enviar y recibir mensajes para este dispositivo en un espacio de nombres en particular.

Parameters

channel

The channel.

Muestra

YES si se agregó el canal, NO si no se agregó porque ya había un canal adjunto para ese espacio de nombres

- (BOOL) removeChannel:

(GCKCastChannel *)

channel

Quita un canal agregado anteriormente.

Parameters

channel

The channel.

Muestra

YES si se quitó el canal, NO si no se quitó porque el canal proporcionado no se había adjuntado antes

- (NSInteger) launchApplication:

(NSString *)

applicationID

Inicia una aplicación.

Parameters

applicationID

The application ID.

Muestra

El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) launchApplication:		(NSString *)	applicationID
withLaunchOptions:		(GCKLaunchOptions *__nullable)	launchOptions

Inicia una aplicación con las opciones de inicio proporcionadas.

Parameters

applicationID	The application ID.
launchOptions	The launch options for this request. If nil, defaults will be used.

Muestra

El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) launchApplication:		(NSString *)	applicationID
relaunchIfRunning:		(BOOL)	relaunchIfRunning

Inicia una aplicación y, de manera opcional, la reinicia si ya se está ejecutando.

Deprecated:

En su lugar, usa launchApplication:withLaunchOptions:.

Parameters

applicationID	The application ID.
relaunchIfRunning	If YES, relaunches the application if it is already running instead of joining the running application.

Muestra

El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) joinApplication:

(NSString *__nullable)

applicationID

Se une a una aplicación.

Parameters

applicationID

The application ID. If nil, attempts to join whichever application is currently running; otherwise, attempts to join the specified application.

Muestra

El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) joinApplication:		(NSString *)	applicationID
sessionID:		(NSString *)	sessionID

Une una aplicación con un ID de sesión de aplicación en particular.

La solicitud fallará si el ID de sesión proporcionado ya no está activo en el receptor.

Parameters

applicationID	The application ID.
sessionID	The application session ID.

Muestra

El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (BOOL) leaveApplication

Salir de la aplicación actual

Muestra

NO si no se pudo enviar el mensaje

- (NSInteger) stopApplication

Detiene las aplicaciones en ejecución.

Muestra

El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) stopApplicationWithSessionID:

(NSString *__nullable)

sessionID

Detiene la aplicación con el ID de sesión de aplicación determinado.

La solicitud fallará si el ID de sesión proporcionado ya no está activo en el receptor.

Parameters

sessionID

The application session ID, which may not be nil.

Muestra

El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) setVolume:

(float)

volume

Establece el volumen del sistema.

Parameters

volume

The new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.

Muestra

El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) setMuted:

(BOOL)

muted

Activa o desactiva el silencio.

Parameters

muted

Whether audio should be muted or unmuted.

Muestra

El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

- (NSInteger) requestDeviceStatus

Solicita el estado actual del dispositivo.

Esto hará que se invoquen todas las devoluciones de llamada de actualización del estado del delegado una vez que se reciba la información de estado actualizada.

Muestra

El ID de la solicitud o kGCKInvalidRequestID si no se pudo enviar la solicitud.

Detalles de la propiedad

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

Indica si este objeto escuchará las notificaciones de estado de la app.

Esta marca se puede especificar en el inicializador. El valor predeterminado es NO.

- (GCKConnectionState) connectionState

readnonatomicassign

Es el estado de conexión actual del administrador de dispositivos.

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

Es el estado actual de la conexión de la aplicación del administrador de dispositivos.

- (BOOL) isConnected

readnonatomicassign

Es verdadero si el administrador de dispositivos estableció una conexión con el dispositivo.

Deprecated:

Usa connectionState.

- (BOOL) isConnectedToApp

readnonatomicassign

Es verdadero si el administrador de dispositivos estableció una conexión con una aplicación en el dispositivo.

Deprecated:

Usa applicationConnectionState.

- (BOOL) isReconnecting

readnonatomicassign

Es verdadero si el administrador de dispositivos está desconectado debido a un evento potencialmente transitorio (por ejemplo, la app se ejecuta en segundo plano o hubo un error de red que se podría resolver con una reconexión).

Ten en cuenta que no se llamará a las devoluciones de llamada de desconexión o conexión mientras el administrador de dispositivos intenta volver a conectarse después de un evento potencialmente transitorio, pero las propiedades siempre reflejarán el estado actual real y se podrán observar.

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

Se intentará la reconexión durante este tiempo en caso de que el socket se desconecte con un error potencialmente transitorio.

El tiempo de espera predeterminado es de 15 segundos.

- (GCKDevice*) device

readnonatomicassign

Es el dispositivo que controla este GCKDeviceManager.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

Es el delegado para recibir notificaciones de GCKDeviceManager.

- (float) deviceVolume

readnonatomicassign

Volumen actual del dispositivo en el rango [0.0, 1.0], si se conoce; de lo contrario, 0.

- (BOOL) deviceMuted

readnonatomicassign

Es el estado de silencio actual del dispositivo, si se conoce; de lo contrario, es NO.

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

Es el estado actual de "entrada activa" del dispositivo.

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

Es el estado actual de "espera" del dispositivo.

- (NSString*) applicationSessionID

readnonatomiccopy

Es el ID de sesión de la aplicación del receptor conectada actualmente, si existe; de lo contrario, es nil.

Se genera un ID de sesión nuevo y único cada vez que se inicia una aplicación receptora (incluso cuando se reinicia la misma aplicación) y permanece vigente mientras la aplicación receptora siga en ejecución.

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

Son los metadatos de la aplicación del receptor que se está ejecutando en el receptor, si hay alguno; de lo contrario, es nil.

- (NSString*) applicationStatusText

readnonatomiccopy

Es el texto de estado informado más recientemente de la aplicación del receptor que se está ejecutando actualmente, si corresponde; de lo contrario, es nil.