Обзор

Контроллер для устройств Cast.

Этот класс может отправлять сообщения, получать сообщения, запускать и закрывать приложения, работающие на устройстве Cast.

Экземпляр GCKDeviceManager должен оставаться в области действия до тех пор, пока соединение с устройством Cast установлено или находится в процессе создания или отключения. Безопасно освободить объект до того, как соединение будет запущено с помощью connect (GCKDeviceManager) или после того, как deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p) , deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) или deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p) был вызван обратный вызов делегата.

Deprecated:: Используйте GCKSessionManager и GCKCastSession для взаимодействия с получателями Cast.

Наследует NSObject.

Сводка метода экземпляра
(instancetype)	- initWithDevice:clientPackageName:
	Создает новый GCKDeviceManager с данным устройством. Более...

(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	Назначенный инициализатор. Более...

(void)	- connect
	Подключается к устройству. Более...

(void)	- disconnect
	Отключается от устройства. Более...

(void)	- disconnectWithLeave:
	Отключается от устройства. Более...

(BOOL)	- addChannel:
	Добавляет канал, который может отправлять и получать сообщения для этого устройства в определенном пространстве имен. Более...

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

(NSInteger)	- launchApplication:
	Запускает приложение. Более...

(NSInteger)	- launchApplication:withLaunchOptions:
	Запускает приложение, используя заданные параметры запуска. Более...

(NSInteger)	- launchApplication:relaunchIfRunning:
	Запускает приложение, при необходимости перезапуская его, если оно уже запущено. Более...

(NSInteger)	- joinApplication:
	Присоединяется к приложению. Более...

(NSInteger)	- joinApplication:sessionID:
	Присоединяется к приложению с определенным идентификатором сеанса приложения. Более...

(BOOL)	- leaveApplication
	Выход из текущего приложения. Более...

(NSInteger)	- stopApplication
	Останавливает все запущенные приложения. Более...

(NSInteger)	- stopApplicationWithSessionID:
	Останавливает приложение с заданным идентификатором сеанса приложения. Более...

(NSInteger)	- setVolume:
	Устанавливает громкость системы. Более...

(NSInteger)	- setMuted:
	Включает или выключает звук. Более...

(NSInteger)	- requestDeviceStatus
	Запрашивает текущий статус устройства. Более...

Сводная информация о недвижимости
BOOL	ignoreAppStateNotifications
	Будет ли этот объект прослушивать уведомления о состоянии приложения. Более...

GCKConnectionState	connectionState
	Текущее состояние подключения диспетчера устройств. Более...

GCKConnectionState	applicationConnectionState
	Текущее состояние подключения приложения диспетчера устройств. Более...

BOOL	isConnected
	True, если диспетчер устройств установил соединение с устройством. Более...

BOOL	isConnectedToApp
	True, если диспетчер устройств установил соединение с приложением на устройстве. Более...

BOOL	isReconnecting
	Значение true, если диспетчер устройств отключен из-за потенциально временного события (например, приложение работает в фоновом режиме или произошла сетевая ошибка, которую можно устранить путем повторного подключения). Более...

NSTimeInterval	reconnectTimeout
	В течение этого времени будет предпринята попытка повторного подключения в случае отключения сокета из-за потенциально временной ошибки. Более...

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

id< GCKDeviceManagerDelegate >	delegate
	Делегат для получения уведомлений от GCKDeviceManager . Более...

float	deviceVolume
	Текущая громкость устройства в диапазоне [0,0, 1,0], если известна; в противном случае 0. Подробнее...

BOOL	deviceMuted
	Текущее состояние отключения звука устройства, если оно известно; в противном случае `NO` . Более...

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

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

NSString *	applicationSessionID
	Идентификатор сеанса приложения для подключенного в данный момент приложения-приемника, если таковой имеется; в противном случае `nil` . Более...

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

NSString *	applicationStatusText
	Последний полученный текст статуса из работающего в данный момент приложения-приемника, если таковой имеется; в противном случае `nil` . Более...

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

- (instancetype) initWithDevice:	( GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName

Создает новый GCKDeviceManager с данным устройством.

Объект будет прослушивать уведомления о состоянии приложения и автоматически отключится от устройства, когда приложение перейдет в фоновый режим, и попытается повторно подключиться к устройству, когда приложение вернется на передний план.

Parameters

device	The device to control.
clientPackageName	The client package name.

- (instancetype) initWithDevice:	( GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName
ignoreAppStateNotifications:	(BOOL)	ignoreAppStateNotifications

Назначенный инициализатор.

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

Если ignoreAppStateNotifications имеет значение NO , объект будет прослушивать изменения состояния приложения и автоматически отключится от устройства, когда приложение переходит в фоновый режим, и попытается повторно подключиться к устройству, когда приложение вернется на передний план.

Если ignoreAppStateNotifications имеет значение YES , объект не будет прослушивать эти уведомления, и приложение будет нести ответственность за управление жизненным циклом подключения. Обратите внимание, что, как правило, фоновое приложение iOS не может продолжать работу бесконечно, и его активные сетевые подключения в конечном итоге будут закрыты операционной системой.

Parameters

device	The device to control.
clientPackageName	The client package name.
ignoreAppStateNotifications	Whether this object will ignore app state notifications.

- (void) connect

Подключается к устройству.

- (void) disconnect

Отключается от устройства.

Это явный разрыв.

Один из методов отключения должен быть вызван в какой-то момент после вызова connect и до того, как этот объект будет освобожден его владельцем.

- (void) disconnectWithLeave: (BOOL) leaveApplication

Отключается от устройства.

Один из методов отключения должен быть вызван в какой-то момент после вызова connect и до того, как этот объект будет освобожден его владельцем.

Parameters

leaveApplication YES if this is an explicit disconnect that should disconnect from ("leave") the receiver application before closing the connection; NO if this is an implicit disconnect that should just close the connection.

- (BOOL) addChannel: ( GCKCastChannel *) channel

Добавляет канал, который может отправлять и получать сообщения для этого устройства в определенном пространстве имен.

Parameters

channel The channel.

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

- (BOOL) removeChannel: ( GCKCastChannel *) channel

Удаляет ранее добавленный канал.

Parameters

channel The channel.

Возврат: YES если канал был удален, NO , если он не был удален, поскольку данный канал ранее не был подключен.

- (NSInteger) launchApplication: (NSString *) applicationID

Запускает приложение.

Parameters

applicationID The application ID.

Возврат: Идентификатор запроса или kGCKInvalidRequestID , если запрос не удалось отправить.

- (NSInteger) launchApplication:	(NSString *)	applicationID
withLaunchOptions:	( GCKLaunchOptions *__nullable)	launchOptions

Запускает приложение, используя заданные параметры запуска.

Parameters

applicationID	The application ID.
launchOptions	The launch options for this request. If `nil` , defaults will be used.

Возврат: Идентификатор запроса или kGCKInvalidRequestID , если запрос не удалось отправить.

- (NSInteger) launchApplication:	(NSString *)	applicationID
relaunchIfRunning:	(BOOL)	relaunchIfRunning

Запускает приложение, при необходимости перезапуская его, если оно уже запущено.

Deprecated:: Вместо этого используйте launchApplication:withLaunchOptions:

Parameters

applicationID	The application ID.
relaunchIfRunning	If `YES` , relaunches the application if it is already running instead of joining the running application.

Возврат: Идентификатор запроса или kGCKInvalidRequestID , если запрос не удалось отправить.

- (NSInteger) joinApplication: (NSString *__nullable) applicationID

Присоединяется к приложению.

Parameters

applicationID The application ID. If nil , attempts to join whichever application is currently running; otherwise, attempts to join the specified application.

Возврат: Идентификатор запроса или kGCKInvalidRequestID , если запрос не удалось отправить.

- (NSInteger) joinApplication:	(NSString *)	applicationID
sessionID:	(NSString *)	sessionID

Присоединяется к приложению с определенным идентификатором сеанса приложения.

Запрос завершится неудачей, если данный идентификатор сеанса больше не активен на получателе.

Parameters

applicationID	The application ID.
sessionID	The application session ID.

Возврат: Идентификатор запроса или kGCKInvalidRequestID , если запрос не удалось отправить.

- (BOOL) leaveApplication

Выход из текущего приложения.

Возврат: NO если сообщение не удалось отправить.

- (NSInteger) stopApplication

Останавливает все запущенные приложения.

Возврат: Идентификатор запроса или kGCKInvalidRequestID , если запрос не удалось отправить.

- (NSInteger) stopApplicationWithSessionID: (NSString *__nullable) sessionID

Останавливает приложение с заданным идентификатором сеанса приложения.

Запрос завершится неудачей, если данный идентификатор сеанса больше не активен на получателе.

Parameters

sessionID The application session ID, which may not be nil .

Возврат: Идентификатор запроса или kGCKInvalidRequestID , если запрос не удалось отправить.

- (NSInteger) setVolume: (float) volume

Устанавливает громкость системы.

Parameters

volume The new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.

Возврат: Идентификатор запроса или kGCKInvalidRequestID , если запрос не удалось отправить.

- (NSInteger) setMuted: (BOOL) muted

Включает или выключает звук.

Parameters

muted Whether audio should be muted or unmuted.

Возврат: Идентификатор запроса или kGCKInvalidRequestID , если запрос не удалось отправить.

- (NSInteger) requestDeviceStatus

Запрашивает текущий статус устройства.

Это приведет к тому, что все обратные вызовы обновления статуса делегата будут вызваны после получения обновленной информации о статусе.

Возврат: Идентификатор запроса или kGCKInvalidRequestID , если запрос не удалось отправить.

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

- (BOOL) ignoreAppStateNotifications

read nonatomic assign

Будет ли этот объект прослушивать уведомления о состоянии приложения.

Этот флаг может быть указан в инициализаторе. Значение по умолчанию — NO .

- ( GCKConnectionState ) connectionState

read nonatomic assign

Текущее состояние подключения диспетчера устройств.

- ( GCKConnectionState ) applicationConnectionState

read nonatomic assign

Текущее состояние подключения приложения диспетчера устройств.

- (BOOL) isConnected

read nonatomic assign

True, если диспетчер устройств установил соединение с устройством.

Deprecated:: Используйте connectionState .

- (BOOL) isConnectedToApp

read nonatomic assign

True, если диспетчер устройств установил соединение с приложением на устройстве.

Deprecated:: Используйте applicationConnectionState .

- (BOOL) isReconnecting

read nonatomic assign

Значение true, если диспетчер устройств отключен из-за потенциально временного события (например, приложение работает в фоновом режиме или произошла сетевая ошибка, которую можно устранить путем повторного подключения).

Обратите внимание, что обратные вызовы отключения/подключения не будут вызываться, когда диспетчер устройств пытается повторно подключиться после потенциально временного события, но свойства всегда будут отражать фактическое текущее состояние и их можно наблюдать.

- (NSTimeInterval) reconnectTimeout

read write nonatomic assign

В течение этого времени будет предпринята попытка повторного подключения в случае отключения сокета из-за потенциально временной ошибки.

Тайм-аут по умолчанию составляет 15 секунд.

- ( GCKDevice *) device

read nonatomic assign

Устройство, которым управляет этот GCKDeviceManager .

- (id< GCKDeviceManagerDelegate >) delegate

read write nonatomic weak

Делегат для получения уведомлений от GCKDeviceManager .

- (float) deviceVolume

read nonatomic assign

Текущая громкость устройства в диапазоне [0,0, 1,0], если известна; иначе 0.

- (BOOL) deviceMuted

read nonatomic assign

Текущее состояние отключения звука устройства, если оно известно; в противном случае NO .

- ( GCKActiveInputStatus ) activeInputStatus

read nonatomic assign

Текущий статус «активного входа» устройства.

- ( GCKStandbyStatus ) standbyStatus

read nonatomic assign

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

- (NSString*) applicationSessionID

read nonatomic copy

Идентификатор сеанса приложения для подключенного в данный момент приложения-приемника, если таковой имеется; в противном случае nil .

Новый уникальный идентификатор сеанса генерируется при каждом запуске приложения-получателя (в том числе при перезапуске того же приложения) и остается в силе до тех пор, пока приложение-получатель продолжает работать.

- ( GCKApplicationMetadata *) applicationMetadata

read nonatomic copy

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

- (NSString*) applicationStatusText

read nonatomic copy

Последний полученный текст статуса из работающего в данный момент приложения-приемника, если таковой имеется; в противном случае nil .

Класс GCKDeviceManager

Обзор

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

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

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

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