Обзор
Виртуальный канал связи для обмена сообщениями между отправителем Cast и получателем Cast.
Каждый канал помечен уникальным пространством имен, поэтому несколько каналов могут быть мультиплексированы в одном сетевом соединении между отправителем и получателем.
Прежде чем канал можно будет использовать, он должен быть зарегистрирован в GCKCastSession . Когда соответствующий сеанс будет установлен, канал будет подключен автоматически и затем сможет отправлять и получать сообщения.
Подклассы должны реализовывать метод didReceiveTextMessage: (GCKCastChannel) для обработки входящих сообщений и обычно предоставляют дополнительные методы для отправки сообщений, специфичных для данного пространства имен.
Наследует NSObject.
Унаследовано GCKGameManagerChannel , GCKGenericChannel и GCKMediaControlChannel .
Сводка метода экземпляра | |
(instancetype) | - initWithNamespace: |
Назначенный инициализатор. Более... | |
(instancetype) | - init |
Инициализатор по умолчанию недоступен. Более... | |
(void) | - didReceiveTextMessage: |
Вызывается, когда на этом канале получено текстовое сообщение. Более... | |
(BOOL) | - sendTextMessage: |
Отправляет текстовое сообщение на этот канал. Более... | |
(BOOL) | - sendTextMessage:error: |
Отправляет текстовое сообщение на этот канал. Более... | |
(NSInteger) | - generateRequestID |
Генерирует идентификатор запроса для нового сообщения. Более... | |
(NSNumber *__nullable) | - generateRequestNumber |
Удобный метод, который оборачивает результат generateRequestID в NSNumber . Более... | |
(void) | - didConnect |
Вызывается, когда этот канал подключен, указывая, что теперь можно обмениваться сообщениями с устройством Cast по этому каналу. Более... | |
(void) | - didDisconnect |
Вызывается, когда этот канал отключен, что указывает на то, что обмен сообщениями с устройством Cast по этому каналу больше невозможен. Более... | |
Сводная информация о недвижимости | |
NSString * | protocolNamespace |
Пространство имен канала. Более... | |
BOOL | isConnected |
Флаг, указывающий, подключен ли этот канал в данный момент. Более... | |
GCKDeviceManager * | deviceManager |
Диспетчер устройств, в котором зарегистрирован этот канал, если таковой имеется. Более... | |
Подробности метода
- (instancetype) initWithNamespace: | (NSString *) | protocolNamespace |
Назначенный инициализатор.
Создает новый GCKCastChannel с заданным пространством имен.
- Parameters
-
protocolNamespace The namespace.
Реализовано в GCKGenericChannel .
- (instancetype) init |
Инициализатор по умолчанию недоступен.
Реализовано в GCKMediaControlChannel и GCKGameManagerChannel .
- (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 nonatomic copy |
Пространство имен канала.
|
read nonatomic assign |
Флаг, указывающий, подключен ли этот канал в данный момент.
|
read nonatomic weak |
Диспетчер устройств, в котором зарегистрирован этот канал, если таковой имеется.
- Deprecated:
- Если этот канал не был зарегистрирован в устаревшем классе GCKDeviceManager , это будет
nil
.