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< GCKGameManagerChannelDelegate > | delegate |
Il delegato per la ricezione delle notifiche da GCKGameManagerChannel. Altro… | |
GCKGameManagerState * | currentState |
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… | |
GCKDeviceManager * | deviceManager |
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
-
castSessionID The 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
-
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
.
- 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
-
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.
- 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
-
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
.
- 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
-
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.
- 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
-
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
.
- 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
-
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.
- 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
-
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
.
- 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
-
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.
- 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
-
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
.
- 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
-
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.
- 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
-
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
.
- 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
-
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.
- 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
-
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.
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
-
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.
Costruisce un nuovo GCKCastChannel con lo spazio dei nomi specificato.
- Parameters
-
protocolNamespace The namespace.
Implementato in GCKGenericChannel.
- (void) didReceiveTextMessage: | (NSString *) | message |
Chiamato quando è stato ricevuto un messaggio su questo canale.
L'implementazione predefinita è un'operazione nulla.
- Parameters
-
message The message.
- (BOOL) sendTextMessage: | (NSString *) | message |
Invia un messaggio su questo canale.
- Parameters
-
message The message.
- Resi
YES
in caso di esito positivo oNO
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
-
message The message. error A pointer at which to store the error result. May be nil
.
- Resi
YES
in caso di esito positivo oNO
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à
|
readwritenonatomicweak |
Il delegato per la ricezione delle notifiche da GCKGameManagerChannel.
|
readnonatomicstrong |
Lo stato attuale del gestore di giochi.
|
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:
|
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.
|
readnonatomiccopyinherited |
Lo spazio dei nomi del canale.
|
readnonatomicassigninherited |
Un flag che indica se questo canale è attualmente connesso.
|
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
.