Обзор
Абстрактный базовый класс, представляющий сеанс с устройством-приемником.
Подклассы должны реализовывать методы 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 nil
if 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 nil
if 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
, если сеанс не поддерживает пространство имен мультимедиа или если в данный момент на приемнике не загружено ни одного мультимедиа.