Clase GCKDeviceManager

Métodos de instancia | Propiedades

Referencia de la clase GCKDeviceManager

Descripción general

Un control para dispositivos de transmisión.

Esta clase puede enviar y recibir mensajes, iniciar y cerrar aplicaciones que se estén ejecutando en un dispositivo de transmisión.

La instancia GCKDeviceManager debe permanecer dentro del alcance, siempre y cuando se establezca una conexión con el dispositivo de transmisión o esté en proceso de creación o eliminació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 de delegado deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) o deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p).

Deprecated:

Usa GCKSessionManager y GCKCastSession para interactuar con receptores de transmisión.

Hereda NSObject.

Resumen del método de instancia
(instancetype)	- initWithDevice:clientPackageName:
	Construye un GCKDeviceManager nuevo con el dispositivo determinado. Más...
(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	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 que se agregó anteriormente. Más...
(NSInteger)	- launchApplication:
	Inicia una aplicación. Más...
(NSInteger)	- launchApplication:withLaunchOptions:
	Inicia una aplicación con las opciones de inicio determinadas. Más...
(NSInteger)	- launchApplication:relaunchIfRunning:
	Inicia una aplicación y, de manera opcional, la reinicia si ya se está ejecutando. Más...
(NSInteger)	- joinApplication:
	Une 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
	Sale de la aplicación actual. Más...
(NSInteger)	- stopApplication
	Detiene todas las aplicaciones en ejecución. Más...
(NSInteger)	- stopApplicationWithSessionID:
	Detiene la aplicación con el ID de sesión de la aplicación especificado. Más...
(NSInteger)	- setVolume:
	Establece el volumen del sistema. Más...
(NSInteger)	- setMuted:
	Activa o desactiva el sonido. Más...
(NSInteger)	- requestDeviceStatus
	Solicita el estado actual del dispositivo. Más...

Resumen de la propiedad
BOOL	ignoreAppStateNotifications
	Establece si este objeto escuchará las notificaciones sobre el estado de la app. Más...
GCKConnectionState	connectionState
	El estado de conexión actual del administrador del dispositivo. Más...
GCKConnectionState	applicationConnectionState
	Estado actual de la conexión de la aplicación del administrador de dispositivos. Más...
BOOL	isConnected
	Verdadero si el administrador de dispositivos estableció una conexión con el dispositivo. Más...
BOOL	isConnectedToApp
	Verdadero si el administrador de dispositivos estableció una conexión con una aplicación en el dispositivo. Más...
BOOL	isReconnecting
	Verdadero si el administrador de dispositivos se desconecta debido a un evento que puede ser transitorio (por ejemplo, la app está en segundo plano o hay un error de red que puede resolverse volviendo a conectarse). Más...
NSTimeInterval	reconnectTimeout
	Durante este tiempo, se intentará realizar la reconexión en caso de que el socket se desconecte con un error potencialmente transitorio. Más...
GCKDevice *	device
	El dispositivo que controla esta GCKDeviceManager. Más...
id< GCKDeviceManagerDelegate >	delegate
	El delegado para recibir notificaciones de GCKDeviceManager. Más...
float	deviceVolume
	El volumen actual del dispositivo en el rango [0.0, 1.0], si se conoce; en caso contrario, 0. Más...
BOOL	deviceMuted
	El estado de silencio actual del dispositivo, si se conoce. De lo contrario, se mostrará NO. Más...
GCKActiveInputStatus	activeInputStatus
	El estado actual de "entrada activa" del dispositivo. Más...
GCKStandbyStatus	standbyStatus
	El estado actual "En espera" del dispositivo. Más...
NSString *	applicationSessionID
	El ID de sesión de la aplicación de la app receptora conectada en este momento, si corresponde. De lo contrario, nil. Más...
GCKApplicationMetadata *	applicationMetadata
	Los metadatos de la aplicación receptora que se encuentra en ejecución en el receptor, si los hubiera; de lo contrario, nil. Más...
NSString *	applicationStatusText
	El texto de estado informado más recientemente de la aplicación receptora en ejecución, si existe. De lo contrario, nil. Más...

Detalle del método

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

Construye un GCKDeviceManager nuevo con el dispositivo determinado.

El objeto detectará 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 cuando la app vuelva a primer plano.

Parameters

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

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

Inicializador designado.

Construye un GCKDeviceManager nuevo para controlar el dispositivo determinado.

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

Si ignoreAppStateNotifications es YES, el objeto no escuchará estas notificaciones y será la aplicación la que administre 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 indefinidamente y, a la larga, el sistema operativo cierra 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.

Debe llamarse a uno de los métodos de desconexión en algún momento después de que se llame a connect y antes de que su propietario libere este objeto.

- (void) disconnectWithLeave:

(BOOL)

leaveApplication

Se desconecta del dispositivo.

Debe llamarse a uno de los métodos de desconexión en algún momento después de que se llame a connect y antes de que su 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.

Resultado que se 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 que se agregó anteriormente.

Parameters

channel

The channel.

Resultado que se muestra

YES si se quitó el canal, NO si no se quitó debido a que no se había adjuntado anteriormente.

- (NSInteger) launchApplication:

(NSString *)

applicationID

Inicia una aplicación.

Parameters

applicationID

The application ID.

Resultado que se muestra

El ID de 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 determinadas.

Parameters

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

Resultado que se muestra

El ID de 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.

Resultado que se muestra

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

- (NSInteger) joinApplication:

(NSString *__nullable)

applicationID

Une 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.

Resultado que se muestra

El ID de 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.

Resultado que se muestra

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

- (BOOL) leaveApplication

Sale de la aplicación actual.

Resultado que se muestra

NO si no se pudo enviar el mensaje.

- (NSInteger) stopApplication

Detiene todas las aplicaciones en ejecución.

Resultado que se muestra

El ID de 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 la aplicación especificado.

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.

Resultado que se muestra

El ID de 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.

Resultado que se muestra

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

- (NSInteger) setMuted:

(BOOL)

muted

Activa o desactiva el sonido.

Parameters

muted

Whether audio should be muted or unmuted.

Resultado que se muestra

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

- (NSInteger) requestDeviceStatus

Solicita el estado actual del dispositivo.

De esta manera, se invocarán todas las devoluciones de llamada de actualización de estado delegadas una vez que se reciba la información de estado actualizada.

Resultado que se muestra

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

Detalles de la propiedad

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

Establece si este objeto escuchará las notificaciones sobre el estado de la app.

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

- (GCKConnectionState) connectionState

readnonatomicassign

El estado de conexión actual del administrador del dispositivo.

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

Estado actual de la conexión de la aplicación del administrador de dispositivos.

- (BOOL) isConnected

readnonatomicassign

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

Deprecated:

Usa connectionState.

- (BOOL) isConnectedToApp

readnonatomicassign

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

Deprecated:

Usa applicationConnectionState.

- (BOOL) isReconnecting

readnonatomicassign

Verdadero si el administrador de dispositivos se desconecta debido a un evento que puede ser transitorio (por ejemplo, la app está en segundo plano o hay un error de red que puede resolverse volviendo a conectarse).

Ten en cuenta que no se llamará a las devoluciones de llamada de desconexión o conexión mientras el administrador del dispositivo intenta reconectarse 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

Durante este tiempo, se intentará realizar la reconexión 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

El dispositivo que controla esta GCKDeviceManager.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

El delegado para recibir notificaciones de GCKDeviceManager.

- (float) deviceVolume

readnonatomicassign

El volumen actual del dispositivo en el rango [0.0, 1.0], si se conoce; en caso contrario, 0.

- (BOOL) deviceMuted

readnonatomicassign

El estado de silencio actual del dispositivo, si se conoce. De lo contrario, se mostrará NO.

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

El estado actual de "entrada activa" del dispositivo.

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

El estado actual "En espera" del dispositivo.

- (NSString*) applicationSessionID

readnonatomiccopy

El ID de sesión de la aplicación de la app receptora conectada en este momento, si corresponde. De lo contrario, nil.

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

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

Los metadatos de la aplicación receptora que se encuentra en ejecución en el receptor, si los hubiera; de lo contrario, nil.

- (NSString*) applicationStatusText

readnonatomiccopy

El texto de estado informado más recientemente de la aplicación receptora en ejecución, si existe. De lo contrario, nil.