Класс GCKMediaControlChannel

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

Обзор

Подкласс 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
mediaInfoAn object describing the media item to load.
Возврат
Идентификатор запроса или kGCKInvalidRequestID , если сообщение не удалось отправить.
- (NSInteger) loadMedia: ( GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay  

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

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
Возврат
Идентификатор запроса или kGCKInvalidRequestID , если сообщение не удалось отправить.
- (NSInteger) loadMedia: ( GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition  

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

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
Возврат
Идентификатор запроса или kGCKInvalidRequestID , если сообщение не удалось отправить.
- (NSInteger) loadMedia: ( GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData  

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

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
customDataCustom 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
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
activeTrackIDsAn 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
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
activeTrackIDsAn array of integers specifying the active tracks. May be nil .
customDataCustom 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
activeTrackIDsAn array of integers specifying the active tracks.
Возврат
Идентификатор запроса или kGCKInvalidRequestID , если сообщение не удалось отправить. Может быть nil или пустым массивом, чтобы активные треки были помещены в пустой список.
- (NSInteger) setTextTrackStyle: ( GCKMediaTextTrackStyle *__nullable)  textTrackStyle

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

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

Parameters
textTrackStyleThe text track style. The style will not be changed if this is nil .
Возврат
Идентификатор запроса или kGCKInvalidRequestID , если сообщение не удалось отправить.
- (NSInteger) pause

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

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

Возврат
Идентификатор запроса или kGCKInvalidRequestID , если сообщение не удалось отправить.
- (NSInteger) pauseWithCustomData: (id __nullable)  customData

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

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

Parameters
customDataCustom 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
customDataCustom 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
customDataCustom 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
positionThe new position from the beginning of the stream.
Возврат
Идентификатор запроса или kGCKInvalidRequestID , если сообщение не удалось отправить.
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position
resumeState: ( GCKMediaControlChannelResumeState resumeState  

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

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

Parameters
positionThe new position interval from the beginning of the stream.
resumeStateThe action to take after the seek operation has finished.
Возврат
Идентификатор запроса или kGCKInvalidRequestID , если сообщение не удалось отправить.
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position
resumeState: ( GCKMediaControlChannelResumeState resumeState
customData: (id __nullable)  customData  

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

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

Parameters
positionThe new position from the beginning of the stream.
resumeStateThe action to take after the seek operation has finished.
customDataCustom 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
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
repeatModeThe repeat mode for playing the queue.
Возврат
Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не удалось отправить или какой-либо из параметров недействителен.
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
repeatMode: ( GCKMediaRepeatMode repeatMode
customData: (id __nullable)  customData  

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

Parameters
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
repeatModeThe repeat mode for playing the queue.
customDataCustom 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
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
playPositionThe 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.
repeatModeThe repeat mode for playing the queue.
customDataCustom 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
queueItemsAn array of GCKMediaQueueItem instances to insert. Must not be nil or empty.
beforeItemIDThe 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
queueItemsAn array of GCKMediaQueueItem instances to insert. Must not be nil or empty.
beforeItemIDID 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.
customDataCustom 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
itemThe item to insert.
beforeItemIDThe 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
itemThe item to insert.
beforeItemIDThe 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
itemThe item to insert.
beforeItemIDThe 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.
playPositionThe 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.
customDataCustom 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
queueItemsThe list of updated items.
Возврат
Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не удалось отправить или какой-либо из параметров недействителен.
- (NSInteger) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
customData: (id __nullable)  customData  

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

Parameters
queueItemsThe list of updated items.
customDataCustom 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
itemIDsAn 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
itemIDsAn array of media item IDs identifying the items to remove. Must not be nil or empty.
customDataCustom 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
itemIDThe ID of the item to remove.
Возврат
Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не удалось отправить или какой-либо из параметров недействителен.
- (NSInteger) queueReorderItemsWithIDs: (NSArray< NSNumber * > *)  queueItemIDs
insertBeforeItemWithID: (NSUInteger)  beforeItemID  

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

Parameters
queueItemIDsAn array of media item IDs identifying the items to reorder. Must not be nil or empty.
beforeItemIDID 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
queueItemIDsAn array of media item IDs identifying the items to reorder. Must not be nil or empty.
beforeItemIDThe 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.
customDataCustom 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
itemIDThe ID of the item to move.
beforeItemIDThe 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
itemIDThe ID of the item to jump to.
Возврат
Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не удалось отправить.
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID
customData: (id __nullable)  customData  

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

Parameters
itemIDThe ID of the item to jump to.
customDataCustom 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
itemIDThe ID of the item to jump to.
playPositionThe 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.
customDataCustom 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
repeatModeThe new repeat mode.
Возврат
Идентификатор запроса для этого запроса или kGCKInvalidRequestID , если сообщение не удалось отправить или какой-либо из параметров недействителен.
- (NSInteger) setStreamVolume: (float)  volume

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

Запрос не будет выполнен, если текущий сеанс мультимедиа отсутствует.

Parameters
volumeThe new volume, in the range [0.0 - 1.0].
Возврат
Идентификатор запроса или kGCKInvalidRequestID , если сообщение не удалось отправить.
- (NSInteger) setStreamVolume: (float)  volume
customData: (id __nullable)  customData  

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

Запрос не будет выполнен, если текущий сеанс мультимедиа отсутствует.

Parameters
volumeThe new volume, in the range [0.0 - 1.0].
customDataCustom 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
mutedWhether the stream should be muted or unmuted.
Возврат
Идентификатор запроса или kGCKInvalidRequestID , если сообщение не удалось отправить.
- (NSInteger) setStreamMuted: (BOOL)  muted
customData: (id __nullable)  customData  

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

Запрос не будет выполнен, если текущий сеанс мультимедиа отсутствует.

Parameters
mutedWhether the stream should be muted or unmuted.
customDataCustom 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
requestIDThe ID of the request to cancel.
Возврат
YES если запрос был отменен, или NO , если запрос с данным идентификатором не отслеживается.
- (instancetype) initWithNamespace: (NSString *)  protocolNamespace

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

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

Parameters
protocolNamespaceThe namespace.

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

- (void) didReceiveTextMessage: (NSString *)  message

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

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

Parameters
messageThe message.
- (BOOL) sendTextMessage: (NSString *)  message

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

Parameters
messageThe message.
Возврат
YES в случае успеха или NO , если сообщение не удалось отправить (потому что канал не подключен или буфер отправки в данный момент слишком полон).
Deprecated:
Используйте sendTextMessage:error: который предоставляет подробную информацию об ошибке.
- (BOOL) sendTextMessage: (NSString *)  message
error: ( GCKError *__nullable *__nullable)  error  

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

Parameters
messageThe message.
errorA 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 .