Обзор
Абстрактный базовый класс, представляющий сеанс с устройством-приемником.
Подклассы должны реализовывать методы start (GCKSession(Protected)) , endAndStopCasting: (GCKSession(Protected)) , suspendWithReason: (GCKSession(Protected)) и resume (GCKSession(Protected)) и должны вызывать соответствующие методы уведомителя (например, , notifyDidStartWithSessionID: (GCKSession(Protected)) ), чтобы указать соответствующие изменения в состоянии сеанса. Подклассы также могут реализовывать setDeviceVolume: (GCKSession) , setDeviceMuted: (GCKSession) и remoteMediaClient , если устройство поддерживает такие операции.
Сеанс создается и контролируется с помощью методов сеанса в GCKSessionManager , который использует соответствующий GCKDeviceProvider для создания сеанса, а затем делегирует запросы сеанса этому объекту GCKSession .
- С
- 3.0
Наследует NSObject.
Унаследовано GCKCastSession .
Сводка метода экземпляра | |
| (instancetype) | - initWithDevice:traits:sessionID: |
| Инициализирует новый объект сеанса для данного устройства. Более... | |
| ( GCKRequest *) | - setDeviceVolume: |
| Устанавливает громкость устройства. Более... | |
| ( GCKRequest *) | - setDeviceMuted: |
| Устанавливает беззвучное состояние устройства. Более... | |
| (void) | - start |
| Запускает сеанс. Более... | |
| (void) | - endAndStopCasting: |
| Завершает сеанс. Более... | |
| (void) | - suspendWithReason: |
| Приостанавливает сеанс по указанной причине. Более... | |
| (void) | - resume |
| Возобновляет сеанс. Более... | |
| (void) | - notifyDidStartWithSessionID: |
| Вызывается подклассами для уведомления платформы о запуске сеанса. Более... | |
| (void) | - notifyDidFailToStartWithError: |
| Вызывается подклассами для уведомления платформы о том, что сеанс не удалось запустить. Более... | |
| (void) | - notifyDidResume |
| Вызывается подклассами для уведомления платформы о возобновлении сеанса. Более... | |
| (void) | - notifyDidSuspendWithReason: |
| Вызывается подклассами для уведомления платформы о приостановке сеанса. Более... | |
| (void) | - notifyDidEndWithError: |
| Вызывается подклассами для уведомления платформы о завершении сеанса. Более... | |
| (void) | - notifyDidReceiveDeviceVolume:muted: |
| Вызывается подклассами для уведомления платформы о том, что с устройства были получены обновленная громкость устройства и состояние отключения звука. Более... | |
| (void) | - notifyDidReceiveDeviceStatus: |
| Вызывается подклассами для уведомления платформы о получении обновленного статуса от устройства. Более... | |
Сводная информация о недвижимости | |
| GCKDevice * | device |
| Устройство, с которым связан этот сеанс. Более... | |
| NSString * | sessionID |
| Текущий идентификатор сеанса, если таковой имеется. Более... | |
| GCKConnectionState | connectionState |
| Текущее состояние соединения сеанса. Более... | |
| BOOL | suspended |
| Флаг, указывающий, приостановлен ли сеанс в данный момент. Более... | |
| NSString * | deviceStatusText |
| Текст текущего состояния устройства. Более... | |
| GCKSessionTraits * | traits |
| Особенности сессии. Более... | |
| float | currentDeviceVolume |
| Текущая громкость устройства в диапазоне [0,0, 1,0]. Более... | |
| BOOL | currentDeviceMuted |
| Текущее состояние отключения звука устройства. Более... | |
| GCKRemoteMediaClient * | remoteMediaClient |
| Объект GCKRemoteMediaClient , который можно использовать для управления воспроизведением мультимедиа в этом сеансе. Более... | |
| GCKMediaMetadata * | mediaMetadata |
| Текущие метаданные мультимедиа, если таковые имеются. Более... | |
Подробности метода
| - (instancetype) initWithDevice: | ( GCKDevice *) | device | |
| traits: | ( GCKSessionTraits *) | traits | |
| sessionID: | (NSString *__nullable) | sessionID | |
Инициализирует новый объект сеанса для данного устройства.
- Parameters
-
device The device. traits The session traits. sessionID The session ID of an existing session, if this object will be used to resume a session; otherwise nilif it will be used to start a new session.
| - ( GCKRequest *) setDeviceVolume: | (float) | volume |
Устанавливает громкость устройства.
Это асинхронная операция. Реализация по умолчанию — это пустая операция, которая завершает запрос с ошибкой GCKErrorCodeUnsupportedFeature.
- Parameters
-
volume The new volume.
- Возврат
- Объект GCKRequest для отслеживания запроса.
- С
- 3,4; в предыдущих версиях платформы этот метод возвращал
void.
| - ( GCKRequest *) setDeviceMuted: | (BOOL) | muted |
Устанавливает беззвучное состояние устройства.
Это асинхронная операция. Реализация по умолчанию — это пустая операция, которая завершает запрос с ошибкой GCKErrorCodeUnsupportedFeature.
- Parameters
-
muted The new mute state.
- Возврат
- Объект GCKRequest для отслеживания запроса.
- С
- 3,4; в предыдущих версиях платформы этот метод возвращал
void.
| - (void) start |
Запускает сеанс.
Это асинхронная операция. Должен быть переопределен подклассами.
Предоставлено категорией GCKSession(Protected) .
| - (void) endAndStopCasting: | (BOOL) | stopCasting |
Завершает сеанс.
Это асинхронная операция. Должен быть переопределен подклассами.
- Parameters
-
stopCasting Whether to stop casting content to the receiver.
Предоставлено категорией GCKSession(Protected) .
| - (void) suspendWithReason: | ( GCKConnectionSuspendReason ) | reason |
Приостанавливает сеанс по указанной причине.
Это асинхронная операция. Должен быть переопределен подклассами.
Предоставлено категорией GCKSession(Protected) .
| - (void) resume |
Возобновляет сеанс.
Это асинхронная операция. Должен быть переопределен подклассами.
Предоставлено категорией GCKSession(Protected) .
| - (void) notifyDidStartWithSessionID: | (NSString *) | sessionID |
Вызывается подклассами для уведомления платформы о запуске сеанса.
- Parameters
-
sessionID The session's unique ID.
Предоставлено категорией GCKSession(Protected) .
| - (void) notifyDidFailToStartWithError: | (NSError *) | error |
Вызывается подклассами для уведомления платформы о том, что сеанс не удалось запустить.
- Parameters
-
error The error that occurred.
Предоставлено категорией GCKSession(Protected) .
| - (void) notifyDidResume |
Вызывается подклассами для уведомления платформы о возобновлении сеанса.
Предоставлено категорией GCKSession(Protected) .
| - (void) notifyDidSuspendWithReason: | ( GCKConnectionSuspendReason ) | reason |
Вызывается подклассами для уведомления платформы о приостановке сеанса.
- Parameters
-
reason The reason for the suspension.
Предоставлено категорией GCKSession(Protected) .
| - (void) notifyDidEndWithError: | (NSError *__nullable) | error |
Вызывается подклассами для уведомления платформы о завершении сеанса.
- Parameters
-
error The error that caused the session to end, if any. Should be nilif the session was ended intentionally.
Предоставлено категорией GCKSession(Protected) .
| - (void) notifyDidReceiveDeviceVolume: | (float) | volume | |
| muted: | (BOOL) | muted | |
Вызывается подклассами для уведомления платформы о том, что с устройства были получены обновленная громкость устройства и состояние отключения звука.
- Parameters
-
volume The device's current volume. Must be in the range [0, 1.0]; muted The device's current mute state.
Предоставлено категорией GCKSession(Protected) .
| - (void) notifyDidReceiveDeviceStatus: | (NSString *__nullable) | statusText |
Вызывается подклассами для уведомления платформы о получении обновленного статуса от устройства.
- Parameters
-
statusText The new status.
Предоставляется категорией GCKSession(Protected) .
Детали недвижимости
|
read nonatomic strong |
Устройство, с которым связан этот сеанс.
|
read nonatomic copy |
Текущий идентификатор сеанса, если таковой имеется.
|
read nonatomic assign |
Текущее состояние соединения сеанса.
|
read nonatomic assign |
Флаг, указывающий, приостановлен ли сеанс в данный момент.
|
read nonatomic copy |
Текст текущего состояния устройства.
|
read nonatomic copy |
Особенности сессии.
|
read nonatomic assign |
Текущая громкость устройства в диапазоне [0,0, 1,0].
|
read nonatomic assign |
Текущее состояние отключения звука устройства.
|
read nonatomic strong |
Объект GCKRemoteMediaClient , который можно использовать для управления воспроизведением мультимедиа в этом сеансе.
Оно nil до начала сеанса или если сеанс не поддерживает API GCKRemoteMediaClient . Подклассы, предоставляющие интерфейс GCKRemoteMediaClient должны переопределить метод получения.
|
read nonatomic strong |
Текущие метаданные мультимедиа, если таковые имеются.
Будет nil , если сеанс не поддерживает пространство имен мультимедиа или если в данный момент на приемнике не загружено ни одного мультимедиа.