Classe GCKGameManagerChannel

Riferimento alla classe GCKGameManagerChannel

Panoramica

Una sottoclasse GCKCastChannel per le operazioni di controllo del gioco.

Per il protocollo del delegato, consulta la pagina GCKGameManagerChannelDelegate.

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'inizializzatore predefinito non è disponibile. Altro…
 
(NSInteger) - sendPlayerAvailableRequest:
 Invia una richiesta al destinatario per impostare l'ultimo giocatore utilizzato su questo mittente nello stato GCKPlayerStateAvailable. Altro…
 
(NSInteger) - sendPlayerAvailableRequest:playerID:
 Invia una richiesta al destinatario per mettere il giocatore nello stato GCKPlayerStateAvailable. Altro…
 
(NSInteger) - sendPlayerReadyRequest:
 Invia una richiesta al destinatario per impostare l'ultimo giocatore utilizzato su questo mittente nello stato GCKPlayerStateReady. Altro…
 
(NSInteger) - sendPlayerReadyRequest:playerID:
 Invia una richiesta al destinatario per mettere il giocatore nello stato GCKPlayerStateReady. Altro…
 
(NSInteger) - sendPlayerPlayingRequest:
 Invia una richiesta al destinatario per impostare l'ultimo giocatore utilizzato su questo mittente nello stato GCKPlayerStatePlaying. Altro…
 
(NSInteger) - sendPlayerPlayingRequest:playerID:
 Invia una richiesta al destinatario per mettere il giocatore nello stato GCKPlayerStatePlaying. Altro…
 
(NSInteger) - sendPlayerIdleRequest:
 Invia una richiesta al destinatario per impostare l'ultimo giocatore utilizzato su questo mittente nello stato GCKPlayerStateIdle. Altro…
 
(NSInteger) - sendPlayerIdleRequest:playerID:
 Invia una richiesta al destinatario per mettere il giocatore nello stato GCKPlayerStateIdle. Altro…
 
(NSInteger) - sendPlayerQuitRequest:
 Invia una richiesta al destinatario per impostare l'ultimo giocatore utilizzato su questo mittente nello stato GCKPlayerStateQuit. Altro…
 
(NSInteger) - sendPlayerQuitRequest:playerID:
 Invia una richiesta al destinatario per mettere il giocatore 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:
 Chiamato quando è stato ricevuto un messaggio su questo canale. Altro…
 
(BOOL) - sendTextMessage:
 Invia un messaggio su questo canale. Altro…
 
(BOOL) - sendTextMessage:error:
 Invia un messaggio su questo canale. Altro…
 
(NSInteger) - generateRequestID
 Genera un ID richiesta per un nuovo messaggio. Altro…
 
(NSNumber *__nullable) - generateRequestNumber
 Un metodo pratico che racchiude il risultato di generateRequestID in un NSNumber. Altro…
 
(void) - didConnect
 Chiamato quando questo canale è stato connesso, a indicare che ora è possibile scambiare messaggi con il dispositivo Cast su questo canale. Altro…
 
(void) - didDisconnect
 Chiamato quando questo canale è stato disconnesso, a indicare che non è più possibile scambiare messaggi con il dispositivo di trasmissione su questo canale. Altro…
 

Riepilogo della proprietà

id< GCKGameManagerChannelDelegatedelegate
 Il delegato per la ricezione delle notifiche da GCKGameManagerChannel. Altro…
 
GCKGameManagerStatecurrentState
 Lo stato attuale del gestore di giochi. Altro…
 
NSString * lastUsedPlayerID
 L'ultimo ID giocatore controllabile utilizzato in questa sessione. Altro…
 
BOOL isInitialConnectionEstablished
 Indica se questo canale è connesso a Game Manager del destinatario e se è pronto per l'interazione. Altro…
 
NSString * protocolNamespace
 Lo spazio dei nomi del canale. Altro…
 
BOOL isConnected
 Un flag che indica se questo canale è attualmente connesso. Altro…
 
GCKDeviceManagerdeviceManager
 Il gestore del dispositivo con cui è registrato questo canale, se presente. Altro…
 

Dettagli metodo

- (instancetype) initWithSessionID: (NSString *)  castSessionID

Inizializzatore designato.

Si connette automaticamente al Game Manager del ricevitore.

Parameters
castSessionIDThe Session ID corresponding to the currently connected Game Manager.
- (instancetype) init

L'inizializzatore predefinito non è disponibile.

Implementa GCKCastChannel.

- (NSInteger) sendPlayerAvailableRequest: (id __nullable)  extraData

Invia una richiesta al destinatario per impostare l'ultimo giocatore utilizzato su questo mittente nello stato GCKPlayerStateAvailable.

Se non si tratta di una transizione valida per il giocatore, verrà attivato un errore in GCKGameManagerChannelDelegate. Se non è presente un ultimo player utilizzato, verrà registrato un nuovo player e il relativo ID player verrà impostato come ultimo ID player utilizzato quando il destinatario risponde a questa richiesta. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia un messaggio di callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Vedi anche
lastUsedPlayerID
Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (NSInteger) sendPlayerAvailableRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Invia una richiesta al destinatario per mettere il giocatore nello stato GCKPlayerStateAvailable.

Se non si tratta di una transizione valida per il giocatore, verrà attivato un errore in GCKGameManagerChannelDelegate. Se l'ID giocatore è nil, verrà registrato un nuovo giocatore e il suo ID giocatore verrà impostato come l'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 gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia un messaggio di callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe player ID of the player whose state is to be changed.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (NSInteger) sendPlayerReadyRequest: (id __nullable)  extraData

Invia una richiesta al destinatario per impostare l'ultimo giocatore utilizzato su questo mittente nello stato GCKPlayerStateReady.

Se non si tratta di una transizione valida per il giocatore o se non è presente un ID giocatore utilizzato di recente, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia un messaggio di callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Vedi anche
lastUsedPlayerID
Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (NSInteger) sendPlayerReadyRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Invia una richiesta al destinatario per mettere il giocatore nello stato GCKPlayerStateReady.

Se non si tratta di una transizione valida per il giocatore o se non è presente un ID giocatore utilizzato di recente, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia un messaggio di callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe player ID of the player to change the state.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (NSInteger) sendPlayerPlayingRequest: (id __nullable)  extraData

Invia una richiesta al destinatario per impostare l'ultimo giocatore utilizzato su questo mittente nello stato GCKPlayerStatePlaying.

Se non si tratta di una transizione valida per il giocatore o se non è presente un ID giocatore utilizzato di recente, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia un messaggio di callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Vedi anche
lastUsedPlayerID
Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (NSInteger) sendPlayerPlayingRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Invia una richiesta al destinatario per mettere il giocatore nello stato GCKPlayerStatePlaying.

Se non si tratta di una transizione valida per il giocatore o se non è presente un ID giocatore utilizzato di recente, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia un messaggio di callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe player ID of the player to change the state.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (NSInteger) sendPlayerIdleRequest: (id __nullable)  extraData

Invia una richiesta al destinatario per impostare l'ultimo giocatore utilizzato su questo mittente nello stato GCKPlayerStateIdle.

Se non si tratta di una transizione valida per il giocatore o se non è presente un ID giocatore utilizzato di recente, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi del callback del delegato GCKGameManagerChannel::gameManagerChannel:requestDidFailWithID:error: se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Vedi anche
lastUsedPlayerID
Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (NSInteger) sendPlayerIdleRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Invia una richiesta al destinatario per mettere il giocatore nello stato GCKPlayerStateIdle.

Se non si tratta di una transizione valida per il giocatore o se non è presente un ID giocatore utilizzato di recente, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia un messaggio di callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe player ID of the player to change the state.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (NSInteger) sendPlayerQuitRequest: (id __nullable)  extraData

Invia una richiesta al destinatario per impostare l'ultimo giocatore utilizzato su questo mittente nello stato GCKPlayerStateQuit.

Se non si tratta di una transizione valida per il giocatore o se non è presente un ID giocatore utilizzato di recente, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia un messaggio di callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Vedi anche
lastUsedPlayerID
Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (NSInteger) sendPlayerQuitRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Invia una richiesta al destinatario per mettere il giocatore nello stato GCKPlayerStateQuit.

Se non si tratta di una transizione valida per il giocatore o se non è presente un ID giocatore utilizzato di recente, verrà attivato un errore in GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Messaggi il callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe player ID of the player to change the state.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (NSInteger) sendGameRequest: (id __nullable)  extraData

Invia un messaggio specifico per il gioco al destinatario.

I contenuti del messaggio dipendono interamente dall'applicazione. Il messaggio verrà inviato da lastUsedPlayerID. Il destinatario invierà una risposta a questo mittente tramite GCKGameManagerChannelDelegate. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia messaggi al callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a GameManager del destinatario.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (NSInteger) sendGameRequest: (id __nullable)  extraData
playerID: (NSString *)  playerID 

Invia un messaggio specifico per il gioco al destinatario.

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

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe id of the controllable player sending this message.
Resi
L'ID richiesta o kGCKInvalidRequestID se la richiesta non è stata inviata.
- (void) sendGameMessage: (id __nullable)  extraData

Invia un messaggio specifico per il gioco al destinatario.

I contenuti del messaggio dipendono interamente dall'applicazione. Il messaggio verrà inviato da lastUsedPlayerID. Si tratta di un metodo di invio senza garanzia di ricezione e senza possibilità di risposta da parte del destinatario. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia un messaggio di callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Parameters
extraDataCustom 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.

Il contenuto del messaggio dipende interamente dall'applicazione. Il messaggio avrà origine dall'ID giocatore locale specificato. Si tratta di un metodo di invio senza garanzia di ricezione e senza possibilità di risposta da parte del destinatario. Questo metodo deve essere chiamato solo dopo che è stato inviato un messaggio al callback del delegato gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p). Invia un messaggio di callback del delegato gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) se GCKGameManagerChannel non è ancora connesso a Game Manager del destinatario.

Parameters
extraDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
playerIDThe ID of the controllable player sending this message.
- (instancetype) initWithNamespace: (NSString *)  protocolNamespace

Inizializzatore designato.

Costruisce un nuovo GCKCastChannel con lo spazio dei nomi specificato.

Parameters
protocolNamespaceThe namespace.

Implementato in GCKGenericChannel.

- (void) didReceiveTextMessage: (NSString *)  message

Chiamato quando è stato ricevuto un messaggio su questo canale.

L'implementazione predefinita è un'operazione nulla.

Parameters
messageThe message.
- (BOOL) sendTextMessage: (NSString *)  message

Invia un messaggio su questo canale.

Parameters
messageThe message.
Resi
YES in caso di esito positivo o NO se il messaggio non è stato inviato (perché il canale non è connesso 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 messaggio su questo canale.

Parameters
messageThe message.
errorA pointer at which to store the error result. May be nil.
Resi
YES in caso di esito positivo o NO se il messaggio non è stato inviato.
- (NSInteger) generateRequestID

Genera un ID richiesta per un nuovo messaggio.

Resi
L'ID generato o kGCKInvalidRequestID se il canale non è attualmente collegato.
- (NSNumber * __nullable) generateRequestNumber

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

Resi
L'ID generato o nil se il canale non è attualmente collegato.
- (void) didConnect

Chiamato quando questo canale è stato connesso, a indicare che ora è possibile scambiare messaggi con il dispositivo Cast su questo canale.

L'implementazione predefinita è un'operazione nulla.

- (void) didDisconnect

Chiamato quando questo canale è stato disconnesso, a indicare che non è più possibile scambiare messaggi con il dispositivo di trasmissione su questo canale.

L'implementazione predefinita è un'operazione nulla.

Dettaglio proprietà

- (id<GCKGameManagerChannelDelegate>) delegate
readwritenonatomicweak

Il delegato per la ricezione delle notifiche da GCKGameManagerChannel.

- (GCKGameManagerState*) currentState
readnonatomicstrong

Lo stato attuale del gestore di giochi.

- (NSString*) lastUsedPlayerID
readnonatomiccopy

L'ultimo ID giocatore controllabile utilizzato in questa sessione.

Può essere nil se non è configurato alcun lettore controllabile con il ricevitore.

Vedi anche
- sendPlayerAvailableRequest:
- (BOOL) isInitialConnectionEstablished
readnonatomicassign

Indica se questo canale è connesso a Game Manager del destinatario e se è pronto per l'interazione.

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

Resi
YES se questo canale è connesso a Game Manager del destinatario e pronto a 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 connesso.

- (GCKDeviceManager*) deviceManager
readnonatomicweakinherited

Il gestore del dispositivo con cui è registrato questo canale, se presente.

Deprecated:
Se questo canale non è stato registrato con la classe GCKDeviceManager deprecata, questo valore sarà nil.