Présentation

Manette pour les appareils Cast.

Ce cours permet d'envoyer des messages, d'en recevoir, d'en lancer et de fermer des applications s'exécutant sur un appareil Cast.

L'instance GCKDeviceManager doit rester dans le champ d'application tant qu'une connexion à l'appareil Cast est établie, ou qu'elle est en cours de création ou de suppression. Vous pouvez libérer l'objet avant de démarrer une connexion avec connect (GCKDeviceManager) ou après un appel du délégué deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) ou deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p).

Deprecated:: Utilisez GCKSessionManager et GCKCastSession pour interagir avec les récepteurs Cast.

Hérite de NSObject.

Résumé de la méthode d'instance
(instancetype)	- initWithDevice:clientPackageName:
	Construit une nouvelle GCKDeviceManager avec l'appareil donné. Plus...

(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	Initialisation désignée. Plus...

(void)	- connect
	Se connecte à l'appareil. Plus...

(void)	- disconnect
	Déconnexion de l'appareil. Plus...

(void)	- disconnectWithLeave:
	Déconnexion de l'appareil. Plus...

(BOOL)	- addChannel:
	Ajoute un canal pouvant envoyer et recevoir des messages pour cet appareil sur un espace de noms particulier. Plus...

(BOOL)	- removeChannel:
	Supprime un critère précédemment ajouté. Plus...

(NSInteger)	- launchApplication:
	Lancer une application Plus...

(NSInteger)	- launchApplication:withLaunchOptions:
	Lancer une application à l'aide des options de lancement données Plus...

(NSInteger)	- launchApplication:relaunchIfRunning:
	Lancer une application, éventuellement la relancer si elle est déjà en cours d'exécution Plus...

(NSInteger)	- joinApplication:
	Permet de joindre une application. Plus...

(NSInteger)	- joinApplication:sessionID:
	Jointure d'une application avec un ID de session d'application particulier Plus...

(BOOL)	- leaveApplication
	Quitte l'application actuelle. Plus...

(NSInteger)	- stopApplication
	Arrête toute application en cours d'exécution. Plus...

(NSInteger)	- stopApplicationWithSessionID:
	Arrêter l'application avec l'ID de session d'application donné Plus...

(NSInteger)	- setVolume:
	Définit le volume du système. Plus...

(NSInteger)	- setMuted:
	Active ou désactive le son. Plus...

(NSInteger)	- requestDeviceStatus
	Demande l'état actuel de l'appareil. Plus...

Récapitulatif de la propriété
BOOL	ignoreAppStateNotifications
	Indique si cet objet écoute les notifications d'état de l'application. Plus...

GCKConnectionState	connectionState
	État de connexion actuel du gestionnaire d'appareils. Plus...

GCKConnectionState	applicationConnectionState
	État de connexion actuel de l'application du gestionnaire d'appareils. Plus...

BOOL	isConnected
	Vraie si le gestionnaire a établi une connexion avec l'appareil. Plus...

BOOL	isConnectedToApp
	Vraie si le gestionnaire a établi une connexion à une application sur l'appareil. Plus...

BOOL	isReconnecting
	Vraie si le gestionnaire d'appareils est déconnecté en raison d'un événement potentiellement temporaire (par exemple, si l'application est exécutée en arrière-plan ou si une erreur réseau s'est produite en se reconnectant). Plus...

NSTimeInterval	reconnectTimeout
	La tentative de reconnexion sera effectuée pendant cette durée au cas où l'interface de connexion se déconnecterait avec une erreur potentiellement temporaire. Plus...

GCKDevice *	device
	Appareil contrôlé par votre GCKDeviceManager. Plus...

id< GCKDeviceManagerDelegate >	delegate
	Délégué de réception des notifications de GCKDeviceManager. Plus...

float	deviceVolume
	Volume actuel de l'appareil (compris dans la plage [0.0, 1.0], s'il est connu, sinon 0) Plus...

BOOL	deviceMuted
	État actuel du son de l'appareil, s'il est connu. Sinon, `NO`. Plus...

GCKActiveInputStatus	activeInputStatus
	État "entrée active" de l'appareil. Plus...

GCKStandbyStatus	standbyStatus
	État de mise en veille de l'appareil. Plus...

NSString *	applicationSessionID
	ID de session de l'application réceptrice actuellement associée, le cas échéant. Sinon, `nil`. Plus...

GCKApplicationMetadata *	applicationMetadata
	Métadonnées de l'application réceptrice en cours d'exécution sur le récepteur, le cas échéant. Sinon, `nil`. Plus...

NSString *	applicationStatusText
	Le dernier texte d'état signalé depuis l'application réceptrice en cours d'exécution, le cas échéant. Sinon, `nil`. Plus...

Détails sur la méthode

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

Construit une nouvelle GCKDeviceManager avec l'appareil donné.

L'objet écoute les notifications d'état de l'application. Il se déconnecte automatiquement de l'appareil lorsque l'application passe en arrière-plan et tente de se reconnecter à l'appareil lorsque l'application revient au premier plan.

Parameters

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

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

Initialisation désignée.

Construit une nouvelle GCKDeviceManager pour contrôler l'appareil donné.

Si ignoreAppStateNotifications est défini sur NO, l'objet écoute les modifications de l'état de l'application. Il est automatiquement déconnecté de l'appareil lorsque l'application passe en arrière-plan et tente de se reconnecter à l'appareil lorsque l'application revient au premier plan.

Si ignoreAppStateNotifications est défini sur YES, l'objet n'écoutera pas ces notifications et il sera de la responsabilité de l'application de gérer le cycle de vie de la connexion. Notez qu'en général, une application iOS en arrière-plan ne peut pas fonctionner indéfiniment et que ses connexions réseau actives finissent par être fermées par le système d'exploitation.

Parameters

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

- (void) connect

Se connecte à l'appareil.

- (void) disconnect

Déconnexion de l'appareil.

Il s'agit d'une déconnexion explicite.

L'une des méthodes de déconnexion doit être appelée après l'appel de connect et avant que l'objet ne soit libéré par son propriétaire.

- (void) disconnectWithLeave: (BOOL) leaveApplication

Déconnexion de l'appareil.

L'une des méthodes de déconnexion doit être appelée après l'appel de connect et avant que l'objet ne soit libéré par son propriétaire.

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

Ajoute un canal pouvant envoyer et recevoir des messages pour cet appareil sur un espace de noms particulier.

Parameters

channel The channel.

Retours: YES si la chaîne a été ajoutée, NO si elle ne l'a pas été parce qu'une chaîne est déjà associée à cet espace de noms.

- (BOOL) removeChannel: (GCKCastChannel *) channel

Supprime un critère précédemment ajouté.

Parameters

channel The channel.

Retours: YES si la chaîne a été supprimée, NO si elle ne l'a pas été parce que la chaîne en question n'était pas associée auparavant.

- (NSInteger) launchApplication: (NSString *) applicationID

Lancer une application

Parameters

applicationID The application ID.

Retours: ID de la requête, ou kGCKInvalidRequestID si la requête n'a pas pu être envoyée.

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

Lancer une application à l'aide des options de lancement données

Parameters

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

Retours: ID de la requête, ou kGCKInvalidRequestID si la requête n'a pas pu être envoyée.

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

Lancer une application, éventuellement la relancer si elle est déjà en cours d'exécution

Deprecated:: Utilisez plutôt launchApplication:withLaunchOptions:.

Parameters

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

Retours: ID de la requête, ou kGCKInvalidRequestID si la requête n'a pas pu être envoyée.

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

Permet de joindre une application.

Parameters

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

Retours: ID de la requête, ou kGCKInvalidRequestID si la requête n'a pas pu être envoyée.

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

Jointure d'une application avec un ID de session d'application particulier

La requête échoue si l'ID de session donné n'est plus actif sur le récepteur.

Parameters

applicationID	The application ID.
sessionID	The application session ID.

Retours: ID de la requête, ou kGCKInvalidRequestID si la requête n'a pas pu être envoyée.

- (BOOL) leaveApplication

Quitte l'application actuelle.

Retours: NO si le message n'a pas pu être envoyé.

- (NSInteger) stopApplication

Arrête toute application en cours d'exécution.

Retours: ID de la requête, ou kGCKInvalidRequestID si la requête n'a pas pu être envoyée.

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

Arrêter l'application avec l'ID de session d'application donné

La requête échoue si l'ID de session donné n'est plus actif sur le récepteur.

Parameters

sessionID The application session ID, which may not be nil.

Retours: ID de la requête, ou kGCKInvalidRequestID si la requête n'a pas pu être envoyée.

- (NSInteger) setVolume: (float) volume

Définit le volume du système.

Parameters

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

Retours: ID de la requête, ou kGCKInvalidRequestID si la requête n'a pas pu être envoyée.

- (NSInteger) setMuted: (BOOL) muted

Active ou désactive le son.

Parameters

muted Whether audio should be muted or unmuted.

Retours: ID de la requête, ou kGCKInvalidRequestID si la requête n'a pas pu être envoyée.

- (NSInteger) requestDeviceStatus

Demande l'état actuel de l'appareil.

Ainsi, tous les rappels de mise à jour de l'état du délégué seront appelés une fois les informations d'état mises à jour reçues.

Retours: ID de la requête, ou kGCKInvalidRequestID si la requête n'a pas pu être envoyée.

Détails de la propriété

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

Indique si cet objet écoute les notifications d'état de l'application.

Cet indicateur peut être spécifié dans l'initialiseur. La valeur par défaut est NO.

- (GCKConnectionState) connectionState

readnonatomicassign

État de connexion actuel du gestionnaire d'appareils.

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

État de connexion actuel de l'application du gestionnaire d'appareils.

- (BOOL) isConnected

readnonatomicassign

Vraie si le gestionnaire a établi une connexion avec l'appareil.

Deprecated:: Utilisez connectionState.

- (BOOL) isConnectedToApp

readnonatomicassign

Vraie si le gestionnaire a établi une connexion à une application sur l'appareil.

Deprecated:: Utilisez applicationConnectionState.

- (BOOL) isReconnecting

readnonatomicassign

Vraie si le gestionnaire d'appareils est déconnecté en raison d'un événement potentiellement temporaire (par exemple, si l'application est exécutée en arrière-plan ou si une erreur réseau s'est produite en se reconnectant).

Notez que les rappels de déconnexion ou de connexion ne sont pas appelés tant que le gestionnaire d'appareils tente de se reconnecter après un événement potentiellement temporaire. Toutefois, les propriétés reflètent toujours l'état actuel réel et peuvent être observées.

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

La tentative de reconnexion sera effectuée pendant cette durée au cas où l'interface de connexion se déconnecterait avec une erreur potentiellement temporaire.

Le délai avant expiration par défaut est de 15 secondes.

- (GCKDevice*) device

readnonatomicassign

Appareil contrôlé par votre GCKDeviceManager.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

Délégué de réception des notifications de GCKDeviceManager.

- (float) deviceVolume

readnonatomicassign

Volume actuel de l'appareil (compris dans la plage [0.0, 1.0], s'il est connu, sinon 0)

- (BOOL) deviceMuted

readnonatomicassign

État actuel du son de l'appareil, s'il est connu. Sinon, NO.

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

État "entrée active" de l'appareil.

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

État de mise en veille de l'appareil.

- (NSString*) applicationSessionID

readnonatomiccopy

ID de session de l'application réceptrice actuellement associée, le cas échéant. Sinon, nil.

Un nouvel identifiant de session unique est généré chaque fois qu'une application réceptrice est lancée (y compris lorsque la même application est redémarrée). Il est conservé tant que l'application réceptrice continue de s'exécuter.

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

Métadonnées de l'application réceptrice en cours d'exécution sur le récepteur, le cas échéant. Sinon, nil.

- (NSString*) applicationStatusText

readnonatomiccopy

Le dernier texte d'état signalé depuis l'application réceptrice en cours d'exécution, le cas échéant. Sinon, nil.

Classe GCKDeviceManager

Présentation

Résumé de la méthode d'instance

Récapitulatif de la propriété

Détails sur la méthode

Détails de la propriété