AVPlayer

Наследование

NSObject
AVPlayer
AVQueuePlayer

NSObject
AVPlayer
AVQueuePlayer

Соответствует

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

Оператор импорта

Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность

Доступный в iOS 4.0 и позже.

Вы используете AVPlayer возразите для реализации контроллеров и пользовательских интерфейсов для сингла - или воспроизведение многократного элемента. Случай многократного элемента поддерживает усовершенствованные способы поведения.

AVPlayer работы одинаково хорошо с локальными и удаленными медиа-файлами, если Вы с надлежащей информацией о готовности играть или о потребности ждать дополнительных данных перед продолжением.

Можно вывести на экран визуальное содержание элементов, играемых экземпляром AVPlayer в уровне CoreAnimation класса AVPlayerLayer; для синхронизации воспроизведения в реальном времени с другими уровнями CoreAnimation можно использовать AVSynchronizedLayer. Вы не можете использовать экземпляр AVVideoCompositionCoreAnimationTool с AVPlayer объект; для оффлайнового рендеринга Вас должен вместо этого использовать AVAssetExportSession.

Можно наблюдать состояние проигрывателя с помощью наблюдения значения ключа. Так, чтобы можно было добавить и удалить наблюдателей безопасно, AVPlayer сериализирует уведомления об изменениях, происходящих динамично во время воспроизведения на очереди отгрузки. По умолчанию эта очередь является основной очередью (см. dispatch_get_main_queue). Для обеспечения безопасного доступа к неатомарным свойствам проигрывателя, в то время как о динамических изменениях в состоянии воспроизведения можно сообщить необходимо сериализировать доступ с очередью уведомления получателя. В общем падеже такая сериализация естественно достигается путем вызова AVPlayerразличные методы на основном потоке или очереди.

Внешний режим воспроизведения

Внешний режим воспроизведения - когда видеоданные отправляются во внешнее устройство, такое как Apple TV через AirPlay, и мини-коннектор базировал адаптеры HDMI/VGA для полноэкранного воспроизведения в его исходной точности. Воспроизведение видео AirPlay также считают как «внешнее воспроизведение» режимом.

На «внешнем экране» режим (также известный как зеркальное отражение и второй дисплей), видеоданные представляются на устройстве хоста (например, iPhone), представил видео, повторно сжат и передан внешнему устройству, и внешнее устройство распаковывает и выводит на экран видео.

Внешние свойства воспроизведения влияют на Воспроизведение видео AirPlay и являются заменой для осуждаемых свойств поддержки AirPlay.

Создание проигрывателя

init (URL:) - initWithURL:

Инициализирует новый проигрыватель для игры единственного аудиовизуального ресурса, на который ссылается данный URL.

Объявление

Swift

init!(URL URL: NSURL!)

Objective C

- (instancetype)initWithURL:(NSURL *)URL

Параметры

URL

URL, идентифицирующий аудиовизуальный ресурс.

Возвращаемое значение

Получатель, инициализированный для игры аудиовизуального ресурса, указанного URL.

Обсуждение

Этот метод неявно создает AVPlayerItem объект. Можно получить использование элемента проигрывателя currentItem.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

+ playerWithURL:
currentItem
playerWithURL (_:) + playerWithURL:

Возвращает новый проигрыватель для игры единственного аудиовизуального ресурса, на который ссылается данный URL.

Объявление

Swift

class func playerWithURL(_ URL: NSURL!) -> AnyObject!

Objective C

+ (id)playerWithURL:(NSURL *)URL

Параметры

URL

URL, идентифицирующий аудиовизуальный ресурс.

Возвращаемое значение

Новый проигрыватель, инициализированный для игры аудиовизуального ресурса, указанного URL.

Обсуждение

Этот метод неявно создает AVPlayerItem объект. Можно получить использование элемента проигрывателя currentItem.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

– initWithURL:
currentItem
init (playerItem:) - initWithPlayerItem:

Инициализирует новый проигрыватель для игры данного единственного аудиовизуального элемента.

Объявление

Swift

init!(playerItem item: AVPlayerItem!)

Objective C

- (instancetype)initWithPlayerItem:(AVPlayerItem *)item

Параметры

item

Элемент проигрывателя.

Возвращаемое значение

Получатель, инициализированный для игры item.

Обсуждение

Можно использовать этот метод для игры элементов, для которых у Вас есть существующее AVAsset объект (см. initWithAsset: в AVPlayerItem).

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

+ playerWithPlayerItem:
playerWithPlayerItem (_:) + playerWithPlayerItem:

Возвращает новый проигрыватель, инициализированный для игры данного единственного аудиовизуального элемента

Объявление

Swift

class func playerWithPlayerItem(_ item: AVPlayerItem!) -> AnyObject!

Objective C

+ (id)playerWithPlayerItem:(AVPlayerItem *)item

Параметры

item

Элемент проигрывателя.

Возвращаемое значение

Новый проигрыватель, инициализированный для игры item.

Обсуждение

Можно использовать этот метод для игры элементов для который AVAsset объект был ранее создан (см. initWithAsset: в AVPlayerItem).

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

– initWithPlayerItem:

Управление воспроизведением

игра () - игра

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

Объявление

Swift

func play()

Objective C

- (void)play

Обсуждение

Это совпадает с установкой rate к 1.0.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

уровень
пауза () - пауза

Воспроизведение пауз.

Объявление

Swift

func pause()

Objective C

- (void)pause

Обсуждение

Это совпадает с установкой rate к 0.0.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

уровень
rate Свойство

Действующий курс воспроизведения.

Объявление

Swift

var rate: Float

Objective C

@property(nonatomic) float rate

Обсуждение

Значение 0.0 средние значения приостанавливают видео, в то время как значение 1.0 игра на естественном уровне текущего элемента. Уровни кроме 0.0 и 1.0 если связанный элемент проигрывателя возвращается, может использоваться YEStrue для AVPlayerItem свойства canPlaySlowForward или canPlayFastForward. Если элемент проигрывателя возвращается, поддерживаются отрицательные диапазоны значений уровня YEStrue для canPlayReverse, canPlaySlowReverse, и canPlayFastReverse свойства.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

– игра
– пауза
canPlayFastForward (Класс AVPlayerItem)
canPlaySlowForward (Класс AVPlayerItem)
canPlayReverse (Класс AVPlayerItem)
canPlaySlowReverse (Класс AVPlayerItem)
canPlayFastReverse (Класс AVPlayerItem)
actionAtItemEnd Свойство

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

Объявление

Swift

var actionAtItemEnd: AVPlayerActionAtItemEnd

Objective C

@property(nonatomic) AVPlayerActionAtItemEnd actionAtItemEnd

Обсуждение

Для возможных значений посмотрите AVPlayerActionAtItemEnd.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.
replaceCurrentItemWithPlayerItem (_:) - replaceCurrentItemWithPlayerItem:

Заменяет элемент проигрывателя новым элементом проигрывателя.

Объявление

Swift

func replaceCurrentItemWithPlayerItem(_ item: AVPlayerItem!)

Objective C

- (void)replaceCurrentItemWithPlayerItem:(AVPlayerItem *)item

Параметры

item

Элемент проигрывателя.

Обсуждение

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

Замена элемента сразу происходит, элемент становится проигрывателем currentItem.

Используя replaceCurrentItemWithPlayerItem: метод для замены проигрывателя currentItem с собой ничего не делает. В iOS 4.0 и ранее, делая попытку этого повысил исключение.

Используйте наблюдение значения ключа для наблюдения currentItem свойство для изменений.

Специальные замечания

Новый элемент должен иметь того же наборщика как элемент, который он заменяет, или не имейте никакого наборщика.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.


    
    prerollAtRate (_: completionHandler:)
    - prerollAtRate:completionHandler:

Начинает загружать данные носителей в начало конвейеры носителей для воспроизведения.

Объявление

Swift

func prerollAtRate(_ rate: Float, completionHandler completionHandler: ((Bool) -> Void)!)

Objective C

- (void)prerollAtRate:(float)rate completionHandler:(void (^)(BOOL finished))completionHandler

Параметры


      rate

Скорость воспроизведения для использования при определении, сколько данных для загрузки.


      completionHandler

Блок для выполнения, когда проигрыватель заканчивает попытку загрузки. Этот блок берет содержащий единственный булев параметр YEStrue если данные были загружены или NOfalse если была проблема. Например, значение могло бы быть NOfalse если предварительный рулон был прерван изменением времени или несовместимым изменением уровня.

Обсуждение

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

Если объект проигрывателя не готов играть ( status свойство не AVPlayerStatusReadyToPlay), этот метод выдает исключение.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 6.0 и позже.

cancelPendingPrerolls () - cancelPendingPrerolls

Отмены предварительно загружение данных носителей.

Объявление

Swift

func cancelPendingPrerolls()

Objective C

- (void)cancelPendingPrerolls

Обсуждение

Этот метод отменяет любые незаконченные операции для подготовки конвейера рендеринга к текущему элементу.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 6.0 и позже.

См. также

– prerollAtRate:completionHandler:

Управление временем

currentTime () - currentTime

Возвращает текущее время текущего элемента.

Объявление

Swift

func currentTime() -> CMTime

Objective C

- (CMTime)currentTime

Возвращаемое значение

Текущее время текущего элемента.

Обсуждение

Это свойство не является заметным значением ключа; использовать addPeriodicTimeObserverForInterval:queue:usingBlock: или addBoundaryTimeObserverForTimes:queue:usingBlock: вместо этого.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

– addPeriodicTimeObserverForInterval:queue:usingBlock:
– addBoundaryTimeObserverForTimes:queue:usingBlock:
seekToTime (_:) - seekToTime:

Перемещает курсор воспроизведения в данное время.

Объявление

Swift

func seekToTime(_ time: CMTime)

Objective C

- (void)seekToTime:(CMTime)time

Параметры

time

Время, в которое можно переместить курсор воспроизведения.

Обсуждение

Время, ослепленное к, может отличаться с требуемого времени для эффективности. Поскольку видит демонстрационный точный поиск seekToTime:toleranceBefore:toleranceAfter:.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

– seekToTime:toleranceBefore:toleranceAfter:
– seekToTime:completionHandler:
seekToDate (_:) - seekToDate:

Перемещает курсор воспроизведения во время, указанное объектом даты.

Объявление

Swift

func seekToDate(_ date: NSDate!)

Objective C

- (void)seekToDate:(NSDate *)date

Параметры

date

Время, в которое можно переместить курсор воспроизведения.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 6.0 и позже.

См. также

– seekToDate:completionHandler:


    
    seekToTime (_: completionHandler:)
    - seekToTime:completionHandler:

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

Объявление

Swift

func seekToTime(_ time: CMTime, completionHandler completionHandler: ((Bool) -> Void)!)

Objective C

- (void)seekToTime:(CMTime)time completionHandler:(void (^)(BOOL finished))completionHandler

Параметры


      time

Время, в которое требуется переместить курсор воспроизведения.


      completionHandler

Блок для вызова, когда искать работа была или завершена или была прервана. Блок берет один параметр:


      finished

Указывает, завершилась ли искать работа.

Обсуждение

Используйте этот метод, чтобы искать на требуемое время для текущего элемента проигрывателя и быть уведомленными, когда завершится работа. Если искать запрос завершается, не будучи прерванным (или другим, ищут запрос или любой другой работой), обработчик завершения, который Вы обеспечиваете, выполняется с finished набор параметра к YEStrue.

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

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 5.0 и позже.

См. также

– seekToTime:
– seekToTime:toleranceBefore:toleranceAfter:completionHandler:


    
    seekToDate (_: completionHandler:)
    - seekToDate:completionHandler:

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

Объявление

Swift

func seekToDate(_ date: NSDate!, completionHandler completionHandler: ((Bool) -> Void)!)

Objective C

- (void)seekToDate:(NSDate *)date completionHandler:(void (^)(BOOL finished))completionHandler

Параметры


      date

Время, в которое можно переместить курсор воспроизведения.


      completionHandler

Блок для вызова, когда искать работа была или завершена или была прервана. Блок берет один параметр:


      finished

Указывает, завершилась ли искать работа.

Обсуждение

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 5.0 и позже.


    
    seekToTime (_: toleranceBefore:toleranceAfter:)
    - seekToTime:toleranceBefore:toleranceAfter:

Перемещает курсор воспроизведения в течение связанного требуемого времени.

Объявление

Swift

func seekToTime(_ time: CMTime, toleranceBefore toleranceBefore: CMTime, toleranceAfter toleranceAfter: CMTime)

Objective C

- (void)seekToTime:(CMTime)time toleranceBefore:(CMTime)toleranceBefore toleranceAfter:(CMTime)toleranceAfter

Параметры

`time`	Время, в которое требуется переместить курсор воспроизведения.
`toleranceBefore`	Допуск, позволенный прежде `time`.
`toleranceAfter`	Допуск, позволенный после `time`.

Обсуждение

Время, ослепленное к, будет в диапазоне [time-beforeTolerance, time+afterTolerance], и может отличаться с требуемого времени для эффективности. Если Вы передаете kCMTimeZero для обоих toleranceBefore и toleranceAfter (для запроса демонстрационного точного поиска), можно подвергнуться дополнительной задержке декодирования.

Передача kCMTimePositiveInfinity для обоих toleranceBefore и toleranceAfter совпадает с обменом сообщениями seekToTime: непосредственно.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

– seekToTime:
– seekToTime:toleranceBefore:toleranceAfter:completionHandler:


    
    seekToTime (_: toleranceBefore:toleranceAfter:completionHandler:)
    - seekToTime:toleranceBefore:toleranceAfter:completionHandler:

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

Объявление

Swift

func seekToTime(_ time: CMTime, toleranceBefore toleranceBefore: CMTime, toleranceAfter toleranceAfter: CMTime, completionHandler completionHandler: ((Bool) -> Void)!)

Objective C

- (void)seekToTime:(CMTime)time toleranceBefore:(CMTime)toleranceBefore toleranceAfter:(CMTime)toleranceAfter completionHandler:(void (^)(BOOL finished))completionHandler

Параметры


      time

Время, в которое требуется переместить курсор воспроизведения.


      toleranceBefore

Допуск, позволенный прежде time.


      toleranceAfter

Допуск, позволенный после time.


      completionHandler

Блок для вызова, когда искать работа была или завершена или была прервана.

Блок берет один параметр:


      finished

Обозначенный, завершилась ли искать работа.

Обсуждение

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

Вызов этого метода с toleranceBefore набор к kCMTimePositiveInfinity и toleranceAfter набор к kCMTimePositiveInfinity совпадает с вызовом seekToTime:.

Обработчик завершения для любого предшествующего ищет запрос, который находится все еще в процессе, будет сразу вызван с finished набор параметра к NOfalse. Если новый запрос завершается, не будучи прерванным другим, ищут запрос, или любой другой работой указанный обработчик завершения будет вызван с finished набор параметра к YEStrue.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 5.0 и позже.

См. также

– seekToTime:
– seekToTime:toleranceBefore:toleranceAfter:

Управление внешним воспроизведением

allowsExternalPlayback Свойство

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

Объявление

Swift

var allowsExternalPlayback: Bool

Objective C

@property(nonatomic) BOOL allowsExternalPlayback

Обсуждение

Значение по умолчанию этого свойства YEStrue.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 6.0 и позже.
externalPlaybackActive Свойство

Булево значение, указывающее, играет ли проигрыватель в настоящее время видео во внешнем режиме воспроизведения. (только для чтения)

Объявление

Swift

var externalPlaybackActive: Bool { get }

Objective C

@property(nonatomic, readonly, getter=isExternalPlaybackActive) BOOL externalPlaybackActive

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 6.0 и позже.
usesExternalPlaybackWhileExternalScreenIsActive Свойство

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

Объявление

Swift

var usesExternalPlaybackWhileExternalScreenIsActive: Bool

Objective C

@property(nonatomic) BOOL usesExternalPlaybackWhileExternalScreenIsActive

Обсуждение

Проигрыватель автоматически переключится назад на внешний экранный режим, как только заканчивается воспроизведение видео. Краткий переход может быть видим на внешнем дисплее при автоматическом переключении между этими двумя режимами. Значение по умолчанию этого свойства NOfalse. Значение этого свойства не имеет никакого эффекта если allowsExternalPlayback NOfalse.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 6.0 и позже.
externalPlaybackVideoGravity Свойство

Видео серьезность проигрывателя для внешнего режима воспроизведения только.

Объявление

Swift

var externalPlaybackVideoGravity: String!

Objective C

@property(nonatomic, copy) NSString *externalPlaybackVideoGravity

Обсуждение

Значение этого свойства могло быть AVLayerVideoGravityResize, AVLayerVideoGravityResizeAspectFill, или AVLayerVideoGravityResizeAspect.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 6.0 и позже.

Синхронизация воспроизведения к внешнему источнику


    
    setRate (_: time:atHostTime:)
    - setRate:time:atHostTime:

Синхронизирует скорость воспроизведения и время текущего элемента с внешним источником.

Объявление

Swift

func setRate(_ rate: Float, time itemTime: CMTime, atHostTime hostClockTime: CMTime)

Objective C

- (void)setRate:(float)rate time:(CMTime)itemTime atHostTime:(CMTime)hostClockTime

Параметры

`rate`	Скорость воспроизведения для элемента.
`itemTime`	Точное время, в которое можно соответствовать воспроизведение элемента. Для использования текущего времени текущего элемента указать `kCMTimeInvalid`.
`hostClockTime`	Время узла, в которое можно синхронизировать воспроизведение. Если Вы указываете `kCMTimeInvalid`, уровень и время установлен вместе без любой внешней синхронизации.

Обсуждение

Этот метод корректирует timebase текущего элемента так, чтобы время в itemTime находится в синхронизации со временем в hostClockTime. Таким образом, если hostClockTime указывает время в прошлом, timebase элемента корректируется, чтобы заставить его появиться, как будто элемент работал на указанном уровне с тех пор itemTime. И если hostClockTime указывает время в будущем, воспроизведение корректируется назад (если возможный) так, чтобы значение в itemTime происходит в точный момент, в котором часы узла достигают значения hostClockTime. Если нет никакого содержания для игры перед временем, указанным itemTime, воспроизведение содержит, до эти два раза входит в синхронизацию.

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

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 6.0 и позже.

masterClock Свойство

Основной тактовый генератор, используемый для элемента timebases.

Объявление

Swift

var masterClock: CMClock!

Objective C

@property(nonatomic, retain) CMClockRef masterClock

Обсуждение

Значение по умолчанию этого свойства NULL, что означает, что автоматически выбран основной тактовый генератор. Когда не -NULL, это свойство переопределяет автоматический выбор основного тактового генератора для элемента timebases. Это является самым полезным при синхронизации фильмов только для видео с аудио, играемым другим источником.

Важный

При указании основного тактового генератора кроме часов надлежащего аудиоустройства аудио может сместиться из синхронизации.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 6.0 и позже.

Синхронизированные наблюдения


    
    addPeriodicTimeObserverForInterval (_: queue:usingBlock:)
    - addPeriodicTimeObserverForInterval:queue:usingBlock:

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

Объявление

Swift

func addPeriodicTimeObserverForInterval(_ interval: CMTime, queue queue: dispatch_queue_t!, usingBlock block: ((CMTime) -> Void)!) -> AnyObject!

Objective C

- (id)addPeriodicTimeObserverForInterval:(CMTime)interval queue:(dispatch_queue_t)queue usingBlock:(void (^)(CMTime time))block

Параметры


      interval

Интервал вызова блока во время нормального воспроизведения, согласно прогрессу текущего времени проигрывателя.


      queue

Последовательная очередь та, на который block должен ставиться в очередь.

Если Вы передаете NULL, основная очередь (полученное использование dispatch_get_main_queue(3) Mac OS X Developer Tools Manual Page) используется. Передача параллельной очереди приведет к неопределенному поведению.


      block

Блок, который будет периодически вызываться.

Блок берет единственный параметр:


      time

Время, в которое вызывается блок.

Возвращаемое значение

Непрозрачный объект, которому Вы передаете как параметр removeTimeObserver: отменять наблюдение.

Обсуждение

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

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

Специальные замечания

Выпуск наблюдателя возражает без вызова removeTimeObserver: приведет к неопределенному поведению.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

– addBoundaryTimeObserverForTimes:queue:usingBlock:
– removeTimeObserver:
currentTime


    
    addBoundaryTimeObserverForTimes (_: queue:usingBlock:)
    - addBoundaryTimeObserverForTimes:queue:usingBlock:

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

Объявление

Swift

func addBoundaryTimeObserverForTimes(_ times: [AnyObject]!, queue queue: dispatch_queue_t!, usingBlock block: (() -> Void)!) -> AnyObject!

Objective C

- (id)addBoundaryTimeObserverForTimes:(NSArray *)times queue:(dispatch_queue_t)queue usingBlock:(void (^)(void))block

Параметры

`times`	Массив `NSValue` объекты, содержащие `CMTime` значения, представляющие времена, в которые можно вызвать `block`.
`queue`	Последовательная очередь та, на который `block` должен ставиться в очередь. Если Вы передаете `NULL`, основная очередь (полученное использование `dispatch_get_main_queue(3) Mac OS X Developer Tools Manual Page`) используется. Передача параллельной очереди приведет к неопределенному поведению.
`block`	Блок, который будет вызван, когда любое из времен в `times` пересечен во время нормального воспроизведения.

Возвращаемое значение

Непрозрачный объект, которому Вы передаете как параметр removeTimeObserver: остановить наблюдение.

Обсуждение

Специальные замечания

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

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

– addPeriodicTimeObserverForInterval:queue:usingBlock:
– removeTimeObserver:
currentTime


    
    removeTimeObserver (_:)
    - removeTimeObserver:

Отменяет ранее зарегистрированного наблюдателя времени.

Объявление

Swift

func removeTimeObserver(_ observer: AnyObject!)

Objective C

- (void)removeTimeObserver:(id)observer

Параметры


      observer

Объект, возвращенный предыдущим вызовом к addPeriodicTimeObserverForInterval:queue:usingBlock: или addBoundaryTimeObserverForTimes:queue:usingBlock:.

Обсуждение

По возврату вызывающей стороне не гарантируют того нового наблюдателя времени, которого блоки начнут выполнять. В зависимости от вызывающего потока и очереди, используемой для добавления наблюдателя времени, блок в полете может продолжать выполняться после этого метода возвраты. Можно гарантировать синхронное удаление наблюдателя времени путем постановки в очередь вызова к removeTimeObserver на той очереди. Также вызовите dispatch_sync(queue, ^{}) после removeTimeObserver ожидать любых блоков в полете, чтобы закончить выполняться.

Необходимо использовать этот метод для явной отмены каждый раз, когда наблюдатель добавил использование addPeriodicTimeObserverForInterval:queue:usingBlock: и addBoundaryTimeObserverForTimes:queue:usingBlock:.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

Управление дисплеем субтитров

closedCaptionDisplayEnabled Свойство

Указывает, закрыло ли использование проигрывателя ввод субтитров.

Объявление

Swift

var closedCaptionDisplayEnabled: Bool

Objective C

@property(nonatomic, getter=isClosedCaptionDisplayEnabled) BOOL closedCaptionDisplayEnabled

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

Управление аудиовыходом

muted Свойство

Указывает, отключен ли аудиовыход проигрывателя звук.

Объявление

Swift

var muted: Bool

Objective C

@property(nonatomic, getter=isMuted) BOOL muted

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 7.0 и позже.
volume Свойство

Объем воспроизведения аудио для проигрывателя, в пределах от 0.0 через 1.0 в линейной шкале.

Объявление

Swift

var volume: Float

Objective C

@property(nonatomic) float volume

Обсуждение

Значение 0.0 указывает тишину; значение 1.0 (значение по умолчанию), указывает полную громкость для экземпляра проигрывателя.

Используйте это свойство для управления громкостью проигрывателя относительно другого аудиовыхода.

Для обеспечения UI в iOS для корректировки системного объема воспроизведения аудио используйте MPVolumeView класс, обеспечивающий управление воспроизведением носителей, которое ожидают пользователи iOS и чье появление можно настроить.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 7.0 и позже.

Свойства проигрывателя

status Свойство

Указывает, может ли проигрыватель использоваться для воспроизведения. (только для чтения)

Объявление

Swift

var status: AVPlayerStatus { get }

Objective C

@property(nonatomic, readonly) AVPlayerStatus status

Обсуждение

Когда значение этого свойства AVPlayerStatusFailed, Вы больше не можете использовать проигрыватель для воспроизведения, и необходимо создать новый экземпляр для замены его. Если это происходит, можно проверить значение ошибочного свойства для определения природы отказа.

Это свойство является значением ключа заметное наблюдение Значения ключа использования.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

ошибка
error Свойство

Если состояние получателя AVPlayerStatusFailed, это описывает ошибку, вызвавшую отказ. (только для чтения)

Объявление

Swift

var error: NSError! { get }

Objective C

@property(nonatomic, readonly) NSError *error

Обсуждение

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

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

См. также

состояние
currentItem Свойство

Текущий элемент проигрывателя. (только для чтения)

Объявление

Swift

var currentItem: AVPlayerItem! { get }

Objective C

@property(nonatomic, readonly) AVPlayerItem *currentItem

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.
outputObscuredDueToInsufficientExternalProtection Свойство

Булево значение, указывающее, затеняется ли выведенный из-за недостаточной внешней защиты. (только для чтения)

Объявление

Swift

var outputObscuredDueToInsufficientExternalProtection: Bool { get }

Objective C

@property(nonatomic, readonly) BOOL outputObscuredDueToInsufficientExternalProtection

Обсуждение

Элементам, включающим защиту от копирования или другие формы безопасности, мог бы затенить их визуальное содержание объект проигрывателя, если текущая конфигурация устройства не удовлетворяет требования для защиты элемента. Это свойство сообщает, затеняет ли проигрыватель в настоящее время элемент. Если текущий элемент не требует внешней защиты или если конфигурация устройства достаточно защищает элемент, значение этого свойства установлено в NOfalse.

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

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 6.0 и позже.

Управление AirPlay

airPlayVideoActive (iOS 6.0) Свойство

Указывает, играет ли проигрыватель в настоящее время видео через AirPlay. (только для чтения)

Объявление

Objective C

@property(nonatomic, readonly, getter=isAirPlayVideoActive) BOOL airPlayVideoActive

Оператор импорта

Objective C

@import AVFoundation;

Доступность

Доступный в iOS 5.0 и позже.
Осуждаемый в iOS 6.0.

См. также

allowsAirPlayVideo
allowsAirPlayVideo (iOS 6.0) Свойство

Указывает, позволяет ли проигрыватель воспроизведение видео AirPlay.

Объявление

Objective C

@property(nonatomic) BOOL allowsAirPlayVideo

Обсуждение

Значение по умолчанию YEStrue.

Оператор импорта

Objective C

@import AVFoundation;

Доступность

Доступный в iOS 5.0 и позже.
Осуждаемый в iOS 6.0.

См. также

usesAirPlayVideoWhileAirPlayScreenIsActive
usesAirPlayVideoWhileAirPlayScreenIsActive (iOS 6.0) Свойство

Указывает, должен ли проигрыватель автоматически переключиться на Видео AirPlay, в то время как Экран AirPlay активен для игры видеоконтента, переключаясь назад на Экран AirPlay, как только сделано воспроизведение.

Объявление

Objective C

@property(nonatomic) BOOL usesAirPlayVideoWhileAirPlayScreenIsActive

Обсуждение

Значение по умолчанию NOfalse.

Это свойство не имеет никакого эффекта если allowsAirPlayVideo NOfalse.

Оператор импорта

Objective C

@import AVFoundation;

Доступность

Доступный в iOS 5.0 и позже.
Осуждаемый в iOS 6.0.

См. также

allowsAirPlayVideo

Настройки критериев выбора носителей

appliesMediaSelectionCriteriaAutomatically Свойство

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

Объявление

Swift

var appliesMediaSelectionCriteriaAutomatically: Bool

Objective C

@property(nonatomic) BOOL appliesMediaSelectionCriteriaAutomatically

Обсуждение

По умолчанию, AVPlayer экземпляр применяет критерии выбора на основе установок системы. Для переопределения критериев по умолчанию любой группы выбора носителей использовать setMediaSelectionCriteria:forMediaCharacteristic:.

Примечание:

Для клиентов, соединенных против iOS 7.0 или позже или против OS X 10.9 или позже, значение по умолчанию YEStrue. Для всех других значение по умолчанию NOfalse.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 7.0 и позже.

См. также

– setMediaSelectionCriteria:forMediaCharacteristic:
– mediaSelectionCriteriaForMediaCharacteristic:


    
    mediaSelectionCriteriaForMediaCharacteristic (_:)
    - mediaSelectionCriteriaForMediaCharacteristic:

Возвращает автоматические критерии выбора для носителей, который имеет указанную характеристику носителей.

Объявление

Swift

func mediaSelectionCriteriaForMediaCharacteristic(_ mediaCharacteristic: String!) -> AVPlayerMediaSelectionCriteria!

Objective C

- (AVPlayerMediaSelectionCriteria *)mediaSelectionCriteriaForMediaCharacteristic:(NSString *)mediaCharacteristic

Параметры


      mediaCharacteristic

Характеристика носителей, для которой критерии выбора должен быть возвращен. Поддерживаемые значения включают AVMediaCharacteristicAudible, AVMediaCharacteristicLegible, и AVMediaCharacteristicVisual.

Возвращаемое значение

Автоматические критерии выбора носителей для mediaCharacteristic.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 7.0 и позже.

См. также

– setMediaSelectionCriteria:forMediaCharacteristic:
appliesMediaSelectionCriteriaAutomatically


    
    setMediaSelectionCriteria (_: forMediaCharacteristic:)
    - setMediaSelectionCriteria:forMediaCharacteristic:

Применяет автоматические критерии выбора для носителей, который имеет указанную характеристику носителей.

Объявление

Swift

func setMediaSelectionCriteria(_ criteria: AVPlayerMediaSelectionCriteria!, forMediaCharacteristic mediaCharacteristic: String!)

Objective C

- (void)setMediaSelectionCriteria:(AVPlayerMediaSelectionCriteria *)criteria forMediaCharacteristic:(NSString *)mediaCharacteristic

Параметры

`criteria`	Экземпляр AVPlayerMediaSelectionCriteria, указывающего критерии выбора.
`mediaCharacteristic`	Характеристика носителей, для которой должны быть применены критерии выбора. Поддерживаемые значения включают `AVMediaCharacteristicAudible`, `AVMediaCharacteristicLegible`, и `AVMediaCharacteristicVisual`.

Обсуждение

Критериям применятся к AVPlayerItem экземпляр, когда:

Это приготовлено для игры.
Определенные выборы носителей сделаны AVPlayerItem экземпляр с помощью метода selectMediaOption:inMediaSelectionGroup: в другой группе. Автоматический выбор в одной группе может быть под влиянием определенного выбора в другой группе.
Лежа в основе изменения установок системы, например, системного языка, заголовков доступности.

Определенные выборы, сделанные AVPlayerItem экземпляр с помощью метода selectMediaOption:inMediaSelectionGroup: метод в любой группе переопределит автоматический выбор в той группе, пока элемент проигрывателя не получит a selectMediaOptionAutomaticallyInMediaSelectionGroup: сообщение.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 7.0 и позже.

См. также

– mediaSelectionCriteriaForMediaCharacteristic:
appliesMediaSelectionCriteriaAutomatically

Константы

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

Объявление

Swift

enum AVPlayerStatus : Int { case Unknown case ReadyToPlay case Failed }

Objective C

enum { AVPlayerStatusUnknown, AVPlayerStatusReadyToPlay, AVPlayerStatusFailed }; typedef NSInteger AVPlayerStatus;

Константы
- Unknown
  
  AVPlayerStatusUnknown
  
  Указывает, что состояние проигрывателя еще не известно, потому что это не попыталось загрузить новые медиаресурсы для воспроизведения.
  
  Доступный в iOS 4.0 и позже.
- ReadyToPlay
  
  AVPlayerStatusReadyToPlay
  
  Указывает, что проигрыватель готов играть AVPlayerItem экземпляры.
  
  Доступный в iOS 4.0 и позже.
- Failed
  
  AVPlayerStatusFailed
  
  Указывает, что больше не может играть проигрыватель AVPlayerItem экземпляры из-за ошибки.
  
  Ошибка описана значением проигрывателя error свойство.
  
  Доступный в iOS 4.0 и позже.
Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.
AVPlayerActionAtItemEnd
Вы используете эти константы с actionAtItemEnd для указания действия, проигрыватель должен взять, когда это заканчивает играть.

Объявление

Swift

enum AVPlayerActionAtItemEnd : Int { case Advance case Pause case None }

Objective C

enum { AVPlayerActionAtItemEndAdvance = 0, AVPlayerActionAtItemEndPause = 1, AVPlayerActionAtItemEndNone = 2, }; typedef NSInteger AVPlayerActionAtItemEnd;

Константы
- Advance
  
  AVPlayerActionAtItemEndAdvance
  
  Указывает, что проигрыватель должен совершенствоваться к следующему элементу, если существует тот.
  
  Доступный в iOS 4.1 и позже.
- Pause
  
  AVPlayerActionAtItemEndPause
  
  Указывает, что проигрыватель должен приостановить игру.
  
  Доступный в iOS 4.0 и позже.
- None
  
  AVPlayerActionAtItemEndNone
  
  Указывает, что проигрыватель ничего не должен делать.
  
  Доступный в iOS 4.0 и позже.
Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.