Обзор

Класс, который управляет сеансом Cast с устройством-приемником.

Сеансы создаются и управляются автоматически с помощью GCKSessionManager . Приложение не должно напрямую вызывать методы жизненного цикла сеанса, такие как start (GCKSession(Protected)) или endWithAction: (GCKSession(Protected)) .

С: 3.0

Наследует GCKSession .

Сводка метода экземпляра
(instancetype)	- initWithDevice:sessionID:sessionOptions:castOptions:
	Создает новый сеанс трансляции с заданными параметрами трансляции. Более...

(BOOL)	- addChannel:
	Регистрирует канал в сеансе. Более...

(BOOL)	- removeChannel:
	Удаляет ранее зарегистрированный канал из сеанса. Более...

(void)	- addDeviceStatusListener:
	Добавляет GCKCastDeviceStatusListener в список прослушивателей этого объекта. Более...

(void)	- removeDeviceStatusListener:
	Удаляет GCKCastDeviceStatusListener из списка прослушивателей этого объекта. Более...

( GCKRequest *)	- setDeviceVolume:forMultizoneDevice:
	Устанавливает громкость отдельного устройства в многозонной группе. Более...

( GCKRequest *)	- setDeviceMuted:forMultizoneDevice:
	Устанавливает состояние отключения звука отдельного устройства в многозонной группе. Более...

( GCKRequest *)	- requestMultizoneStatus
	Запросить статус мультизоны у мультизональной группы. Более...

(instancetype)	- initWithDevice:traits:sessionID:
	Инициализирует новый объект сеанса для данного устройства с параметрами по умолчанию. Более...

(instancetype)	- initWithDevice:traits:sessionID:sessionOptions:
	Инициализирует новый объект сеанса для данного устройства. Более...

( GCKRequest *)	- setDeviceVolume:
	Устанавливает громкость устройства. Более...

( GCKRequest *)	- setDeviceMuted:
	Устанавливает беззвучное состояние устройства. Более...

(void)	- start
	Запускает сеанс. Более...

(void)	- endWithAction:
	Завершает сеанс указанным действием. Более...

(void)	- notifyDidStartWithSessionID:
	Вызывается подклассами для уведомления платформы о запуске сеанса. Более...

(void)	- notifyDidFailToStartWithError:
	Вызывается подклассами для уведомления платформы о том, что сеанс не удалось запустить. Более...

(void)	- notifyDidEndWithError:willTryToResume:
	Вызывается подклассами для уведомления платформы о завершении сеанса. Более...

(void)	- notifyDidReceiveDeviceVolume:muted:
	Вызывается подклассами для уведомления платформы о том, что с устройства были получены обновленная громкость устройства и состояние отключения звука. Более...

(void)	- notifyDidReceiveDeviceStatus:
	Вызывается подклассами для уведомления платформы о получении обновленного статуса от устройства. Более...

(void)	- notifyDidSuspendWithReason:
	Устарело, не используйте - реализовано как неактивное. Более...

(void)	- notifyDidResume
	Устарело, не используйте - реализовано как неактивное. Более...

Сводная информация о недвижимости
GCKActiveInputStatus	activeInputStatus
	Текущий статус «активного входа» устройства. Более...

GCKStandbyStatus	standbyStatus
	Текущий статус устройства в режиме ожидания. Более...

GCKApplicationMetadata *	applicationMetadata
	Метаданные приложения-получателя, которое в данный момент работает на устройстве-получателе, если таковые имеются; в противном случае `nil` . Более...

GCKDevice *	device
	Устройство, с которым связан этот сеанс. Более...

NSString *	sessionID
	Текущий идентификатор сеанса, если таковой имеется. Более...

GCKSessionOptions *	sessionOptions
	Параметры сеанса, если таковые имеются. Более...

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
sessionID:	(nullable NSString *)	sessionID
sessionOptions:	(nullable GCKSessionOptions *)	sessionOptions
castOptions:	( GCKCastOptions *)	castOptions

Создает новый сеанс трансляции с заданными параметрами трансляции.

Parameters

device	The receiver device.
sessionID	The session ID, if resuming; otherwise `nil` .
sessionOptions	The session options, if any; otherwise `nil` .
castOptions	The Cast options.

С: 4.0

- (BOOL) addChannel: ( GCKCastChannel *) channel

Регистрирует канал в сеансе.

Если сеанс подключен и приложение-получатель поддерживает пространство имен канала, канал будет подключен автоматически. Если сеанс не подключен, канал будет оставаться в отключенном состоянии до тех пор, пока сеанс не будет запущен.

Parameters

channel The channel to register.

Возврат: YES , если канал успешно зарегистрирован, в противном случае NO .

- (BOOL) removeChannel: ( GCKCastChannel *) channel

Удаляет ранее зарегистрированный канал из сеанса.

Parameters

channel The channel to unregister.

Возврат: YES , если канал был успешно отменен, в противном случае NO .

- (void) addDeviceStatusListener: (id< GCKCastDeviceStatusListener >) listener

Добавляет GCKCastDeviceStatusListener в список прослушивателей этого объекта.

Добавленный прослушиватель слабо удерживается, и его следует сохранить, чтобы избежать неожиданного освобождения.

Parameters

listener The listener to add.

- (void) removeDeviceStatusListener: (id< GCKCastDeviceStatusListener >) listener

Удаляет GCKCastDeviceStatusListener из списка прослушивателей этого объекта.

Parameters

listener The listener to remove.

- ( GCKRequest *) setDeviceVolume:	(float)	volume
forMultizoneDevice:	( GCKMultizoneDevice *)	device

Устанавливает громкость отдельного устройства в многозонной группе.

Это асинхронная операция.

Parameters

volume	The new volume, in the range [0.0, 1.0].
device	The multizone device.

Возврат: Объект GCKRequest для отслеживания запроса.

- ( GCKRequest *) setDeviceMuted:	(BOOL)	muted
forMultizoneDevice:	( GCKMultizoneDevice *)	device

Устанавливает состояние отключения звука отдельного устройства в многозонной группе.

Это асинхронная операция.

Parameters

muted	The new muted state.
device	The multizone device.

Возврат: Объект GCKRequest для отслеживания запроса.

- ( GCKRequest *) requestMultizoneStatus

Запросить статус мультизоны у мультизональной группы.

Это асинхронная операция. При получении статуса мультизоны методу делегата castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p) будет отправлено сообщение.

Возврат: Объект GCKRequest для отслеживания запроса.

- (instancetype) initWithDevice:	( GCKDevice *)	device
traits:	(nullable GCKSessionTraits *)	traits
sessionID:	(nullable NSString *)	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.

- (instancetype) initWithDevice:	( GCKDevice *)	device
traits:	(nullable GCKSessionTraits *)	traits
sessionID:	(nullable NSString *)	sessionID
sessionOptions:	(nullable GCKSessionOptions *)	sessionOptions

Инициализирует новый объект сеанса для данного устройства.

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.
sessionOptions	The session options, if any; otherwise `nil` .

С: 4.0

- ( 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

Запускает сеанс.

Это асинхронная операция. Должен быть переопределен подклассами.