Обзор

Подкласс 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 по этому каналу больше невозможен.

Реализация по умолчанию не работает.

Сведения о собственности

- (id< GCKGameManagerChannelDelegate >) delegate

read write nonatomic weak

Делегат для получения уведомлений от GCKGameManagerChannel .

- ( GCKGameManagerState *) currentState

read nonatomic strong

Текущее состояние игрового менеджера.

- (NSString*) lastUsedPlayerID

read nonatomic copy

Последний контролируемый идентификатор игрока, использованный в этом сеансе.

Это значение может быть nil , если с приемником не настроен управляемый проигрыватель.

Смотрите также: - sendPlayerAvailableRequest:

- (BOOL) isInitialConnectionEstablished

read nonatomic assign

Связан ли этот канал с Game Manager получателя и готовы ли мы с ним взаимодействовать.

Этот метод вернет NO с точки создания этого канала.

Возвращает: YES , если этот канал подключен к Game Manager приемника и готов к взаимодействию с ним; NO иначе.

- (NSString*) protocolNamespace

read nonatomic copy inherited

Пространство имен канала.

- (BOOL) isConnected

read nonatomic assign inherited

Флаг, указывающий, подключен ли этот канал в данный момент.

- ( GCKDeviceManager *) deviceManager

read nonatomic weak inherited

Диспетчер устройств, в котором зарегистрирован этот канал, если он есть.

Deprecated:: Если этот канал не был зарегистрирован в устаревшем классе GCKDeviceManager , это будет nil .

Класс GCKGameManagerChannel

Обзор

Резюме метода экземпляра

Сводка свойств

Сведения о методе

Сведения о собственности