Обзор

Подкласс GCKCastChannel для операций управления мультимедиа.

Любые операции, которые применяются к текущему активному потоку (воспроизведение, пауза, поиск, остановка и т. д.), требуют действительного (то есть отличного от нуля) состояния мультимедиа, иначе они вернут kGCKInvalidRequestID и не отправят запрос. Статус мультимедиа запрашивается автоматически при подключении канала, включается в ответ на успешную загрузку и может быть обновлен в любое время. Статус носителя также может стать нулевым в любое время; это произойдет, например, если канал временно отключен. При использовании этого канала изменения состояния мультимедиа следует отслеживать с помощью обратного вызова mediaControlChannelDidUpdateStatus: (GCKMediaControlChannelDelegate-p) , а методы, которые воздействуют на потоки, следует вызывать только тогда, когда статус мультимедиа не равен нулю.

Если запрос успешно запущен, соответствующий метод возвращает идентификатор запроса, который был назначен этому запросу. Если запрос не запускается, метод возвращает kGCKInvalidRequestID и устанавливает свойство lastError , чтобы указать причину сбоя. Если запрос успешно запущен, но в конечном итоге завершается сбоем, будет вызван обратный вызов mediaControlChannel:requestDidFailWithID:error: (GCKMediaControlChannelDelegate-p) , чтобы указать на сбой.

См. GCKMediaControlChannelDelegate для протокола делегата.

Deprecated:: Используйте свойство GCKRemoteMediaClient GCKCastSession для управления воспроизведением мультимедиа.

Наследует GCKCastChannel .

Резюме метода экземпляра
(instancetype)	- init
	Назначенный инициализатор. Более...

(NSInteger)	- loadMedia:
	Загружает и запускает воспроизведение нового элемента мультимедиа. Более...

(NSInteger)	- loadMedia:autoplay:
	Загружает и при необходимости запускает воспроизведение нового элемента мультимедиа. Более...

(NSInteger)	- loadMedia:autoplay:playPosition:
	Загружает и при необходимости запускает воспроизведение нового элемента мультимедиа. Более...

(NSInteger)	- loadMedia:autoplay:playPosition:customData:
	Загружает и при необходимости запускает воспроизведение нового элемента мультимедиа. Более...

(NSInteger)	- loadMedia:autoplay:playPosition:activeTrackIDs:
	Загружает и при необходимости запускает воспроизведение нового элемента мультимедиа. Более...

(NSInteger)	- loadMedia:autoplay:playPosition:activeTrackIDs:customData:
	Загружает и при необходимости запускает воспроизведение нового элемента мультимедиа. Более...

(NSInteger)	- setActiveTrackIDs:
	Устанавливает активные дорожки. Более...

(NSInteger)	- setTextTrackStyle:
	Устанавливает стиль текстовой дорожки. Более...

(NSInteger)	- pause
	Приостанавливает воспроизведение текущего элемента мультимедиа. Более...

(NSInteger)	- pauseWithCustomData:
	Приостанавливает воспроизведение текущего элемента мультимедиа. Более...

(NSInteger)	- stop
	Останавливает воспроизведение текущего элемента мультимедиа. Более...

(NSInteger)	- stopWithCustomData:
	Останавливает воспроизведение текущего элемента мультимедиа. Более...

(NSInteger)	- play
	Начинает (или возобновляет) воспроизведение текущего элемента мультимедиа. Более...

(NSInteger)	- playWithCustomData:
	Начинает (или возобновляет) воспроизведение текущего элемента мультимедиа. Более...

(NSInteger)	- seekToTimeInterval:
	Переход на новую позицию в текущем элементе мультимедиа. Более...

(NSInteger)	- seekToTimeInterval:resumeState:
	Переход на новую позицию в текущем элементе мультимедиа. Более...

(NSInteger)	- seekToTimeInterval:resumeState:customData:
	Переход на новую позицию в текущем элементе мультимедиа. Более...

(NSInteger)	- queueLoadItems:startIndex:repeatMode:
	Загружает и при необходимости запускает воспроизведение новой очереди элементов мультимедиа. Более...

(NSInteger)	- queueLoadItems:startIndex:repeatMode:customData:
	Загружает и при необходимости запускает воспроизведение новой очереди элементов мультимедиа. Более...

(NSInteger)	- queueLoadItems:startIndex:playPosition:repeatMode:customData:
	Загружает и при необходимости запускает воспроизведение новой очереди элементов мультимедиа. Более...

(NSInteger)	- queueInsertItems:beforeItemWithID:
	Вставляет список новых элементов мультимедиа в очередь. Более...

(NSInteger)	- queueInsertItems:beforeItemWithID:customData:
	Вставляет список новых элементов мультимедиа в очередь. Более...

(NSInteger)	- queueInsertItem:beforeItemWithID:
	Удобный метод, который вставляет один элемент в очередь. Более...

(NSInteger)	- queueInsertAndPlayItem:beforeItemWithID:
	Удобный метод, который вставляет один элемент в очередь и делает его текущим элементом. Более...

(NSInteger)	- queueInsertAndPlayItem:beforeItemWithID:playPosition:customData:
	Удобный метод, который вставляет один элемент в очередь и делает его текущим элементом. Более...

(NSInteger)	- queueUpdateItems:
	Обновляет очередь. Более...

(NSInteger)	- queueUpdateItems:customData:
	Обновляет очередь. Более...

(NSInteger)	- queueRemoveItemsWithIDs:
	Удаляет список элементов мультимедиа из очереди. Более...

(NSInteger)	- queueRemoveItemsWithIDs:customData:
	Удаляет список элементов мультимедиа из очереди. Более...

(NSInteger)	- queueRemoveItemWithID:
	Удобный метод, который удаляет один элемент из очереди. Более...

(NSInteger)	- queueReorderItemsWithIDs:insertBeforeItemWithID:
	Переупорядочивает список элементов мультимедиа в очереди. Более...

(NSInteger)	- queueReorderItemsWithIDs:insertBeforeItemWithID:customData:
	Переупорядочить список элементов мультимедиа в очереди. Более...

(NSInteger)	- queueMoveItemWithID:beforeItemWithID:
	Удобный метод, который перемещает один элемент в очереди. Более...

(NSInteger)	- queueJumpToItemWithID:
	Переходит к элементу с указанным идентификатором в очереди. Более...

(NSInteger)	- queueJumpToItemWithID:customData:
	Переходит к элементу с указанным идентификатором в очереди. Более...

(NSInteger)	- queueJumpToItemWithID:playPosition:customData:
	Переходит к элементу с указанным идентификатором в очереди. Более...

(NSInteger)	- queueNextItem
	Переходит к следующему элементу в очереди. Более...

(NSInteger)	- queuePreviousItem
	Переход к предыдущему элементу в очереди. Более...

(NSInteger)	- queueSetRepeatMode:
	Устанавливает режим повторения очереди. Более...

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

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

(NSInteger)	- setStreamMuted:
	Устанавливает, отключен ли поток. Более...

(NSInteger)	- setStreamMuted:customData:
	Устанавливает, отключен ли поток. Более...

(NSInteger)	- requestStatus
	Запрашивает обновленную информацию о состоянии мультимедиа у получателя. Более...

(NSTimeInterval)	- approximateStreamPosition
	Возвращает приблизительное положение потока, рассчитанное на основе последней полученной информации о потоке и времени, прошедшем с момента обновления. Более...

(BOOL)	- cancelRequestWithID:
	Отменяет выполняемый запрос. Более...

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

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

(BOOL)	- sendTextMessage:
	Отправляет текстовое сообщение на этот канал. Более...

(BOOL)	- sendTextMessage:error:
	Отправляет текстовое сообщение на этот канал. Более...

(NSInteger)	- generateRequestID
	Создает идентификатор запроса для нового сообщения. Более...

(NSNumber *__nullable)	- generateRequestNumber
	Удобный метод, который упаковывает результат generateRequestID в NSNumber . Более...

(void)	- didConnect
	Вызывается, когда этот канал был подключен, указывая, что теперь можно обмениваться сообщениями с устройством Cast по этому каналу. Более...

(void)	- didDisconnect
	Вызывается, когда этот канал был отключен, указывая на то, что обмен сообщениями с устройством Cast по этому каналу больше невозможен. Более...

Сводка свойств
GCKMediaStatus *	mediaStatus
	Состояние носителя для загруженного в данный момент носителя, если таковой имеется; иначе `nil` . Более...

NSTimeInterval	timeSinceLastMediaStatusUpdate
	Время, прошедшее с момента получения последнего обновления статуса носителя. Более...

GCKError *	lastError
	Подробная информация об ошибке из последнего запроса, если таковая имеется, или `nil` , если последний запрос был успешным. Более...

id< GCKMediaControlChannelDelegate >	delegate
	Делегат для получения уведомлений об изменении состояния канала. Более...

NSString *	protocolNamespace
	Пространство имен канала. Более...

BOOL	isConnected
	Флаг, указывающий, подключен ли этот канал в данный момент. Более...

GCKDeviceManager *	deviceManager
	Диспетчер устройств, в котором зарегистрирован этот канал, если он есть. Более...

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

- (instancetype) init

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

Реализует GCKCastChannel .

- (NSInteger) loadMedia: ( GCKMediaInformation *) mediaInfo

Загружает и запускает воспроизведение нового элемента мультимедиа.

Parameters

mediaInfo An object describing the media item to load.

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

- (NSInteger) loadMedia:	( GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay

Загружает и при необходимости запускает воспроизведение нового элемента мультимедиа.

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.

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

- (NSInteger) loadMedia:	( GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition

Загружает и при необходимости запускает воспроизведение нового элемента мультимедиа.

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.

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

- (NSInteger) loadMedia:	( GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition
customData:	(id __nullable)	customData

Загружает и при необходимости запускает воспроизведение нового элемента мультимедиа.

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

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

- (NSInteger) loadMedia:	( GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition
activeTrackIDs:	(NSArray< NSNumber * > *__nullable)	activeTrackIDs

Загружает и при необходимости запускает воспроизведение нового элемента мультимедиа.

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.
activeTrackIDs	An array of integers specifying the active tracks. May be `nil` .

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

- (NSInteger) loadMedia:	( GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition
activeTrackIDs:	(NSArray< NSNumber * > *__nullable)	activeTrackIDs
customData:	(id __nullable)	customData

Загружает и при необходимости запускает воспроизведение нового элемента мультимедиа.

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.
activeTrackIDs	An array of integers specifying the active tracks. May be `nil` .
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

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

- (NSInteger) setActiveTrackIDs: (NSArray< NSNumber * > *__nullable) activeTrackIDs

Устанавливает активные дорожки.

Запрос завершится ошибкой, если текущий статус носителя отсутствует.

Parameters

activeTrackIDs An array of integers specifying the active tracks.

Возвращает: Идентификатор запроса или kGCKInvalidRequestID , если сообщение не удалось отправить. Может быть nil или пустым массивом, чтобы установить активные треки в пустой список.

- (NSInteger) setTextTrackStyle: ( GCKMediaTextTrackStyle *__nullable) textTrackStyle

Устанавливает стиль текстовой дорожки.

Запрос завершится ошибкой, если текущий статус носителя отсутствует.

Parameters

textTrackStyle The text track style. The style will not be changed if this is nil .

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

- (NSInteger) pause

Приостанавливает воспроизведение текущего элемента мультимедиа.

Запрос завершится ошибкой, если текущий статус носителя отсутствует.

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

- (NSInteger) pauseWithCustomData: (id __nullable) customData

Приостанавливает воспроизведение текущего элемента мультимедиа.

Запрос завершится ошибкой, если текущий статус носителя отсутствует.

Parameters

customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or nil .

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

- (NSInteger) stop

Останавливает воспроизведение текущего элемента мультимедиа.

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

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

- (NSInteger) stopWithCustomData: (id __nullable) customData

Останавливает воспроизведение текущего элемента мультимедиа.

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

Parameters

customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or nil .

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

- (NSInteger) play

Начинает (или возобновляет) воспроизведение текущего элемента мультимедиа.

Воспроизведение всегда начинается с начала потока. Запрос завершится ошибкой, если текущий статус носителя отсутствует.

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

- (NSInteger) playWithCustomData: (id __nullable) customData

Начинает (или возобновляет) воспроизведение текущего элемента мультимедиа.

Воспроизведение всегда начинается с начала потока. Запрос завершится ошибкой, если текущий статус носителя отсутствует.

Parameters

customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or nil .

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

- (NSInteger) seekToTimeInterval: (NSTimeInterval) position

Переход на новую позицию в текущем элементе мультимедиа.

Запрос завершится ошибкой, если текущий статус носителя отсутствует.

Parameters

position The new position from the beginning of the stream.

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

- (NSInteger) seekToTimeInterval:	(NSTimeInterval)	position
resumeState:	( GCKMediaControlChannelResumeState )	resumeState

Переход на новую позицию в текущем элементе мультимедиа.

Запрос завершится ошибкой, если текущий статус носителя отсутствует.

Parameters

position	The new position interval from the beginning of the stream.
resumeState	The action to take after the seek operation has finished.

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

- (NSInteger) seekToTimeInterval:	(NSTimeInterval)	position
resumeState:	( GCKMediaControlChannelResumeState )	resumeState
customData:	(id __nullable)	customData

Переход на новую позицию в текущем элементе мультимедиа.

Запрос завершится ошибкой, если текущий статус носителя отсутствует.

Parameters

position	The new position from the beginning of the stream.
resumeState	The action to take after the seek operation has finished.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

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

- (NSInteger) queueLoadItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
startIndex:	(NSUInteger)	startIndex
repeatMode:	( GCKMediaRepeatMode )	repeatMode

Загружает и при необходимости запускает воспроизведение новой очереди элементов мультимедиа.

Parameters

queueItems	An array of GCKMediaQueueItem instances to load. Must not be `nil` or empty.
startIndex	The index of the item in the items array that should be played first.
repeatMode	The repeat mode for playing the queue.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueLoadItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
startIndex:	(NSUInteger)	startIndex
repeatMode:	( GCKMediaRepeatMode )	repeatMode
customData:	(id __nullable)	customData

Загружает и при необходимости запускает воспроизведение новой очереди элементов мультимедиа.

Parameters

queueItems	An array of GCKMediaQueueItem instances to load. Must not be `nil` or empty.
startIndex	The index of the item in the items array that should be played first.
repeatMode	The repeat mode for playing the queue.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueLoadItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
startIndex:	(NSUInteger)	startIndex
playPosition:	(NSTimeInterval)	playPosition
repeatMode:	( GCKMediaRepeatMode )	repeatMode
customData:	(id __nullable)	customData

Загружает и при необходимости запускает воспроизведение новой очереди элементов мультимедиа.

Parameters

queueItems	An array of GCKMediaQueueItem instances to load. Must not be `nil` or empty.
startIndex	The index of the item in the items array that should be played first.
playPosition	The initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
repeatMode	The repeat mode for playing the queue.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueInsertItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
beforeItemWithID:	(NSUInteger)	beforeItemID

Вставляет список новых элементов мультимедиа в очередь.

Parameters

queueItems	An array of GCKMediaQueueItem instances to insert. Must not be `nil` or empty.
beforeItemID	The ID of the item that will be located immediately after the inserted list. If the value is kGCKMediaQueueInvalidItemID , the inserted list will be appended to the end of the queue.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueInsertItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
beforeItemWithID:	(NSUInteger)	beforeItemID
customData:	(id __nullable)	customData

Вставляет список новых элементов мультимедиа в очередь.

Parameters

queueItems	An array of GCKMediaQueueItem instances to insert. Must not be `nil` or empty.
beforeItemID	ID of the item that will be located immediately after the inserted list. If the value is kGCKMediaQueueInvalidItemID , the inserted list will be appended to the end of the queue.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueInsertItem:	( GCKMediaQueueItem *)	item
beforeItemWithID:	(NSUInteger)	beforeItemID

Удобный метод, который вставляет один элемент в очередь.

Parameters

item	The item to insert.
beforeItemID	The ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID , or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueInsertAndPlayItem:	( GCKMediaQueueItem *)	item
beforeItemWithID:	(NSUInteger)	beforeItemID

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

Parameters

item	The item to insert.
beforeItemID	The ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID , or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueInsertAndPlayItem:	( GCKMediaQueueItem *)	item
beforeItemWithID:	(NSUInteger)	beforeItemID
playPosition:	(NSTimeInterval)	playPosition
customData:	(id __nullable)	customData

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

Parameters

item	The item to insert.
beforeItemID	The ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID , or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.
playPosition	The initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *) queueItems

Обновляет очередь.

Parameters

queueItems The list of updated items.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueUpdateItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
customData:	(id __nullable)	customData

Обновляет очередь.

Parameters

queueItems	The list of updated items.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *) itemIDs

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

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

Parameters

itemIDs An array of media item IDs identifying the items to remove. Must not be nil or empty.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueRemoveItemsWithIDs:	(NSArray< NSNumber * > *)	itemIDs
customData:	(id __nullable)	customData

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

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

Parameters

itemIDs	An array of media item IDs identifying the items to remove. Must not be `nil` or empty.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueRemoveItemWithID: (NSUInteger) itemID

Удобный метод, который удаляет один элемент из очереди.

Parameters

itemID The ID of the item to remove.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueReorderItemsWithIDs:	(NSArray< NSNumber * > *)	queueItemIDs
insertBeforeItemWithID:	(NSUInteger)	beforeItemID

Переупорядочивает список элементов мультимедиа в очереди.

Parameters

queueItemIDs	An array of media item IDs identifying the items to reorder. Must not be `nil` or empty.
beforeItemID	ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID , or does not refer to any item currently in the queue, the reordered list will be appended at the end of the queue.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueReorderItemsWithIDs:	(NSArray< NSNumber * > *)	queueItemIDs
insertBeforeItemWithID:	(NSUInteger)	beforeItemID
customData:	(id __nullable)	customData

Переупорядочить список элементов мультимедиа в очереди.

Parameters

queueItemIDs	An array of media item IDs identifying the items to reorder. Must not be `nil` or empty.
beforeItemID	The ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID , or does not refer to any item currently in the queue, the reordered list will be moved to the end of the queue.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueMoveItemWithID:	(NSUInteger)	itemID
beforeItemWithID:	(NSUInteger)	beforeItemID

Удобный метод, который перемещает один элемент в очереди.

Parameters

itemID	The ID of the item to move.
beforeItemID	The ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID , or does not refer to any item currently in the queue, the item will be moved to the end of the queue.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) queueJumpToItemWithID: (NSUInteger) itemID

Переходит к элементу с указанным идентификатором в очереди.

Parameters

itemID The ID of the item to jump to.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено.

- (NSInteger) queueJumpToItemWithID:	(NSUInteger)	itemID
customData:	(id __nullable)	customData

Переходит к элементу с указанным идентификатором в очереди.

Parameters

itemID	The ID of the item to jump to.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено.

- (NSInteger) queueJumpToItemWithID:	(NSUInteger)	itemID
playPosition:	(NSTimeInterval)	playPosition
customData:	(id __nullable)	customData

Переходит к элементу с указанным идентификатором в очереди.

Parameters

itemID	The ID of the item to jump to.
playPosition	The initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено.

- (NSInteger) queueNextItem

Переходит к следующему элементу в очереди.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено.

- (NSInteger) queuePreviousItem

Переход к предыдущему элементу в очереди.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено.

- (NSInteger) queueSetRepeatMode: ( GCKMediaRepeatMode ) repeatMode

Устанавливает режим повторения очереди.

Parameters

repeatMode The new repeat mode.

Возвращает: Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не может быть отправлено или если какой-либо из параметров недействителен.

- (NSInteger) setStreamVolume: (float) volume

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

Запрос завершится ошибкой, если текущий медиа-сеанс отсутствует.

Parameters

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

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

- (NSInteger) setStreamVolume:	(float)	volume
customData:	(id __nullable)	customData

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

Запрос завершится ошибкой, если текущий медиа-сеанс отсутствует.

Parameters

volume	The new volume, in the range [0.0 - 1.0].
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

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

- (NSInteger) setStreamMuted: (BOOL) muted

Устанавливает, отключен ли поток.

Запрос завершится ошибкой, если текущий медиа-сеанс отсутствует.

Parameters

muted Whether the stream should be muted or unmuted.

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

- (NSInteger) setStreamMuted:	(BOOL)	muted
customData:	(id __nullable)	customData

Устанавливает, отключен ли поток.

Запрос завершится ошибкой, если текущий медиа-сеанс отсутствует.

Parameters

muted	Whether the stream should be muted or unmuted.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization , or `nil` .

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

- (NSInteger) requestStatus

Запрашивает обновленную информацию о состоянии мультимедиа у получателя.

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

- (NSTimeInterval) approximateStreamPosition

Возвращает приблизительное положение потока, рассчитанное на основе последней полученной информации о потоке и времени, прошедшем с момента обновления.

Возвращает 0, если канал не подключен или в данный момент не загружен носитель.

- (BOOL) cancelRequestWithID: (NSInteger) requestID

Отменяет выполняемый запрос.

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

Parameters

requestID The ID of the request to cancel.

Возвращает: YES , если запрос был отменен, или NO , если с данным идентификатором не отслеживается ни один запрос.

- (instancetype) initWithNamespace: (NSString *) protocolNamespace

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

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

Parameters

protocolNamespace The namespace.

Реализовано в GCKGenericChannel .

- (void) didReceiveTextMessage: (NSString *) message

Вызывается при получении текстового сообщения на этом канале.

Реализация по умолчанию не работает.

Parameters

message The message.

- (BOOL) sendTextMessage: (NSString *) message

Отправляет текстовое сообщение на этот канал.

Parameters

message The message.

Возвращает: YES в случае успеха или NO , если сообщение не может быть отправлено (поскольку канал не подключен или потому что буфер отправки в данный момент слишком заполнен).

Deprecated:: Используйте sendTextMessage:error: который предоставляет подробную информацию об ошибке.

- (BOOL) sendTextMessage:	(NSString *)	message
error:	( GCKError __nullable __nullable)	error

Отправляет текстовое сообщение на этот канал.

Parameters

message	The message.
error	A pointer at which to store the error result. May be `nil` .

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

- (NSInteger) generateRequestID

Создает идентификатор запроса для нового сообщения.

Возвращает: Сгенерированный идентификатор или kGCKInvalidRequestID , если канал в данный момент не подключен.

- (NSNumber * __nullable) generateRequestNumber

Удобный метод, который упаковывает результат generateRequestID в NSNumber .

Возвращает: Сгенерированный идентификатор или nil , если канал в данный момент не подключен.

- (void) didConnect

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

Реализация по умолчанию не работает.

- (void) didDisconnect

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

Реализация по умолчанию не работает.

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

- ( GCKMediaStatus *) mediaStatus

read nonatomic strong

Состояние носителя для загруженного в данный момент носителя, если таковой имеется; иначе nil .

- (NSTimeInterval) timeSinceLastMediaStatusUpdate

read nonatomic assign

Время, прошедшее с момента получения последнего обновления статуса носителя.

Если в данный момент выполняется запрос состояния, это будет 0.

- ( GCKError *) lastError

read nonatomic copy

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

- (id< GCKMediaControlChannelDelegate >) delegate

read write nonatomic weak

Делегат для получения уведомлений об изменении состояния канала.

- (NSString*) protocolNamespace

read nonatomic copy inherited

Пространство имен канала.

- (BOOL) isConnected

read nonatomic assign inherited

Флаг, указывающий, подключен ли этот канал в данный момент.

- ( GCKDeviceManager *) deviceManager

read nonatomic weak inherited

Диспетчер устройств, в котором зарегистрирован этот канал, если он есть.

Deprecated:: Если этот канал не был зарегистрирован в устаревшем классе GCKDeviceManager , это будет nil .

Класс GCKMediaControlChannel

Обзор

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

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

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

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