Обзор
Подкласс 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 по этому каналу больше невозможен.
Реализация по умолчанию неактивна.
Детали недвижимости
|
read nonatomic strong |
Статус носителя для загруженного в данный момент носителя, если таковой имеется; в противном случае nil
.
|
read nonatomic assign |
Время, прошедшее с момента получения последнего обновления статуса носителя.
Если в данный момент выполняется запрос статуса, это значение будет равно 0.
|
read nonatomic copy |
Сведения об ошибке последнего запроса, если таковые имеются, или nil
, если последний запрос был успешным.
|
read write nonatomic weak |
Делегат для получения уведомлений об изменении состояния канала.
|
read nonatomic copy inherited |
Пространство имен канала.
|
read nonatomic assign inherited |
Флаг, указывающий, подключен ли этот канал в данный момент.
|
read nonatomic weak inherited |
Диспетчер устройств, в котором зарегистрирован этот канал, если таковой имеется.
- Deprecated:
- Если этот канал не был зарегистрирован в устаревшем классе GCKDeviceManager , это будет
nil
.