Обзор

Контроллер для устройств 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
	Истинно, если диспетчер устройств установил соединение с устройством. Более...

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

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

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

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

- (BOOL) isConnectedToApp

read nonatomic assign

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

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

Обзор

Резюме метода экземпляра

Сводка свойств

Сведения о методе

Сведения о собственности