Обзор

Подкласс GCKCastChannel для операций управления игрой.

См. GCKGameManagerChannelDelegate для протокола делегирования.

Deprecated:: API Game Manager больше не поддерживается и будет удален в будущем выпуске.

Наследует 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

Обзор

Сводка метода экземпляра

Сводная информация о недвижимости

Подробности метода

Детали недвижимости