Présentation

Une sous-classe GCKCastChannel pour les opérations de contrôle de jeu.

Consultez GCKGameManagerChannelDelegate pour connaître le protocole de délégation.

Deprecated:: L'API Game Manager n'est plus compatible et sera supprimée dans une prochaine version.

Résumé de la méthode d'instance
(instancetype)	- initWithSessionID:
	Initialisation désignée. Plus...

(instancetype)	- init
	L'initialiseur par défaut n'est pas disponible. Plus...

(NSInteger)	- sendPlayerAvailableRequest:
	Envoie une requête au destinataire pour définir l'état GCKPlayerStateAvailable sur le dernier lecteur utilisé sur cet expéditeur. Plus...

(NSInteger)	- sendPlayerAvailableRequest:playerID:
	Elle envoie une requête au récepteur pour mettre le lecteur à l'état GCKPlayerStateAvailable. Plus...

(NSInteger)	- sendPlayerReadyRequest:
	Envoie une requête au destinataire pour définir l'état GCKPlayerStateReady sur le dernier lecteur utilisé sur cet expéditeur. Plus...

(NSInteger)	- sendPlayerReadyRequest:playerID:
	Elle envoie une requête au récepteur pour mettre le lecteur à l'état GCKPlayerStateReady. Plus...

(NSInteger)	- sendPlayerPlayingRequest:
	Envoie une requête au destinataire pour définir l'état GCKPlayerStatePlaying sur le dernier lecteur utilisé sur cet expéditeur. Plus...

(NSInteger)	- sendPlayerPlayingRequest:playerID:
	Elle envoie une requête au récepteur pour mettre le lecteur à l'état GCKPlayerStatePlaying. Plus...

(NSInteger)	- sendPlayerIdleRequest:
	Envoie une requête au destinataire pour définir l'état GCKPlayerStateIdle sur le dernier lecteur utilisé sur cet expéditeur. Plus...

(NSInteger)	- sendPlayerIdleRequest:playerID:
	Elle envoie une requête au récepteur pour mettre le lecteur à l'état GCKPlayerStateIdle. Plus...

(NSInteger)	- sendPlayerQuitRequest:
	Envoie une requête au destinataire pour définir l'état GCKPlayerStateQuit sur le dernier lecteur utilisé sur cet expéditeur. Plus...

(NSInteger)	- sendPlayerQuitRequest:playerID:
	Elle envoie une requête au récepteur pour mettre le lecteur à l'état GCKPlayerStateQuit. Plus...

(NSInteger)	- sendGameRequest:
	Envoie un message spécifique au jeu au destinataire. Plus...

(NSInteger)	- sendGameRequest:playerID:
	Envoie un message spécifique au jeu au destinataire. Plus...

(void)	- sendGameMessage:
	Envoie un message spécifique au jeu au destinataire. Plus...

(void)	- sendGameMessage:playerID:
	Envoie un message spécifique au jeu au destinataire. Plus...

(instancetype)	- initWithNamespace:
	Initialisation désignée. Plus...

(void)	- didReceiveTextMessage:
	Appelée lorsqu'un SMS a été reçu sur cette chaîne. Plus...

(BOOL)	- sendTextMessage:
	Envoie un SMS sur cette chaîne. Plus...

(BOOL)	- sendTextMessage:error:
	Envoie un SMS sur cette chaîne. Plus...

(NSInteger)	- generateRequestID
	Génère un ID de requête pour un nouveau message. Plus...

(NSNumber *__nullable)	- generateRequestNumber
	Méthode pratique qui encapsule le résultat de generateRequestID dans un NSNumber. Plus...

(void)	- didConnect
	Appelée lorsque cette chaîne est connectée, ce qui indique que l'appareil Cast peut désormais échanger des messages via cette chaîne. Plus...

(void)	- didDisconnect
	Appelée lorsque cette chaîne a été déconnectée, indiquant que les messages ne peuvent plus être échangés avec l'appareil Cast sur cette chaîne. Plus...

Récapitulatif de la propriété
id< GCKGameManagerChannelDelegate >	delegate
	Délégué de réception des notifications de GCKGameManagerChannel. Plus...

GCKGameManagerState *	currentState
	État actuel du gestionnaire de jeux. Plus...

NSString *	lastUsedPlayerID
	Dernier ID de joueur contrôlable utilisé dans cette session. Plus...

BOOL	isInitialConnectionEstablished
	Indique si cette chaîne est connectée au gestionnaire de jeux du destinataire et si nous pouvons interagir avec elle. Plus...

NSString *	protocolNamespace
	Espace de noms de la chaîne. Plus...

BOOL	isConnected
	Indicateur indiquant si ce canal est actuellement associé. Plus...

GCKDeviceManager *	deviceManager
	Gestionnaire d'appareils avec lequel cette chaîne est enregistrée, le cas échéant. Plus...

Détails sur la méthode

- (instancetype) initWithSessionID: (NSString *) castSessionID

Initialisation désignée.

Connexion automatique à Game Manager du destinataire

Parameters

castSessionID The Session ID corresponding to the currently connected Game Manager.

- (instancetype) init

L'initialiseur par défaut n'est pas disponible.

Met en œuvre GCKCastChannel.

- (NSInteger) sendPlayerAvailableRequest: (id __nullable) extraData

Envoie une requête au destinataire pour définir l'état GCKPlayerStateAvailable sur le dernier lecteur utilisé sur cet expéditeur.

S'il ne s'agit pas d'une transition valide pour ce joueur, une erreur sera déclenchée dans GCKGameManagerChannelDelegate. S'il n'y a pas de dernier lecteur utilisé, un nouveau joueur est enregistré et son ID est défini comme dernier lecteur utilisé lorsque le destinataire répond à cette requête. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté à Game Manager du destinataire.

Voir aussi: lastUsedPlayerID

Parameters

extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.

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

- (NSInteger) sendPlayerAvailableRequest:	(id __nullable)	extraData
playerID:	(NSString *)	playerID

Elle envoie une requête au récepteur pour mettre le lecteur à l'état GCKPlayerStateAvailable.

S'il ne s'agit pas d'une transition valide pour ce joueur, une erreur sera déclenchée dans GCKGameManagerChannelDelegate. Si l'ID du joueur est nil, un nouveau joueur est enregistré, et son ID est défini comme dernier ID utilisé lorsque le destinataire répond à cette requête. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté à Game Manager du destinataire.

Parameters

extraData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.
playerID	The player ID of the player whose state is to be changed.

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

- (NSInteger) sendPlayerReadyRequest: (id __nullable) extraData

Envoie une requête au destinataire pour définir l'état GCKPlayerStateReady sur le dernier lecteur utilisé sur cet expéditeur.

S'il ne s'agit pas d'une transition valide pour ce joueur ou si aucun ID de joueur n'a été utilisé pour la dernière fois, une erreur est déclenchée dans GCKGameManagerChannelDelegate. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté à Game Manager du destinataire.

Voir aussi: lastUsedPlayerID

Parameters

extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.

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

- (NSInteger) sendPlayerReadyRequest:	(id __nullable)	extraData
playerID:	(NSString *)	playerID

Elle envoie une requête au récepteur pour mettre le lecteur à l'état GCKPlayerStateReady.

S'il ne s'agit pas d'une transition valide pour ce joueur ou si aucun ID de joueur n'a été utilisé pour la dernière fois, une erreur est déclenchée dans GCKGameManagerChannelDelegate. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté à Game Manager du destinataire.

Parameters

extraData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.
playerID	The player ID of the player to change the state.

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

- (NSInteger) sendPlayerPlayingRequest: (id __nullable) extraData

Envoie une requête au destinataire pour définir l'état GCKPlayerStatePlaying sur le dernier lecteur utilisé sur cet expéditeur.

S'il ne s'agit pas d'une transition valide pour ce joueur ou si aucun ID de joueur n'a été utilisé pour la dernière fois, une erreur est déclenchée dans GCKGameManagerChannelDelegate. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté à Game Manager du destinataire.

Voir aussi: lastUsedPlayerID

Parameters

extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.

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

- (NSInteger) sendPlayerPlayingRequest:	(id __nullable)	extraData
playerID:	(NSString *)	playerID

Elle envoie une requête au récepteur pour mettre le lecteur à l'état GCKPlayerStatePlaying.

S'il ne s'agit pas d'une transition valide pour ce joueur ou si aucun ID de joueur n'a été utilisé pour la dernière fois, une erreur est déclenchée dans GCKGameManagerChannelDelegate. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté à Game Manager du destinataire.

Parameters

extraData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.
playerID	The player ID of the player to change the state.

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

- (NSInteger) sendPlayerIdleRequest: (id __nullable) extraData

Envoie une requête au destinataire pour définir l'état GCKPlayerStateIdle sur le dernier lecteur utilisé sur cet expéditeur.

S'il ne s'agit pas d'une transition valide pour ce joueur ou si aucun ID de joueur n'a été utilisé pour la dernière fois, une erreur est déclenchée dans GCKGameManagerChannelDelegate. Cette méthode ne doit être appelée qu'une fois le rappel de gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Message GCKGameManagerChannel::gameManagerChannel:requestDidFailWithID:error: délégué de rappel si GCKGameManagerChannel n'est pas encore connecté au gestionnaire de jeux du destinataire.

Voir aussi: lastUsedPlayerID

Parameters

extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.

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

- (NSInteger) sendPlayerIdleRequest:	(id __nullable)	extraData
playerID:	(NSString *)	playerID

Elle envoie une requête au récepteur pour mettre le lecteur à l'état GCKPlayerStateIdle.

S'il ne s'agit pas d'une transition valide pour ce joueur ou si aucun ID de joueur n'a été utilisé pour la dernière fois, une erreur est déclenchée dans GCKGameManagerChannelDelegate. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté à Game Manager du destinataire.

Parameters

extraData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.
playerID	The player ID of the player to change the state.

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

- (NSInteger) sendPlayerQuitRequest: (id __nullable) extraData

Envoie une requête au destinataire pour définir l'état GCKPlayerStateQuit sur le dernier lecteur utilisé sur cet expéditeur.

S'il ne s'agit pas d'une transition valide pour ce joueur ou si aucun ID de joueur n'a été utilisé pour la dernière fois, une erreur est déclenchée dans GCKGameManagerChannelDelegate. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté à Game Manager du destinataire.

Voir aussi: lastUsedPlayerID

Parameters

extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.

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

- (NSInteger) sendPlayerQuitRequest:	(id __nullable)	extraData
playerID:	(NSString *)	playerID

Elle envoie une requête au récepteur pour mettre le lecteur à l'état GCKPlayerStateQuit.

S'il ne s'agit pas d'une transition valide pour ce joueur ou si aucun ID de joueur n'a été utilisé pour la dernière fois, une erreur est déclenchée dans GCKGameManagerChannelDelegate. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté au gestionnaire de jeux du destinataire.

Parameters

extraData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.
playerID	The player ID of the player to change the state.

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

- (NSInteger) sendGameRequest: (id __nullable) extraData

Envoie un message spécifique au jeu au destinataire.

Le contenu du message dépend entièrement de l'application. Le message proviendra de lastUsedPlayerID. Le destinataire enverra une réponse à cet expéditeur via GCKGameManagerChannelDelegate. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté au GameManager destinataire.

Parameters

extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.

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

- (NSInteger) sendGameRequest:	(id __nullable)	extraData
playerID:	(NSString *)	playerID

Envoie un message spécifique au jeu au destinataire.

Le contenu du message dépend entièrement de l'application. Le message proviendra de playerID. Si la valeur de playerID est nil, lastUsedPlayerID est utilisé. Le destinataire enverra une réponse à cet expéditeur via GCKGameManagerChannelDelegate. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté à Game Manager du destinataire.

Parameters

extraData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.
playerID	The id of the controllable player sending this message.

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

- (void) sendGameMessage: (id __nullable) extraData

Envoie un message spécifique au jeu au destinataire.

Le contenu du message dépend entièrement de l'application. Le message proviendra de lastUsedPlayerID. Il s'agit d'une méthode de type "fire-for-get" qui n'offre aucune garantie que le message a été envoyé et que le destinataire ne lui renvoie pas de réponse. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté à Game Manager du destinataire.

Parameters

extraData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.

- (void) sendGameMessage:	(id __nullable)	extraData
playerID:	(NSString *)	playerID

Envoie un message spécifique au jeu au destinataire.

Le contenu des messages dépend entièrement de l'application. Le message provient de l'ID de lecteur local spécifié. Il s'agit d'une méthode "fire and forget", qui ne garantit pas l'envoi du message et où le destinataire ne renvoie pas de réponse à cet expéditeur. Cette méthode ne doit être appelée qu'une fois le rappel de délégué gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) envoyé. Envoie un rappel au délégué gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) si GCKGameManagerChannel n'est pas encore connecté à Game Manager du destinataire.

Parameters

extraData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.
playerID	The ID of the controllable player sending this message.

- (instancetype) initWithNamespace: (NSString *) protocolNamespace

Initialisation désignée.

Construit un nouveau GCKCastChannel avec l'espace de noms donné.

Parameters

protocolNamespace The namespace.

Implémenté dans GCKGenericChannel.

- (void) didReceiveTextMessage: (NSString *) message

Appelée lorsqu'un SMS a été reçu sur cette chaîne.

L'implémentation par défaut est une no-op.

Parameters

message The message.

- (BOOL) sendTextMessage: (NSString *) message

Envoie un SMS sur cette chaîne.

Parameters

message The message.

Retours: YES en cas de réussite, ou NO si le message n'a pas pu être envoyé (car le canal n'est pas connecté, ou le tampon d'envoi est trop plein pour le moment).

Deprecated:: Utilisez sendTextMessage:error: pour obtenir des informations détaillées sur les erreurs.

- (BOOL) sendTextMessage:	(NSString *)	message
error:	(GCKError __nullable __nullable)	error

Envoie un SMS sur cette chaîne.

Parameters

message	The message.
error	A pointer at which to store the error result. May be `nil`.

Retours: YES en cas de réussite ou NO si le message n'a pas pu être envoyé.

- (NSInteger) generateRequestID

Génère un ID de requête pour un nouveau message.

Retours: ID généré, ou kGCKInvalidRequestID si le canal n'est pas actuellement associé.

- (NSNumber * __nullable) generateRequestNumber

Méthode pratique qui encapsule le résultat de generateRequestID dans un NSNumber.

Retours: ID généré, ou nil si le canal n'est pas actuellement associé.

- (void) didConnect

Appelée lorsque cette chaîne est connectée, ce qui indique que l'appareil Cast peut désormais échanger des messages via cette chaîne.

L'implémentation par défaut est une no-op.

- (void) didDisconnect

Appelée lorsque cette chaîne a été déconnectée, indiquant que les messages ne peuvent plus être échangés avec l'appareil Cast sur cette chaîne.

L'implémentation par défaut est une no-op.

Détails de la propriété

- (id<GCKGameManagerChannelDelegate>) delegate

readwritenonatomicweak

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

- (GCKGameManagerState*) currentState

readnonatomicstrong

État actuel du gestionnaire de jeux.

- (NSString*) lastUsedPlayerID

readnonatomiccopy

Dernier ID de joueur contrôlable utilisé dans cette session.

Il peut s'agir de nil si aucun lecteur contrôlable n'est configuré avec le récepteur.

Voir aussi: - sendPlayerAvailableRequest:

- (BOOL) isInitialConnectionEstablished

readnonatomicassign

Indique si cette chaîne est connectée au gestionnaire de jeux du destinataire et si nous pouvons interagir avec elle.

Cette méthode renvoie NO à partir du point de création de cette chaîne.

Retours: YES si cette chaîne est connectée au gestionnaire de jeux du destinataire et prête à interagir ; NO dans le cas contraire.

- (NSString*) protocolNamespace

readnonatomiccopyinherited

Espace de noms de la chaîne.

- (BOOL) isConnected

readnonatomicassigninherited

Indicateur indiquant si ce canal est actuellement associé.

- (GCKDeviceManager*) deviceManager

readnonatomicweakinherited

Gestionnaire d'appareils avec lequel cette chaîne est enregistrée, le cas échéant.

Deprecated:: Si cette chaîne n'a pas été enregistrée avec la classe obsolète GCKDeviceManager, il s'agit de nil.

Classe GCKGameManagerChannel

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é