Класс GCKDeviceManager

Методы экземпляра | Характеристики

Справочник классов GCKDeviceManager

Обзор

Контроллер для устройств 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 .