Обзор
Подкласс GCKCastChannel для операций управления игрой.
См. GCKGameManagerChannelDelegate для протокола делегата.
- Deprecated:
- Game Manager API больше не поддерживается и будет удален в будущем выпуске.
Наследует GCKCastChannel .
Резюме метода экземпляра | |
(instancetype) | - initWithSessionID: |
Назначенный инициализатор. Более... | |
(instancetype) | - init |
Инициализатор по умолчанию недоступен. Более... | |
(NSInteger) | - sendPlayerAvailableRequest: |
Отправляет получателю запрос на перевод последнего использованного игрока на этом отправителе в состояние GCKPlayerStateAvailable . Более... | |
(NSInteger) | - sendPlayerAvailableRequest:playerID: |
Отправляет получателю запрос на перевод игрока в состояние GCKPlayerStateAvailable . Более... | |
(NSInteger) | - sendPlayerReadyRequest: |
Отправляет получателю запрос на перевод последнего использованного игрока на этом отправителе в состояние GCKPlayerStateReady . Более... | |
(NSInteger) | - sendPlayerReadyRequest:playerID: |
Отправляет получателю запрос на перевод проигрывателя в состояние GCKPlayerStateReady . Более... | |
(NSInteger) | - sendPlayerPlayingRequest: |
Отправляет получателю запрос на перевод последнего использованного игрока на этом отправителе в состояние GCKPlayerStatePlaying . Более... | |
(NSInteger) | - sendPlayerPlayingRequest:playerID: |
Отправляет получателю запрос на перевод проигрывателя в состояние GCKPlayerStatePlaying . Более... | |
(NSInteger) | - sendPlayerIdleRequest: |
Отправляет получателю запрос на перевод последнего использованного игрока на этом отправителе в состояние GCKPlayerStateIdle . Более... | |
(NSInteger) | - sendPlayerIdleRequest:playerID: |
Отправляет получателю запрос на перевод игрока в состояние GCKPlayerStateIdle . Более... | |
(NSInteger) | - sendPlayerQuitRequest: |
Отправляет получателю запрос на перевод последнего использованного игрока на этом отправителе в состояние GCKPlayerStateQuit . Более... | |
(NSInteger) | - sendPlayerQuitRequest:playerID: |
Отправляет получателю запрос на перевод игрока в состояние GCKPlayerStateQuit . Более... | |
(NSInteger) | - sendGameRequest: |
Отправляет получателю сообщение об игре. Более... | |
(NSInteger) | - sendGameRequest:playerID: |
Отправляет получателю сообщение об игре. Более... | |
(void) | - sendGameMessage: |
Отправляет получателю сообщение об игре. Более... | |
(void) | - sendGameMessage:playerID: |
Отправляет получателю сообщение об игре. Более... | |
(instancetype) | - initWithNamespace: |
Назначенный инициализатор. Более... | |
(void) | - didReceiveTextMessage: |
Вызывается при получении текстового сообщения на этом канале. Более... | |
(BOOL) | - sendTextMessage: |
Отправляет текстовое сообщение на этот канал. Более... | |
(BOOL) | - sendTextMessage:error: |
Отправляет текстовое сообщение на этот канал. Более... | |
(NSInteger) | - generateRequestID |
Создает идентификатор запроса для нового сообщения. Более... | |
(NSNumber *__nullable) | - generateRequestNumber |
Удобный метод, который упаковывает результат generateRequestID в NSNumber . Более... | |
(void) | - didConnect |
Вызывается, когда этот канал был подключен, указывая, что теперь можно обмениваться сообщениями с устройством Cast по этому каналу. Более... | |
(void) | - didDisconnect |
Вызывается, когда этот канал был отключен, указывая на то, что обмен сообщениями с устройством Cast по этому каналу больше невозможен. Более... | |
Сводка свойств | |
id< GCKGameManagerChannelDelegate > | delegate |
Делегат для получения уведомлений от GCKGameManagerChannel . Более... | |
GCKGameManagerState * | currentState |
Текущее состояние игрового менеджера. Более... | |
NSString * | lastUsedPlayerID |
Последний контролируемый идентификатор игрока, использованный в этом сеансе. Более... | |
BOOL | isInitialConnectionEstablished |
Связан ли этот канал с Game Manager получателя и готовы ли мы с ним взаимодействовать. Более... | |
NSString * | protocolNamespace |
Пространство имен канала. Более... | |
BOOL | isConnected |
Флаг, указывающий, подключен ли этот канал в данный момент. Более... | |
GCKDeviceManager * | deviceManager |
Диспетчер устройств, в котором зарегистрирован этот канал, если он есть. Более... | |
Сведения о методе
- (instancetype) initWithSessionID: | (NSString *) | castSessionID |
Назначенный инициализатор.
Автоматически подключается к Game Manager приемника.
- Parameters
-
castSessionID The Session ID corresponding to the currently connected Game Manager.
- (instancetype) init |
Инициализатор по умолчанию недоступен.
Реализует GCKCastChannel .
- (NSInteger) sendPlayerAvailableRequest: | (id __nullable) | extraData |
Отправляет получателю запрос на перевод последнего использованного игрока на этом отправителе в состояние GCKPlayerStateAvailable .
Если это недопустимый переход для этого игрока, в GCKGameManagerChannelDelegate будет вызвана ошибка. Если нет последнего использовавшегося игрока, будет зарегистрирован новый игрок, и его идентификатор игрока будет установлен как последний использованный идентификатор игрока, когда приемник ответит на этот запрос. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- Смотрите также
- 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
.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (NSInteger) sendPlayerAvailableRequest: | (id __nullable) | extraData | |
playerID: | (NSString *) | playerID | |
Отправляет получателю запрос на перевод игрока в состояние GCKPlayerStateAvailable .
Если это недопустимый переход для этого игрока, в GCKGameManagerChannelDelegate будет вызвана ошибка. Если идентификатор игрока равен nil
, будет зарегистрирован новый игрок, и его идентификатор игрока будет установлен как последний использованный идентификатор игрока, когда получатель ответит на этот запрос. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- 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.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (NSInteger) sendPlayerReadyRequest: | (id __nullable) | extraData |
Отправляет получателю запрос на перевод последнего использованного игрока на этом отправителе в состояние GCKPlayerStateReady .
Если это недопустимый переход для этого игрока или если нет последнего использованного идентификатора игрока, в GCKGameManagerChannelDelegate будет вызвана ошибка. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- Смотрите также
- 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
.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (NSInteger) sendPlayerReadyRequest: | (id __nullable) | extraData | |
playerID: | (NSString *) | playerID | |
Отправляет получателю запрос на перевод проигрывателя в состояние GCKPlayerStateReady .
Если это недопустимый переход для этого игрока или если нет последнего использованного идентификатора игрока, в GCKGameManagerChannelDelegate будет вызвана ошибка. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- 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.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (NSInteger) sendPlayerPlayingRequest: | (id __nullable) | extraData |
Отправляет получателю запрос на перевод последнего использованного игрока на этом отправителе в состояние GCKPlayerStatePlaying .
Если это недопустимый переход для этого игрока или если нет последнего использованного идентификатора игрока, в GCKGameManagerChannelDelegate будет вызвана ошибка. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- Смотрите также
- 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
.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (NSInteger) sendPlayerPlayingRequest: | (id __nullable) | extraData | |
playerID: | (NSString *) | playerID | |
Отправляет получателю запрос на перевод проигрывателя в состояние GCKPlayerStatePlaying .
Если это недопустимый переход для этого игрока или если нет последнего использованного идентификатора игрока, в GCKGameManagerChannelDelegate будет вызвана ошибка. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- 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.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (NSInteger) sendPlayerIdleRequest: | (id __nullable) | extraData |
Отправляет получателю запрос на перевод последнего использованного игрока на этом отправителе в состояние GCKPlayerStateIdle .
Если это недопустимый переход для этого игрока или если нет последнего использованного идентификатора игрока, в GCKGameManagerChannelDelegate будет вызвана ошибка. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает GCKGameManagerChannel::gameManagerChannel:requestDidFailWithID:error: делегировать обратный вызов, если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- Смотрите также
- 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
.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (NSInteger) sendPlayerIdleRequest: | (id __nullable) | extraData | |
playerID: | (NSString *) | playerID | |
Отправляет получателю запрос на перевод игрока в состояние GCKPlayerStateIdle .
Если это недопустимый переход для этого игрока или если нет последнего использованного идентификатора игрока, в GCKGameManagerChannelDelegate будет вызвана ошибка. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- 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.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (NSInteger) sendPlayerQuitRequest: | (id __nullable) | extraData |
Отправляет получателю запрос на перевод последнего использованного игрока на этом отправителе в состояние GCKPlayerStateQuit .
Если это недопустимый переход для этого игрока или если нет последнего использованного идентификатора игрока, в GCKGameManagerChannelDelegate будет вызвана ошибка. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- Смотрите также
- 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
.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (NSInteger) sendPlayerQuitRequest: | (id __nullable) | extraData | |
playerID: | (NSString *) | playerID | |
Отправляет получателю запрос на перевод игрока в состояние GCKPlayerStateQuit .
Если это недопустимый переход для этого игрока или если нет последнего использованного идентификатора игрока, в GCKGameManagerChannelDelegate будет вызвана ошибка. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) делегировать обратный вызов, если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- 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.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (NSInteger) sendGameRequest: | (id __nullable) | extraData |
Отправляет получателю сообщение об игре.
Содержание сообщения полностью зависит от приложения. Сообщение будет исходить от lastUsedPlayerID . Получатель отправит ответ этому отправителю через GCKGameManagerChannelDelegate . Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к получателю 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
.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (NSInteger) sendGameRequest: | (id __nullable) | extraData | |
playerID: | (NSString *) | playerID | |
Отправляет получателю сообщение об игре.
Содержание сообщения полностью зависит от приложения. Сообщение будет исходить от playerID
. Если playerID
равен nil
, будет использоваться lastUsedPlayerID . Получатель отправит ответ этому отправителю через GCKGameManagerChannelDelegate . Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- 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.
- Возвращает
- Идентификатор запроса или kGCKInvalidRequestID , если запрос не может быть отправлен.
- (void) sendGameMessage: | (id __nullable) | extraData |
Отправляет получателю сообщение об игре.
Содержание сообщения полностью зависит от приложения. Сообщение будет исходить от lastUsedPlayerID . Это метод «выстрелил и забыл», при котором нет гарантии, что сообщение было отправлено, и получатель не отправит ответ обратно этому отправителю. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- 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 | |
Отправляет получателю сообщение об игре.
Содержание сообщения полностью зависит от приложения. Сообщение будет исходить от указанного локального идентификатора игрока. Это метод «выстрелил и забыл», когда нет гарантии, что сообщение будет отправлено, и получатель не отправит ответ обратно этому отправителю. Этот метод следует вызывать только после того, как было отправлено сообщение об обратном вызове делегата gameManagerChannelDidConnect: (GCKGameManagerChannelDelegate-p) . Сообщает об gameManagerChannel:requestDidFailWithID:error: (GCKGameManagerChannelDelegate-p) , если GCKGameManagerChannel еще не подключен к Game Manager получателя.
- 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 |
Назначенный инициализатор.
Создает новый GCKCastChannel с заданным пространством имен.
- Parameters
-
protocolNamespace The namespace.
Реализовано в GCKGenericChannel .
- (void) didReceiveTextMessage: | (NSString *) | message |
Вызывается при получении текстового сообщения на этом канале.
Реализация по умолчанию не работает.
- Parameters
-
message The message.
- (BOOL) sendTextMessage: | (NSString *) | message |
Отправляет текстовое сообщение на этот канал.
- Parameters
-
message The message.
- Возвращает
-
YES
в случае успеха илиNO
, если сообщение не может быть отправлено (поскольку канал не подключен или потому что буфер отправки в данный момент слишком заполнен).
- Deprecated:
- Используйте sendTextMessage:error: который предоставляет подробную информацию об ошибке.
- (BOOL) sendTextMessage: | (NSString *) | message | |
error: | ( GCKError *__nullable *__nullable) | error | |
Отправляет текстовое сообщение на этот канал.
- Parameters
-
message The message. error A pointer at which to store the error result. May be nil
.
- Возвращает
-
YES
в случае успеха илиNO
, если сообщение не может быть отправлено.
- (NSInteger) generateRequestID |
Создает идентификатор запроса для нового сообщения.
- Возвращает
- Сгенерированный идентификатор или kGCKInvalidRequestID , если канал в данный момент не подключен.
- (NSNumber * __nullable) generateRequestNumber |
Удобный метод, который упаковывает результат generateRequestID в NSNumber .
- Возвращает
- Сгенерированный идентификатор или
nil
, если канал в данный момент не подключен.
- (void) didConnect |
Вызывается, когда этот канал был подключен, указывая, что теперь можно обмениваться сообщениями с устройством Cast по этому каналу.
Реализация по умолчанию не работает.
- (void) didDisconnect |
Вызывается, когда этот канал был отключен, указывая на то, что обмен сообщениями с устройством Cast по этому каналу больше невозможен.
Реализация по умолчанию не работает.
Сведения о собственности
|
read write nonatomic weak |
Делегат для получения уведомлений от GCKGameManagerChannel .
|
read nonatomic strong |
Текущее состояние игрового менеджера.
|
read nonatomic copy |
Последний контролируемый идентификатор игрока, использованный в этом сеансе.
Это значение может быть nil
, если с приемником не настроен управляемый проигрыватель.
- Смотрите также
- - sendPlayerAvailableRequest:
|
read nonatomic assign |
Связан ли этот канал с Game Manager получателя и готовы ли мы с ним взаимодействовать.
Этот метод вернет NO
с точки создания этого канала.
- Возвращает
-
YES
, если этот канал подключен к Game Manager приемника и готов к взаимодействию с ним;NO
иначе.
|
read nonatomic copy inherited |
Пространство имен канала.
|
read nonatomic assign inherited |
Флаг, указывающий, подключен ли этот канал в данный момент.
|
read nonatomic weak inherited |
Диспетчер устройств, в котором зарегистрирован этот канал, если он есть.
- Deprecated:
- Если этот канал не был зарегистрирован в устаревшем классе GCKDeviceManager , это будет
nil
.