Visão geral

Um controlador para dispositivos de transmissão

Esta classe pode enviar e receber mensagens, iniciar e fechar aplicativos em execução em um dispositivo de transmissão.

A instância GCKDeviceManager precisa permanecer no escopo enquanto uma conexão com o dispositivo de transmissão for estabelecida ou estiver em processo de criação ou eliminação. É 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 os receptores do Google Cast.

Herda o NSObject.

Resumo do método de instância
(instancetype)	- initWithDevice:clientPackageName:
	Cria um novo GCKDeviceManager com o dispositivo especificado. Mais...

(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	Inicializador designado. Mais...

(void)	- connect
	Conecta-se ao dispositivo. Mais...

(void)	- disconnect
	Desconecta-se do dispositivo. Mais...

(void)	- disconnectWithLeave:
	Desconecta-se 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 e, opcionalmente, reinicia-o se já estiver em execução. Mais...

(NSInteger)	- joinApplication:
	Mescla um aplicativo. Mais...

(NSInteger)	- joinApplication:sessionID:
	Mescla um aplicativo com um ID de sessão específico. Mais...

(BOOL)	- leaveApplication
	Deixa o aplicativo atual. Mais...

(NSInteger)	- stopApplication
	Interrompe qualquer aplicativo em execução. Mais...

(NSInteger)	- stopApplicationWithSessionID:
	Interrompe o aplicativo com o ID de sessão fornecido. Mais...

(NSInteger)	- setVolume:
	Define o volume do sistema. Mais...

(NSInteger)	- setMuted:
	Ativa ou desativa o som. Mais...

(NSInteger)	- requestDeviceStatus
	Solicita o status atual do dispositivo. Mais...

Resumo da propriedade
BOOL	ignoreAppStateNotifications
	Indica se esse objeto vai detectar notificações de estado do app. Mais...

GCKConnectionState	connectionState
	O estado de conexão atual do gerenciador de dispositivos. Mais...

GCKConnectionState	applicationConnectionState
	O estado atual da conexão do app 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 do dispositivo for desconectado devido a um evento potencialmente temporário (por exemplo, o app ficar em segundo plano ou se houver um erro de rede que possa ser resolvido ao reconectar). Mais...

NSTimeInterval	reconnectTimeout
	Uma nova tentativa será feita para esse caso, caso o soquete se desconecte com um erro potencialmente temporário. Mais...

GCKDevice *	device
	O dispositivo que está sendo controlado por GCKDeviceManager. Mais...

id< GCKDeviceManagerDelegate >	delegate
	O delegado para receber notificações de GCKDeviceManager. Mais...

float	deviceVolume
	O volume atual do dispositivo no intervalo [0,0, 1,0], se conhecido. Caso contrário, será 0. Mais...

BOOL	deviceMuted
	O estado de silenciamento atual do dispositivo, se conhecido; caso contrário, `NO`. Mais...

GCKActiveInputStatus	activeInputStatus
	O status atual de "entrada ativa" do dispositivo. Mais...

GCKStandbyStatus	standbyStatus
	O status atual do "dispositivo em espera". Mais...

NSString *	applicationSessionID
	O ID da sessão do app receptor conectado no momento, se houver. Caso contrário, `nil`. Mais...

GCKApplicationMetadata *	applicationMetadata
	Os metadados do aplicativo receptor em execução no receptor, se houver. Caso contrário, `nil`. Mais...

NSString *	applicationStatusText
	O texto do status relatado mais recentemente do app receptor em execução, se houver. Caso contrário, `nil`. Mais...

Detalhes dos métodos

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

Cria um novo GCKDeviceManager com o dispositivo especificado.

O objeto detecta notificações de estado do app e se desconecta automaticamente do dispositivo quando ele entra em segundo plano e tenta se reconectar ao dispositivo quando o app volta 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 e tentar se reconectar ao dispositivo quando o app voltar para o primeiro plano.

Se ignoreAppStateNotifications for YES, o objeto não detectará 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 em execução 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-se ao dispositivo.

- (void) disconnect

Desconecta-se do dispositivo.

Esta é uma desconexão explícita.

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

- (void) disconnectWithLeave: (BOOL) leaveApplication

Desconecta-se do dispositivo.

Um dos métodos de desconexão precisa ser chamado em algum momento depois que connect é 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 para esse namespace.

- (BOOL) removeChannel: (GCKCastChannel *) channel

Remove um canal adicionado anteriormente.

Parameters

channel The channel.

Retorna: YES se o canal tiver sido removido, NO se não tiver sido removido porque o canal em questão não foi anexado anteriormente.

- (NSInteger) launchApplication: (NSString *) applicationID

Inicia um aplicativo.

Parameters

applicationID The application ID.

Retorna: O ID da solicitação, ou kGCKInvalidRequestID, caso a solicitação não possa ser enviada.

- (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, caso a solicitação não possa ser enviada.

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

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

Deprecated:: Use launchApplication:withLaunchOptions:.

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, caso a solicitação não possa ser enviada.

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

Mescla 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, caso a solicitação não possa ser enviada.

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

Mescla um aplicativo com um ID de sessão específico.

A solicitação 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, caso a solicitação não possa ser enviada.

- (BOOL) leaveApplication

Deixa o aplicativo atual.

Retorna: NO se a mensagem não puder ser enviada.

- (NSInteger) stopApplication

Interrompe qualquer aplicativo em execução.

Retorna: O ID da solicitação, ou kGCKInvalidRequestID, caso a solicitação não possa ser enviada.

- (NSInteger) stopApplicationWithSessionID: (NSString *__nullable) sessionID

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

A solicitação 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, caso a solicitação não possa ser enviada.

- (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, caso a solicitação não possa ser enviada.

- (NSInteger) setMuted: (BOOL) muted

Ativa ou desativa a desativação de som.

Parameters

muted Whether audio should be muted or unmuted.

Retorna: O ID da solicitação, ou kGCKInvalidRequestID, caso a solicitação não possa ser enviada.

- (NSInteger) requestDeviceStatus

Solicita o status atual do dispositivo.

Isso fará com que todos os callbacks de atualização do status delegado sejam invocados assim que as informações de status atualizadas forem recebidas.

Retorna: O ID da solicitação, ou kGCKInvalidRequestID, caso a solicitação não possa ser enviada.

Detalhes da propriedade

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

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

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

- (GCKConnectionState) connectionState

readnonatomicassign

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

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

O estado atual da conexão do app 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 do dispositivo for desconectado devido a um evento potencialmente temporário (por exemplo, o app ficar em segundo plano ou se houver um erro de rede que possa ser resolvido ao reconectar).

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

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

Uma nova tentativa será feita para esse caso, caso o soquete se desconecte com um erro potencialmente temporário.

O tempo limite padrão é de 15 segundos.

- (GCKDevice*) device

readnonatomicassign

O dispositivo que está sendo controlado por GCKDeviceManager.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

O delegado para receber notificações de GCKDeviceManager.

- (float) deviceVolume

readnonatomicassign

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

- (BOOL) deviceMuted

readnonatomicassign

O estado de silenciamento atual do dispositivo, se conhecido; caso contrário, NO.

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

O status atual de "entrada ativa" do dispositivo.

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

O status atual do "dispositivo em espera".

- (NSString*) applicationSessionID

readnonatomiccopy

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

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

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

Os metadados do aplicativo receptor em execução no receptor, se houver. Caso contrário, nil.

- (NSString*) applicationStatusText

readnonatomiccopy

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

Classe GCKDeviceManager

Visão geral

Resumo do método de instância

Resumo da propriedade

Detalhes dos métodos

Detalhes da propriedade