Classe GCKDeviceManager

Métodos de instância | Propriedades

Referência da classe GCKDeviceManager

Visão geral

Um controlador para dispositivos Cast.

Essa classe pode enviar e receber mensagens, iniciar e fechar aplicativos em execução em um dispositivo Cast.

A instância GCKDeviceManager precisa permanecer no escopo enquanto uma conexão com o dispositivo de transmissão estiver estabelecida ou em processo de criação ou encerramento. É seguro liberar o objeto antes que uma conexão seja iniciada com connect (GCKDeviceManager) ou depois que o callback delegado deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) ou deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p) for invocado.

Deprecated:

Use GCKSessionManager e GCKCastSession para interagir com receptores do Cast.

Herda o NSObject.

Resumo do método de instância
(instancetype)	- initWithDevice:clientPackageName:
	Constrói um novo GCKDeviceManager com o dispositivo especificado. Mais...
(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	Inicializador designado. Mais...
(void)	- connect
	Conecta ao dispositivo. Mais...
(void)	- disconnect
	Desconecta do dispositivo. Mais...
(void)	- disconnectWithLeave:
	Desconecta do dispositivo. Mais...
(BOOL)	- addChannel:
	Adiciona um canal que pode enviar e receber mensagens para este dispositivo em um namespace específico. Mais...
(BOOL)	- removeChannel:
	Remove um canal adicionado anteriormente. Mais...
(NSInteger)	- launchApplication:
	Inicia um aplicativo. Mais...
(NSInteger)	- launchApplication:withLaunchOptions:
	Inicia um aplicativo usando as opções de inicialização fornecidas. Mais...
(NSInteger)	- launchApplication:relaunchIfRunning:
	Inicia um aplicativo, reiniciando-o opcionalmente se ele já estiver em execução. Mais...
(NSInteger)	- joinApplication:
	Entra em um aplicativo. Mais...
(NSInteger)	- joinApplication:sessionID:
	Associa um aplicativo a um ID de sessão de aplicativo específico. Mais...
(BOOL)	- leaveApplication
	Sai do aplicativo atual. Mais...
(NSInteger)	- stopApplication
	Interrompe todos os aplicativos em execução. Mais...
(NSInteger)	- stopApplicationWithSessionID:
	Interrompe o aplicativo com o ID de sessão especificado. Mais...
(NSInteger)	- setVolume:
	Define o volume do sistema. Mais...
(NSInteger)	- setMuted:
	Ativa ou desativa o mudo. Mais...
(NSInteger)	- requestDeviceStatus
	Solicita o status atual do dispositivo. Mais...

Resumo da propriedade
BOOL	ignoreAppStateNotifications
	Indica se este objeto vai detectar notificações de estado do app. Mais...
GCKConnectionState	connectionState
	O estado atual da conexão do gerenciador de dispositivos. Mais...
GCKConnectionState	applicationConnectionState
	O estado atual da conexão do aplicativo do gerenciador de dispositivos. Mais...
BOOL	isConnected
	Verdadeiro se o gerenciador de dispositivos tiver estabelecido uma conexão com o dispositivo. Mais...
BOOL	isConnectedToApp
	Verdadeiro se o gerenciador de dispositivos tiver estabelecido uma conexão com um aplicativo no dispositivo. Mais...
BOOL	isReconnecting
	Verdadeiro se o gerenciador de dispositivos for desconectado devido a um evento potencialmente transitório (por exemplo, o app está em segundo plano ou houve um erro de rede que pode ser resolvido com uma reconexão). Mais...
NSTimeInterval	reconnectTimeout
	A reconexão será tentada por esse período caso o soquete se desconecte com um erro potencialmente transitório. Mais...
GCKDevice *	device
	O dispositivo controlado por este GCKDeviceManager. Mais...
id< GCKDeviceManagerDelegate >	delegate
	O delegado para receber notificações do GCKDeviceManager. Mais...
float	deviceVolume
	O volume atual do dispositivo no intervalo [0.0, 1.0], se conhecido. Caso contrário, 0. Mais...
BOOL	deviceMuted
	O estado atual de desativação do dispositivo, se conhecido. Caso contrário, NO. Mais...
GCKActiveInputStatus	activeInputStatus
	O status atual de "entrada ativa" do dispositivo. Mais...
GCKStandbyStatus	standbyStatus
	O status "em espera" atual do dispositivo. Mais...
NSString *	applicationSessionID
	O ID da sessão do aplicativo para o aplicativo receptor conectado no momento, se houver. Caso contrário, nil. Mais...
GCKApplicationMetadata *	applicationMetadata
	Os metadados do aplicativo receptor que está sendo executado no receptor, se houver. Caso contrário, nil. Mais...
NSString *	applicationStatusText
	O texto de status informado mais recentemente do aplicativo receptor em execução, se houver. Caso contrário, nil. Mais...

Detalhes do método

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

Constrói um novo GCKDeviceManager com o dispositivo especificado.

O objeto vai detectar notificações de estado do app e se desconectar automaticamente do dispositivo quando o app for para segundo plano. Ele também vai tentar se reconectar quando o app voltar para o primeiro plano.

Parameters

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

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

Inicializador designado.

Cria um novo GCKDeviceManager para controlar o dispositivo especificado.

Se ignoreAppStateNotifications for NO, o objeto vai detectar mudanças no estado do app e se desconectar automaticamente do dispositivo quando o app entrar em segundo plano. Ele também vai tentar se reconectar quando o app voltar ao primeiro plano.

Se ignoreAppStateNotifications for YES, o objeto não vai ficar aguardando essas notificações, e será responsabilidade do app gerenciar o ciclo de vida da conexão. Em geral, um app iOS em segundo plano não pode continuar sendo executado indefinidamente, e as conexões de rede ativas serão fechadas pelo sistema operacional.

Parameters

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

- (void) connect

Conecta ao dispositivo.

- (void) disconnect

Desconecta do dispositivo.

Essa é uma desconexão explícita.

Um dos métodos de desconexão precisa ser chamado em algum momento depois que connect foi chamado e antes que esse objeto seja liberado pelo proprietário.

- (void) disconnectWithLeave:

(BOOL)

leaveApplication

Desconecta do dispositivo.

Um dos métodos de desconexão precisa ser chamado em algum momento depois que connect foi chamado e antes que esse objeto seja liberado pelo proprietário.

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

Adiciona um canal que pode enviar e receber mensagens para este dispositivo em um namespace específico.

Parameters

channel

The channel.

Retorna

YES se o canal foi adicionado, NO se não foi adicionado porque já havia um canal anexado a esse namespace.

- (BOOL) removeChannel:

(GCKCastChannel *)

channel

Remove um canal adicionado anteriormente.

Parameters

channel

The channel.

Retorna

YES se o canal foi removido, NO se não foi removido porque o canal especificado não estava anexado anteriormente.

- (NSInteger) launchApplication:

(NSString *)

applicationID

Inicia um aplicativo.

Parameters

applicationID

The application ID.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

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

Inicia um aplicativo usando as opções de inicialização fornecidas.

Parameters

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

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

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

Inicia um aplicativo, reiniciando-o opcionalmente se ele já estiver em execução.

Deprecated:

Use launchApplication:withLaunchOptions:, em vez disso.

Parameters

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

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) joinApplication:

(NSString *__nullable)

applicationID

Entra em um aplicativo.

Parameters

applicationID

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

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

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

Associa um aplicativo a um ID de sessão de aplicativo específico.

A solicitação vai falhar se o ID da sessão fornecido não estiver mais ativo no receptor.

Parameters

applicationID	The application ID.
sessionID	The application session ID.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (BOOL) leaveApplication

Sai do aplicativo atual.

Retorna

NO se a mensagem não puder ser enviada.

- (NSInteger) stopApplication

Interrompe todos os aplicativos em execução.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) stopApplicationWithSessionID:

(NSString *__nullable)

sessionID

Interrompe o aplicativo com o ID de sessão especificado.

A solicitação vai falhar se o ID da sessão fornecido não estiver mais ativo no receptor.

Parameters

sessionID

The application session ID, which may not be nil.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) setVolume:

(float)

volume

Define o volume do sistema.

Parameters

volume

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

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) setMuted:

(BOOL)

muted

Ativa ou desativa o mudo.

Parameters

muted

Whether audio should be muted or unmuted.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

- (NSInteger) requestDeviceStatus

Solicita o status atual do dispositivo.

Isso vai resultar na invocação de todos os callbacks de atualização de status do delegado assim que as informações de status atualizadas forem recebidas.

Retorna

O ID da solicitação ou kGCKInvalidRequestID se não foi possível enviar a solicitação.

Detalhes da propriedade

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

Indica se este objeto vai detectar notificações de estado do app.

Essa flag pode ser especificada no inicializador. O valor padrão é NO.

- (GCKConnectionState) connectionState

readnonatomicassign

O estado atual da conexão do gerenciador de dispositivos.

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

O estado atual da conexão do aplicativo do gerenciador de dispositivos.

- (BOOL) isConnected

readnonatomicassign

Verdadeiro se o gerenciador de dispositivos tiver estabelecido uma conexão com o dispositivo.

Deprecated:

Use connectionState.

- (BOOL) isConnectedToApp

readnonatomicassign

Verdadeiro se o gerenciador de dispositivos tiver estabelecido uma conexão com um aplicativo no dispositivo.

Deprecated:

Use applicationConnectionState.

- (BOOL) isReconnecting

readnonatomicassign

Verdadeiro se o gerenciador de dispositivos for desconectado devido a um evento potencialmente transitório (por exemplo, o app está em segundo plano ou houve um erro de rede que pode ser resolvido com uma reconexão).

Os callbacks de desconexão/conexão não serão chamados enquanto o gerenciador de dispositivos tentar se reconectar após um evento potencialmente transitório, mas as propriedades sempre vão refletir o estado atual real e podem ser observadas.

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

A reconexão será tentada por esse período caso o soquete se desconecte com um erro potencialmente transitório.

O tempo limite padrão é de 15 segundos.

- (GCKDevice*) device

readnonatomicassign

O dispositivo controlado por este GCKDeviceManager.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

O delegado para receber notificações do GCKDeviceManager.

- (float) deviceVolume

readnonatomicassign

O volume atual do dispositivo no intervalo [0.0, 1.0], se conhecido. Caso contrário, 0.

- (BOOL) deviceMuted

readnonatomicassign

O estado atual de desativação do dispositivo, se conhecido. Caso contrário, NO.

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

O status atual de "entrada ativa" do dispositivo.

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

O status "em espera" atual do dispositivo.

- (NSString*) applicationSessionID

readnonatomiccopy

O ID da sessão do aplicativo para o aplicativo receptor conectado no momento, se houver. Caso contrário, nil.

Um novo ID de sessão exclusivo é gerado sempre que um aplicativo receptor é iniciado (inclusive quando o mesmo aplicativo é reiniciado) e permanece em vigor enquanto o aplicativo receptor continua em execução.

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

Os metadados do aplicativo receptor que está sendo executado no receptor, se houver. Caso contrário, nil.

- (NSString*) applicationStatusText

readnonatomiccopy

O texto de status informado mais recentemente do aplicativo receptor em execução, se houver. Caso contrário, nil.