Classe GCKGameManagerChannel

Metodi di istanza | Proprietà

Riferimento alla classe GCKGameManagerChannel

Panoramica

Una sottoclasse GCKCastChannel per le operazioni di controllo del gioco.

Vedi GCKGameManagerChannelDelegate per il protocollo delegata.

Deprecated:

L'API Game Manager non è più supportata e verrà rimossa in una release futura.

Eredita GCKCastChannel.

Riepilogo del metodo dell'istanza
(instancetype)	- initWithSessionID:
	Inizializzatore designato. Altro...
(instancetype)	- init
	L'inizializzazionere predefinito non è disponibile. Altro...
(NSInteger)	- sendPlayerAvailableRequest:
	Invia una richiesta al destinatario per mettere lo stato dell'ultimo player utilizzato su questo mittente nello stato GCKPlayerStateAvailable. Altro...
(NSInteger)	- sendPlayerAvailableRequest:playerID:
	Invia una richiesta al ricevente per mettere il player nello stato GCKPlayerStateAvailable. Altro...
(NSInteger)	- sendPlayerReadyRequest:
	Invia una richiesta al destinatario per mettere lo stato dell'ultimo player utilizzato su questo mittente nello stato GCKPlayerStateReady. Altro...
(NSInteger)	- sendPlayerReadyRequest:playerID:
	Invia una richiesta al ricevente per mettere il player nello stato GCKPlayerStateReady. Altro...
(NSInteger)	- sendPlayerPlayingRequest:
	Invia una richiesta al destinatario per mettere lo stato dell'ultimo player utilizzato su questo mittente nello stato GCKPlayerStatePlaying. Altro...
(NSInteger)	- sendPlayerPlayingRequest:playerID:
	Invia una richiesta al ricevente per mettere il player nello stato GCKPlayerStatePlaying. Altro...
(NSInteger)	- sendPlayerIdleRequest:
	Invia una richiesta al destinatario per mettere lo stato dell'ultimo player utilizzato su questo mittente nello stato GCKPlayerStateIdle. Altro...
(NSInteger)	- sendPlayerIdleRequest:playerID:
	Invia una richiesta al ricevente per mettere il player nello stato GCKPlayerStateIdle. Altro...
(NSInteger)	- sendPlayerQuitRequest:
	Invia una richiesta al destinatario per mettere lo stato dell'ultimo player utilizzato su questo mittente nello stato GCKPlayerStateQuit. Altro...
(NSInteger)	- sendPlayerQuitRequest:playerID:
	Invia una richiesta al ricevente per mettere il player nello stato GCKPlayerStateQuit. Altro...
(NSInteger)	- sendGameRequest:
	Invia un messaggio specifico per il gioco al destinatario. Altro...
(NSInteger)	- sendGameRequest:playerID:
	Invia un messaggio specifico per il gioco al destinatario. Altro...
(void)	- sendGameMessage:
	Invia un messaggio specifico per il gioco al destinatario. Altro...
(void)	- sendGameMessage:playerID:
	Invia un messaggio specifico per il gioco al destinatario. Altro...
(instancetype)	- initWithNamespace:
	Inizializzatore designato. Altro...
(void)	- didReceiveTextMessage:
	Chiamata quando un SMS viene ricevuto su questo canale. Altro...
(BOOL)	- sendTextMessage:
	Invia un SMS su questo canale. Altro...
(BOOL)	- sendTextMessage:error:
	Invia un SMS su questo canale. Altro...
(NSInteger)	- generateRequestID
	Genera un ID richiesta per un nuovo messaggio. Altro...
(NSNumber *__nullable)	- generateRequestNumber
	Un metodo pratico che aggrega il risultato di generateRequestID in un NSNumber. Altro...
(void)	- didConnect
	Richiamato quando questo canale è stato collegato, a indicare che ora i messaggi possono essere scambiati con il dispositivo di trasmissione su questo canale. Altro...
(void)	- didDisconnect
	Chiamata quando questo canale è stato disconnesso, per indicare che i messaggi non possono più essere scambiati con il dispositivo di trasmissione su questo canale. Altro...

Riepilogo proprietà
id< GCKGameManagerChannelDelegate >	delegate
	Il delegato per la ricezione delle notifiche da GCKGameManagerChannel. Altro...
GCKGameManagerState *	currentState
	Lo stato attuale del gestore del gioco. Altro...
NSString *	lastUsedPlayerID
	L'ultimo ID player controllabile utilizzato in questa sessione. Altro...
BOOL	isInitialConnectionEstablished
	Se questo canale è collegato al Game Manager del destinatario e siamo pronti a interagire. Altro...
NSString *	protocolNamespace
	Lo spazio dei nomi del canale. Altro...
BOOL	isConnected
	Un flag che indica se questo canale è attualmente collegato. Altro...
GCKDeviceManager *	deviceManager
	L'amministratore del dispositivo con cui è registrato questo canale. Altro...

Dettaglio metodo

- (instancetype) initWithSessionID:

(NSString *)

castSessionID

Inizializzatore designato.

Si collega automaticamente al Game Manager del destinatario.

Parameters

castSessionID

The Session ID corresponding to the currently connected Game Manager.

- (instancetype) init

L'inizializzazionere predefinito non è disponibile.

Implementa GCKCastChannel.

- (NSInteger) sendPlayerAvailableRequest:

(id __nullable)

extraData

Invia una richiesta al destinatario per mettere lo stato dell'ultimo player utilizzato su questo mittente nello stato GCKPlayerStateAvailable.

Se la transazione per il player in questione non è valida, verrà attivato un errore in GCKGameManagerChannelDelegate. In assenza di un ultimo lettore utilizzato, viene registrato un nuovo giocatore e il suo ID viene impostato come ultimo giocatore utilizzato, quando il destinatario risponde a questa richiesta. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Vedi anche

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

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

Invia una richiesta al ricevente per mettere il player nello stato GCKPlayerStateAvailable.

Se la transazione per il player in questione non è valida, verrà attivato un errore in GCKGameManagerChannelDelegate. Se l'ID giocatore è nil, verrà registrato un nuovo giocatore e il suo ID giocatore verrà impostato come ultimo ID giocatore utilizzato quando il destinatario risponde a questa richiesta. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

- (NSInteger) sendPlayerReadyRequest:

(id __nullable)

extraData

Invia una richiesta al destinatario per mettere lo stato dell'ultimo player utilizzato su questo mittente nello stato GCKPlayerStateReady.

Se la transazione per questo player non è valida o se non è presente l'ultimo ID player utilizzato, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Vedi anche

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

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

Invia una richiesta al ricevente per mettere il player nello stato GCKPlayerStateReady.

Se la transazione per questo player non è valida o se non è presente l'ultimo ID player utilizzato, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

- (NSInteger) sendPlayerPlayingRequest:

(id __nullable)

extraData

Invia una richiesta al destinatario per mettere lo stato dell'ultimo player utilizzato su questo mittente nello stato GCKPlayerStatePlaying.

Se la transazione per questo player non è valida o se non è presente l'ultimo ID player utilizzato, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Vedi anche

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

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

Invia una richiesta al ricevente per mettere il player nello stato GCKPlayerStatePlaying.

Se la transazione per questo player non è valida o se non è presente l'ultimo ID player utilizzato, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

- (NSInteger) sendPlayerIdleRequest:

(id __nullable)

extraData

Invia una richiesta al destinatario per mettere lo stato dell'ultimo player utilizzato su questo mittente nello stato GCKPlayerStateIdle.

Se la transazione per questo player non è valida o se non è presente l'ultimo ID player utilizzato, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) Delegato. Invia un messaggio al GCKGameManagerChannel::gameManagerChannel:requestDidFailWithID:error: delegare il callback se il GCKGameManagerChannel non è ancora connesso al Game Manager del destinatario.

Vedi anche

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

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

Invia una richiesta al ricevente per mettere il player nello stato GCKPlayerStateIdle.

Se la transazione per questo player non è valida o se non è presente l'ultimo ID player utilizzato, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

- (NSInteger) sendPlayerQuitRequest:

(id __nullable)

extraData

Invia una richiesta al destinatario per mettere lo stato dell'ultimo player utilizzato su questo mittente nello stato GCKPlayerStateQuit.

Se la transazione per questo player non è valida o se non è presente l'ultimo ID player utilizzato, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Vedi anche

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

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

Invia una richiesta al ricevente per mettere il player nello stato GCKPlayerStateQuit.

Se la transazione per questo player non è valida o se non è presente l'ultimo ID player utilizzato, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

- (NSInteger) sendGameRequest:

(id __nullable)

extraData

Invia un messaggio specifico per il gioco al destinatario.

I contenuti del messaggio sono a carico dell'applicazione. Il messaggio proviene da lastUsedPlayerID. Il destinatario invierà una risposta al mittente tramite il GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia un messaggio al callback delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso al destinatario GameManager.

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

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

Invia un messaggio specifico per il gioco al destinatario.

I contenuti del messaggio sono a carico dell'applicazione. Il messaggio proviene da playerID. Se playerID è nil, verrà utilizzato lastUsedPlayerID. Il destinatario invierà una risposta al mittente tramite il GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

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.

Valori restituiti

L'ID richiesta o kGCKInvalidRequestID se non è stato possibile inviare la richiesta.

- (void) sendGameMessage:

(id __nullable)

extraData

Invia un messaggio specifico per il gioco al destinatario.

I contenuti del messaggio sono a carico dell'applicazione. Il messaggio proviene da lastUsedPlayerID. Si tratta di un metodo di attivazione e disattivazione in quanto non vi è alcuna garanzia che il messaggio sia stato inviato e il destinatario non invierà una risposta al mittente. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

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

Invia un messaggio specifico per il gioco al destinatario.

L'intero contenuto del messaggio dipende dall'applicazione. Il messaggio avrà origine dall'ID player locale specificato. Si tratta di un metodo di attivazione automatica che non garantisce che il messaggio venga inviato e che il destinatario non invii una risposta al mittente. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato di gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi che richiamano delegati di gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

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

Inizializzatore designato.

Crea un nuovo GCKCastChannel con lo spazio dei nomi specificato.

Parameters

protocolNamespace

The namespace.

Implementata in GCKGenericChannel.

- (void) didReceiveTextMessage:

(NSString *)

message

Chiamata quando un SMS viene ricevuto su questo canale.

L'implementazione predefinita è automatica.

Parameters

message

The message.

- (BOOL) sendTextMessage:

(NSString *)

message

Invia un SMS su questo canale.

Parameters

message

The message.

Valori restituiti

YES riuscita o NO se il messaggio non è stato inviato (perché il canale non è collegato o perché il buffer di invio è troppo pieno al momento).

Deprecated:

Utilizza sendTextMessage:error:, che fornisce informazioni dettagliate sugli errori.

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

Invia un SMS su questo canale.

Parameters

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

Valori restituiti

YES riuscita o NO se il messaggio non è stato inviato.

- (NSInteger) generateRequestID

Genera un ID richiesta per un nuovo messaggio.

Valori restituiti

L'ID generato o kGCKInvalidRequestID se il canale non è attualmente collegato.

- (NSNumber * __nullable) generateRequestNumber

Un metodo pratico che aggrega il risultato di generateRequestID in un NSNumber.

Valori restituiti

L'ID generato o nil se il canale non è attualmente collegato.

- (void) didConnect

Richiamato quando questo canale è stato collegato, a indicare che ora i messaggi possono essere scambiati con il dispositivo di trasmissione su questo canale.

L'implementazione predefinita è automatica.

- (void) didDisconnect

Chiamata quando questo canale è stato disconnesso, per indicare che i messaggi non possono più essere scambiati con il dispositivo di trasmissione su questo canale.

L'implementazione predefinita è automatica.

Dettaglio proprietà

- (id<GCKGameManagerChannelDelegate>) delegate

readwritenonatomicweak

Il delegato per la ricezione delle notifiche da GCKGameManagerChannel.

- (GCKGameManagerState*) currentState

readnonatomicstrong

Lo stato attuale del gestore del gioco.

- (NSString*) lastUsedPlayerID

readnonatomiccopy

L'ultimo ID player controllabile utilizzato in questa sessione.

Questo valore può essere nil se non è stato configurato alcun player controllabile con il ricevitore.

Vedi anche

- sendPlayerAvailableRequest:

- (BOOL) isInitialConnectionEstablished

readnonatomicassign

Se questo canale è collegato al Game Manager del destinatario e siamo pronti a interagire.

Questo metodo restituirà NO dal momento della creazione di questo canale.

Valori restituiti

YES se questo canale è collegato a Game Manager del destinatario e pronto per interagire; NO in caso contrario.

- (NSString*) protocolNamespace

readnonatomiccopyinherited

Lo spazio dei nomi del canale.

- (BOOL) isConnected

readnonatomicassigninherited

Un flag che indica se questo canale è attualmente collegato.

- (GCKDeviceManager*) deviceManager

readnonatomicweakinherited

L'amministratore del dispositivo con cui è registrato questo canale.

Deprecated:

Se questo canale non è stato registrato al ritiro della classe GCKDeviceManager, il valore sarà nil.