Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы MediaPlayer ссылка класса MPMoviePlayerController

Опции
Развертывание Target:

На этой странице
Язык:

MPMoviePlayerController

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

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

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

Swift

import MediaPlayer

Objective C

@import MediaPlayer;

Доступность

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

Проигрыватель фильмов (типа MPMoviePlayerController) управляет воспроизведением фильма от файла или сетевого потока. Воспроизведение происходит в представлении, принадлежавшем проигрывателю фильмов, и имеет место или полноэкранное или встроенное. Можно включить представление проигрывателя фильмов в иерархию представления, принадлежавшую приложению, или использовать MPMoviePlayerViewController объект управлять представлением для Вас.

Проигрыватели фильмов (iOS 4.3 и позже) поддерживают беспроводное воспроизведение фильма к Поддерживающим трансляцию аппаратным средствам, таким как Apple TV.. Запускаясь в iOS 5.0, воспроизведение AirPlay включено по умолчанию. Для отключения AirPlay в приложении установите allowsAirPlay свойство к NOfalse. В iOS 8.0 и позже, пользовательский доступ AirPlay совместимые аппаратные средства через Панель управления, никакое управление AirPlay не выведено на экран проигрывателем фильмов.

Когда Вы добавляете представление проигрывателя фильмов к иерархии представления своего приложения, убедиться измерить кадр правильно, как показано здесь:

  • MPMoviePlayerController *player =
  • [[MPMoviePlayerController alloc] initWithContentURL: myURL];
  • [player prepareToPlay];
  • [player.view setFrame: myView.bounds]; // player's frame must match parent's
  • [myView addSubview: player.view];
  • // ...
  • [player play];

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

В дополнение к разделению на уровни содержания поверх фильма можно обеспечить пользовательское фоновое содержание путем добавления подпредставлений к представлению в backgroundView свойство. Пользовательские подпредставления поддерживаются и во встроенных и в полноэкранных режимах воспроизведения, но необходимо скорректировать позиции представлений при вводе или выходе из полноэкранного режима. Используйте MPMoviePlayerWillEnterFullscreenNotification и MPMoviePlayerWillExitFullscreenNotification уведомления для обнаружения изменений в и от полноэкранного режима.

Этот класс поддерживает программируемое управление воспроизведения фильма и основанное на пользователе управление через кнопки, предоставленные проигрывателем фильмов. Можно управлять большинством аспектов воспроизведения программно с помощью методов и свойств MPMediaPlayback протокол, которому этот класс соответствует. Методы и свойства того протокола позволяют Вам запустить и остановить воспроизведение, искать вперед и назад через содержание фильма, и даже изменить скорость воспроизведения. Кроме того, controlStyle свойство этого класса позволяет Вам вывести на экран ряд стандартных системных средств управления, позволяющих пользователю управлять воспроизведением. Можно также установить shouldAutoplay свойство для основанного на сети содержания для запуска автоматически.

Вы обычно указываете фильм, который Вы хотите проигрывать при создании нового MPMoviePlayerController объект. Однако можно также изменить в настоящее время проигрывающий фильм путем изменения значения в contentURL свойство. Изменение этого свойства позволяет Вам снова использовать тот же объект контроллера проигрывателя фильмов в многократных местах. Поскольку производительность обосновывает, что можно хотеть проигрывать фильмы как локальные файлы. Сделайте это первой загрузкой их к локальному каталогу.

Упростить создание видео закладок или ссылок на главы для длинного фильма, MPMoviePlayerController класс определяет методы для генерации изображений миниатюр в определенные времена в фильме. Можно запросить единственное изображение миниатюр с помощью thumbnailImageAtTime:timeOption: метод или запрашивает многократные изображения миниатюр с помощью requestThumbnailImagesAtTimes:timeOption: метод.

Для игры сетевой поток, URL которого требует учетных данных доступа, сначала создайте надлежащее NSURLCredential объект. Сделайте это путем вызова, например, initWithUser:password:persistence: метод, как показано здесь:

  • NSURLCredential *credential = [[NSURLCredential alloc]
  • initWithUser: @"userName"
  • password: @"password"
  • persistence: NSURLCredentialPersistenceForSession];
  • self.credential = credential;
  • [credential release];

Кроме того, создайте надлежащее NSURLProtectionSpace объект, как показано здесь. Сделайте надлежащие модификации для области, к которой Вы получаете доступ:

  • NSURLProtectionSpace *protectionSpace = [[NSURLProtectionSpace alloc]
  • initWithHost: "@streams.mydomain.com"
  • port: 80
  • protocol: @"http"
  • realm: @"mydomain.com"
  • authenticationMethod: NSURLAuthenticationMethodDefault];
  • self.protectionSpace = protectionSpace;
  • [protectionSpace release];

Добавьте учетные данные URL и пространство защиты к Singleton NSURLCredentialStorage объект. Сделайте это путем вызова, например, setCredential:forProtectionSpace: метод, как показано здесь:

  • [[NSURLCredentialStorage sharedCredentialStorage]
  • setDefaultCredential: credential
  • forProtectionSpace: protectionSpace];

С учетными данными и информацией пространства защиты на месте, можно тогда играть защищенный поток.

Уведомления проигрывателя фильмов

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

  • Когда проигрыватель фильмов начинает играть, приостанавливается или начинает искать вперед или назад

  • Когда воспроизведение AirPlay запускается или заканчивается

  • Когда масштабирующийся режим изменений фильма

  • Когда фильм вводит или выходит из полноэкранного режима

  • Когда загрузка утверждает для основанных на сети изменений фильмов

  • Когда метаинформация о самом фильме становится доступной

Для получения дополнительной информации посмотрите раздел Notifications в этом документе.

Поддерживаемые форматы

Этот класс играет любой файл ролика или аудиофайл, поддерживаемый в iOS. Это включает и переданный потоком довольный и файлы фиксированной длины. Для файлов ролика это обычно означает файлы с расширениями .mov, .mp4, .mpv, и .3gp и использование одного из следующих стандартов сжатия:

  • Базовое видео Уровня 3.0 Профиля H.264, до 640 x 480 в 30 кадр/с. (Базовый профиль не поддерживает кадры B.)

  • Видео части 2 MPEG 4 (Простой Профиль)

В то время как аудио играет, при использовании этого класса для игры аудиофайлов, он выводит на экран белый экран с логотипом QuickTime. Для аудиофайлов этот класс поддерживает аудио AAC-LC максимум в 48 кГц и MP3 (Уровень 3 Аудио MPEG 1) до 48 кГц, аудио стерео.

Поведение в iOS 4.3 и Ранее

В iOS 4.3 и ранее, новый проигрыватель фильмов был автоматически подготовлен играть. Запускаясь в iOS 5.0, для упрощения управления воспроизведением с более прекрасными зернами, новый проигрыватель фильмов автоматически не подготовлен играть. Посмотрите обсуждение для initWithContentURL: метод экземпляра.

Кроме того, AirPlay был отключен по умолчанию в iOS 4.3 и ранее. Запускаясь в iOS 5.0, значении по умолчанию для allowsAirPlay свойство YEStrue.

Поведение в iOS 3.1 и Ранее

В iOS 3.1 и ранее, этот класс реализовал полноэкранный проигрыватель фильмов только. После создания проигрывателя фильмов и инициализации его с единственным файлом ролика, Вы вызвали play метод для представления фильма. (Определение play метод с тех пор переместился из этого класса и в MPMediaPlayback протокол.) Сам объект проигрывателя фильмов обработал фактическое представление содержания фильма.

Создание и инициализация объекта
  • init (contentURL:) - initWithContentURL: Определяемый инициализатор

    Возвраты a MPMoviePlayerController объект инициализируется с фильмом в указанном URL.

    Объявление

    Swift

    init!(contentURL url: NSURL!)

    Objective C

    - (instancetype)initWithContentURL:(NSURL *)url

    Параметры

    url

    Расположение файла ролика. Этот файл должен быть расположен или в Вашем каталоге приложения или на удаленном сервере.

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

    Объект проигрывателя фильмов.

    Обсуждение

    Этот метод инициализирует проигрыватель фильмов, но не подготавливает его к воспроизведению. Для подготовки нового проигрывателя фильмов к воспроизведению вызовите prepareToPlay метод, описанный в Ссылке на протокол MPMediaPlayback.

    Чтобы быть уведомленными, когда новый проигрыватель фильмов будет готов играть, зарегистрируйтесь для MPMoviePlayerLoadStateDidChangeNotification уведомление. Можно тогда проверить состояние загрузки путем доступа loadState свойство.

    Для проверки на ошибки в загрузке URL зарегистрируйтесь для MPMoviePlayerPlaybackDidFinishNotification уведомление. На ошибке это уведомление содержит NSError возразите доступному использованию @"error" введите уведомление userInfo словарь.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

Доступ к свойствам фильма
  • contentURL Свойство

    URL, указывающий на файл ролика.

    Объявление

    Swift

    @NSCopying var contentURL: NSURL!

    Objective C

    @property(nonatomic, copy) NSURL *contentURL

    Обсуждение

    При установке этого свойства, в то время как фильм играет, тот фильм, паузы и новый фильм начинают загружаться. Новый фильм начинает играть вначале.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • movieSourceType Свойство

    Тип воспроизведения фильма.

    Объявление

    Swift

    var movieSourceType: MPMovieSourceType

    Objective C

    @property(nonatomic) MPMovieSourceType movieSourceType

    Обсуждение

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • movieMediaTypes Свойство

    Типы носителей, доступных в фильме. (только для чтения)

    Объявление

    Swift

    var movieMediaTypes: MPMovieMediaTypeMask { get }

    Objective C

    @property(nonatomic, readonly) MPMovieMediaTypeMask movieMediaTypes

    Обсуждение

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • allowsAirPlay Свойство

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

    Объявление

    Swift

    var allowsAirPlay: Bool

    Objective C

    @property(nonatomic) BOOL allowsAirPlay

    Обсуждение

    Проигрыватель фильмов поддерживает беспроводное воспроизведение фильма к Поддерживающим трансляцию аппаратным средствам. Когда включено, когда такие аппаратные средства находятся в диапазоне, пользователь может выбрать AirPlay-enabled hardware в Панели управления.

    Значение по умолчанию YEStrue. Для отключения воспроизведения фильма AirPlay установите значение этого свойства в NOfalse.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • airPlayVideoActive Свойство

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

    Объявление

    Swift

    var airPlayVideoActive: Bool { get }

    Objective C

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

    Обсуждение

    Можно запросить это свойство после получения MPMoviePlayerIsAirPlayVideoActiveDidChangeNotification уведомление, чтобы узнать, запустилось ли видео AirPlay или остановилось.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • naturalSize Свойство

    Ширина и высота кадра фильма. (только для чтения)

    Объявление

    Swift

    var naturalSize: CGSize { get }

    Objective C

    @property(nonatomic, readonly) CGSize naturalSize

    Обсуждение

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

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • fullscreen Свойство

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

    Объявление

    Swift

    var fullscreen: Bool

    Objective C

    @property(nonatomic, getter=isFullscreen) BOOL fullscreen

    Обсуждение

    Значение по умолчанию этого свойства NOfalse. Изменение значения этого свойства заставляет проигрыватель фильмов вводить или сразу выходить из полноэкранного режима. Если Вы хотите анимировать переход к полноэкранному режиму, используйте setFullscreen:animated: метод вместо этого.

    Каждый раз, когда проигрыватель фильмов вводит или выходит из полноэкранного режима, он отправляет надлежащие уведомления для отражения изменения. Например, после ввода полноэкранного режима, это отправляет MPMoviePlayerWillEnterFullscreenNotification и MPMoviePlayerDidEnterFullscreenNotification уведомления. После выхода от полноэкранного режима это отправляет MPMoviePlayerWillExitFullscreenNotification и MPMoviePlayerDidExitFullscreenNotification уведомления.

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

    См. также

    – setFullscreen:animated:

  • setFullscreen (_: анимированный:) - setFullscreen:animated:

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

    Объявление

    Swift

    func setFullscreen(_ fullscreen: Bool, animated animated: Bool)

    Objective C

    - (void)setFullscreen:(BOOL)fullscreen animated:(BOOL)animated

    Параметры

    fullscreen

    Указать YEStrue ввести полноэкранный режим или NOfalse выходить из полноэкранного режима.

    animated

    Указать YEStrue анимировать переход между режимами или NOfalse переключиться сразу на новый режим.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

    См. также

    полноэкранный

  • scalingMode Свойство

    Масштабирующийся режим для использования при отображении фильма.

    Объявление

    Swift

    var scalingMode: MPMovieScalingMode

    Objective C

    @property(nonatomic) MPMovieScalingMode scalingMode

    Обсуждение

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

    Значение по умолчанию этого свойства MPMovieScalingModeAspectFit. Для списка доступных режимов масштабирования посмотрите MPMovieScalingMode.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • controlStyle Свойство

    Стиль управления воспроизведением.

    Объявление

    Swift

    var controlStyle: MPMovieControlStyle

    Objective C

    @property(nonatomic) MPMovieControlStyle controlStyle

    Обсуждение

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • useApplicationAudioSession (iOS 6.0) Свойство

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

    Оператор осуждения

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

    Объявление

    Objective C

    @property(nonatomic) BOOL useApplicationAudioSession

    Обсуждение

    Значение по умолчанию этого свойства YEStrue. Установка этого свойства к NOfalse заставляет проигрыватель фильмов использовать предоставленный систему аудио сеанс с категорией воспроизведения non-mixable.

    Когда это свойство YEStrue, проигрыватель фильмов совместно использует аудио сеанс приложения. Это дает Вам контроль над тем, как содержание проигрывателя фильмов взаимодействует с Вашим аудио и с аудио из других приложений, таких как iPod. Для важного руководства при использовании этой функции посмотрите Работу с Фильмами и Музыкой iPod в Аудио Руководстве по программированию Сеанса.

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

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

    В iOS 3.1 и ранее, проигрыватель фильмов всегда использует предоставленный систему аудио сеанс. Для получения того же самого поведения в iOS 3.2 и более новый необходимо установить значение этого свойства в NOfalse.

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

    Objective C

    @import MediaPlayer;

    Доступность

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

    Осуждаемый в iOS 6.0.

Доступ к продолжительности фильма
  • duration Свойство

    Продолжительность фильма, измеренного в секундах. (только для чтения)

    Объявление

    Swift

    var duration: NSTimeInterval { get }

    Objective C

    @property(nonatomic, readonly) NSTimeInterval duration

    Обсуждение

    Если продолжительность фильма не известна, значение в этом свойстве 0.0. Если продолжительность впоследствии определяется, это свойство обновляется и a MPMovieDurationAvailableNotification уведомление отправляется.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • playableDuration Свойство

    Сумма в настоящее время играемого содержания. (только для чтения)

    Объявление

    Swift

    var playableDuration: NSTimeInterval { get }

    Objective C

    @property(nonatomic, readonly) NSTimeInterval playableDuration

    Обсуждение

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

Доступ к представлению
  • view Свойство

    Представление, содержащее содержание фильма и средства управления. (только для чтения)

    Объявление

    Swift

    var view: UIView! { get }

    Objective C

    @property(nonatomic, readonly) UIView *view

    Обсуждение

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

    Для встраивания представления в собственные иерархии представления добавьте его как подпредставление к одному из существующих представлений. Хорошее место, чтобы сделать это находится в loadView или viewDidLoad метод пользовательского контроллера представления, представляющего Вашу иерархию представления. Вы свободны изменить представление frame прямоугольник для размещения пространства, доступного в иерархии представления. Проигрыватель фильмов использует значение в scalingMode свойство для масштабирования содержания фильма для соответствия кадра Вы указываете.

    Если Вы хотите представить представление отдельно — т.е. не встраивая его в существующую иерархию представления — можно использовать экземпляр MPMoviePlayerViewController класс для управления представлением представления. Тот класс работает непосредственно с контроллером проигрывателя фильмов для представления представления отдельно.

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

    См. также

    backgroundView

  • backgroundView Свойство

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

    Объявление

    Swift

    var backgroundView: UIView! { get }

    Objective C

    @property(nonatomic, readonly) UIView *backgroundView

    Обсуждение

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

    Это представление является частью иерархии представления, возвращенной view свойство.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

Управление и контроль воспроизведения

См. также методы MPMediaPlayback протокол.

  • loadState Свойство

    Состояние сетевой нагрузки проигрывателя фильмов. (только для чтения)

    Объявление

    Swift

    var loadState: MPMovieLoadState { get }

    Objective C

    @property(nonatomic, readonly) MPMovieLoadState loadState

    Обсуждение

    Посмотрите перечисление MPMovieLoadState для возможных значений этого свойства. Чтобы быть уведомленными относительно изменений в состоянии загрузки проигрывателя фильмов, зарегистрируйтесь для MPMoviePlayerLoadStateDidChangeNotification уведомление.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • playbackState Свойство

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

    Объявление

    Swift

    var playbackState: MPMoviePlaybackState { get }

    Objective C

    @property(nonatomic, readonly) MPMoviePlaybackState playbackState

    Обсуждение

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

    Посмотрите “MPMoviePlaybackState” перечисление для возможных значений этого свойства. Чтобы быть уведомленными относительно изменений в состоянии воспроизведения проигрывателя фильмов, зарегистрируйтесь для MPMoviePlayerPlaybackStateDidChangeNotification уведомление.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • initialPlaybackTime Свойство

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

    Объявление

    Swift

    var initialPlaybackTime: NSTimeInterval

    Objective C

    @property(nonatomic) NSTimeInterval initialPlaybackTime

    Обсуждение

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

    Значение по умолчанию этого свойства-1, который указывает естественное время начала фильма.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • endPlaybackTime Свойство

    Время окончания (измеренный в секундах) для воспроизведения фильма.

    Объявление

    Swift

    var endPlaybackTime: NSTimeInterval

    Objective C

    @property(nonatomic) NSTimeInterval endPlaybackTime

    Обсуждение

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • shouldAutoplay Свойство

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

    Объявление

    Swift

    var shouldAutoplay: Bool

    Objective C

    @property(nonatomic) BOOL shouldAutoplay

    Обсуждение

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • readyForDisplay Свойство

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

    Объявление

    Swift

    var readyForDisplay: Bool { get }

    Objective C

    @property(nonatomic, readonly) BOOL readyForDisplay

    Обсуждение

    Значение по умолчанию этого свойства NOfalse. Это свойство возвраты YEStrue если первый видеокадр готов быть выведенным на экран и возвраты NOfalse при отсутствии связанных видеотреков. Когда значение этого свойства изменяется на YEStrue, a MPMoviePlayerReadyForDisplayDidChangeNotification отправляется.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • repeatMode Свойство

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

    Объявление

    Swift

    var repeatMode: MPMovieRepeatMode

    Objective C

    @property(nonatomic) MPMovieRepeatMode repeatMode

    Обсуждение

    Значение по умолчанию этого свойства MPMovieRepeatModeNone. Для списка доступных повторных режимов посмотрите MPMovieRepeatMode.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • - timedMetadata

    Получает новые основанные на времени метаданные, предоставленные переданным потоком фильмом.

    Объявление

    Swift

    var timedMetadata: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *timedMetadata

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

    Массив нового MPTimedMetadata объекты, предоставленные переданным потоком фильмом.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

Игра объявления видео перед рулоном
  • playPrerollAdWithCompletionHandler (_:) - playPrerollAdWithCompletionHandler:

    Запрашивает видео объявление играться.

    Объявление

    Swift

    func playPrerollAdWithCompletionHandler(_ completionHandler: ((NSError!) -> Void)!)

    Objective C

    - (void)playPrerollAdWithCompletionHandler:(void (^)(NSError *error))completionHandler

    Параметры

    completionHandler

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

    Ошибки могут произойти по ряду причин, такие как отсутствие материально-технических ресурсов объявления, превысив максимальную частоту воспроизведения объявления перед рулоном, iAd проблемы конфигурации учетной записи и проблемы воспроизведения носителей. Посмотрите ADError для полного списка возможных ошибок.

    Обсуждение

    iAdPreroll категория добавляет поддержку объявлений видео перед рулоном к MPMoviePlayerController объекты.

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

    Для реализации контроллера проигрывателя фильмов сконфигурируйте его содержание и запросите объявление перед рулоном. Обработчик завершения тогда запускает нормальное воспроизведение на контроллере проигрывателя фильмов, отвечая на любые состояния ошибки в объявлении перед рулоном сначала.

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

    Этот метод реализован в iAd.framework.

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

    Objective C

    @import iAd;

    Swift

    import iAd

    Доступность

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

Генерация изображений миниатюр
  • - thumbnailImageAtTime:timeOption: (iOS 7.0)

    Получения и возвраты изображение миниатюр из текущего фильма.

    Объявление

    Objective C

    - (UIImage *)thumbnailImageAtTime:(NSTimeInterval)playbackTime timeOption:(MPMovieTimeOption)option

    Параметры

    playbackTime

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

    option

    Опция использовать при определении, который определенный кадр использовать для изображения миниатюр. Для списка возможных значений посмотрите MPMovieTimeOption.

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

    Объект изображения, содержащий изображение из фильма или nil если не могла бы быть получена миниатюра.

    Обсуждение

    Этот метод получает изображение миниатюр синхронно из текущего фильма (который доступен от MPMovieSourceTypeUnknown свойство).

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

    Objective C

    @import MediaPlayer;

    Доступность

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

    Осуждаемый в iOS 7.0.

  • requestThumbnailImagesAtTimes (_: timeOption:) - requestThumbnailImagesAtTimes:timeOption:

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

    Объявление

    Swift

    func requestThumbnailImagesAtTimes(_ playbackTimes: [AnyObject]!, timeOption option: MPMovieTimeOption)

    Objective C

    - (void)requestThumbnailImagesAtTimes:(NSArray *)playbackTimes timeOption:(MPMovieTimeOption)option

    Параметры

    playbackTimes

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

    option

    Опция использовать при определении, который определенный кадр использовать для каждого изображения миниатюр. Для списка возможных значений посмотрите MPMovieTimeOption.

    Обсуждение

    Этот метод обрабатывает каждый запрос миниатюры отдельно и асинхронно. Когда результаты для единственного изображения поступают, проигрыватель фильмов отправляет a MPMoviePlayerThumbnailImageRequestDidFinishNotification уведомление с результатами для того изображения. Уведомления отправляются независимо от того, был ли захват изображения успешным или неработающим. Необходимо зарегистрироваться для этого уведомления до вызова этого метода.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • cancelAllThumbnailImageRequests () - cancelAllThumbnailImageRequests

    Отмены все незаконченные асинхронные запросы изображения миниатюр.

    Объявление

    Swift

    func cancelAllThumbnailImageRequests()

    Objective C

    - (void)cancelAllThumbnailImageRequests

    Обсуждение

    Этот метод отменяет только сделанное использование запросов requestThumbnailImagesAtTimes:timeOption: метод. Это не делает запросов отмены, сделанных синхронно с помощью thumbnailImageAtTime:timeOption: метод.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

Получение журналов фильма
  • accessLog Свойство

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

    Объявление

    Swift

    var accessLog: MPMovieAccessLog! { get }

    Objective C

    @property(nonatomic, readonly) MPMovieAccessLog *accessLog

    Обсуждение

    Может быть nil. Для получения информации о журналах доступа фильма обратитесь к Ссылке класса MPMovieAccessLog.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • errorLog Свойство

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

    Объявление

    Swift

    var errorLog: MPMovieErrorLog! { get }

    Objective C

    @property(nonatomic, readonly) MPMovieErrorLog *errorLog

    Обсуждение

    Может быть nil. Для получения информации о журналах ошибок фильма обратитесь к Ссылке класса MPMovieErrorLog.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

Недоступные методы и свойства

Следующие методы и свойства больше не доступны с iOS 3.2 и не должны использоваться.

  • backgroundColor Доступный в iOS 2.0 через свойство iOS 7.1

    Цвет фоновой области позади фильма.

    Оператор осуждения

    Получите представление от backgroundView свойство и выбранный его цвет непосредственно.

    Объявление

    Objective C

    - (UIColor *)backgroundColor

    Обсуждение

    Необходимо избегать использования этого свойства. Это доступно только, когда Вы используете initWithContentURL: метод для инициализации объекта контроллера проигрывателя фильмов.

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

    Цвет по умолчанию для этого свойства является черным. Можно изменить это на другие цвета (включая ясный) для обеспечения более надлежащего перехода от содержания приложения до содержания фильма.

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

    Objective C

    @import MediaPlayer;

    Доступность

    Доступный в iOS 2.0 через iOS 7.1.

    Осуждаемый в iOS 3.2.

  • movieControlMode Доступный в iOS 2.0 через свойство iOS 7.1

    Контроль за работой пользователей для отображения.

    Оператор осуждения

    Используйте controlStyle свойство вместо этого.

    Объявление

    Objective C

    - (MPMovieControlMode)movieControlMode

    Обсуждение

    Избегайте использования этого свойства. Это доступно только, когда Вы используете initWithContentURL: метод для инициализации объекта контроллера проигрывателя фильмов.

    Определяет управление (если таковые имеются), пользователь имеет по воспроизведению фильма. Различные режимы предоставляют пользовательский доступ к различным наборам управления воспроизведением, часть из которого позволяет пользователю приостанавливать и возобновлять воспроизведение и некоторые из которых не делают.

    Это свойство установлено в MPMovieControlModeDefault по умолчанию. Посмотрите перечисление MPMovieControlMode для режимов доступного элемента управления.

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

    Objective C

    @import MediaPlayer;

    Доступность

    Доступный в iOS 2.0 через iOS 7.1.

    Осуждаемый в iOS 3.2.

Константы
  • MPMovieLoadState

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

    Объявление

    Swift

    struct MPMovieLoadState : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var Unknown: MPMovieLoadState { get } static var Playable: MPMovieLoadState { get } static var PlaythroughOK: MPMovieLoadState { get } static var Stalled: MPMovieLoadState { get } }

    Objective C

    enum { MPMovieLoadStateUnknown = 0, MPMovieLoadStatePlayable = 1 << 0, MPMovieLoadStatePlaythroughOK = 1 << 1, MPMovieLoadStateStalled = 1 << 2, }; typedef NSInteger MPMovieLoadState;

    Константы

    • Unknown

      MPMovieLoadStateUnknown

      Состояние загрузки не известно.

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

    • Playable

      MPMovieLoadStatePlayable

      Буфер имеет достаточно данных, которые может начать воспроизведение, но это может исчерпать данные, прежде чем закончится воспроизведение.

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

    • PlaythroughOK

      MPMovieLoadStatePlaythroughOK

      Достаточно данных было буферизовано для воспроизведения для продолжения непрерывный.

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

    • Stalled

      MPMovieLoadStateStalled

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

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMovieControlStyle

    Константы, описывающие стиль управления воспроизведением.

    Объявление

    Swift

    enum MPMovieControlStyle : Int { case None case Embedded case Fullscreen }

    Objective C

    enum { MPMovieControlStyleNone, MPMovieControlStyleEmbedded, MPMovieControlStyleFullscreen, MPMovieControlStyleDefault = MPMovieControlStyleFullscreen }; typedef NSInteger MPMovieControlStyle;

    Константы

    • None

      MPMovieControlStyleNone

      Никакие средства управления не выведены на экран.

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

    • Embedded

      MPMovieControlStyleEmbedded

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

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

    • Fullscreen

      MPMovieControlStyleFullscreen

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

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

    • MPMovieControlStyleDefault

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

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • МПМОВИФИНИШРИСОН

    Константы, описывающие причину то воспроизведение, закончились.

    Объявление

    Swift

    enum MPMovieFinishReason : Int { case PlaybackEnded case PlaybackError case UserExited }

    Objective C

    enum { MPMovieFinishReasonPlaybackEnded, MPMovieFinishReasonPlaybackError, MPMovieFinishReasonUserExited }; typedef NSInteger MPMovieFinishReason;

    Константы

    • PlaybackEnded

      MPMovieFinishReasonPlaybackEnded

      Конец фильма был достигнут.

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

    • PlaybackError

      MPMovieFinishReasonPlaybackError

      Во время воспроизведения была ошибка.

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

    • UserExited

      MPMovieFinishReasonUserExited

      Пользователь остановил воспроизведение.

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlaybackState

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

    Объявление

    Swift

    enum MPMoviePlaybackState : Int { case Stopped case Playing case Paused case Interrupted case SeekingForward case SeekingBackward }

    Objective C

    enum { MPMoviePlaybackStateStopped, MPMoviePlaybackStatePlaying, MPMoviePlaybackStatePaused, MPMoviePlaybackStateInterrupted, MPMoviePlaybackStateSeekingForward, MPMoviePlaybackStateSeekingBackward }; typedef NSInteger MPMoviePlaybackState;

    Константы

    • Stopped

      MPMoviePlaybackStateStopped

      Воспроизведение в настоящее время останавливается. Воспроизведение начнется с начала фильма.

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

    • Playing

      MPMoviePlaybackStatePlaying

      Воспроизведение идет в настоящее время полным ходом.

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

    • Paused

      MPMoviePlaybackStatePaused

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

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

    • Interrupted

      MPMoviePlaybackStateInterrupted

      Воспроизведение временно прервано, возможно потому что буфер исчерпал содержание.

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

    • SeekingForward

      MPMoviePlaybackStateSeekingForward

      Проигрыватель фильмов в настоящее время ищет к концу фильма.

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

    • SeekingBackward

      MPMoviePlaybackStateSeekingBackward

      Проигрыватель фильмов в настоящее время ищет к началу фильма.

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMovieRepeatMode

    Константы, описывающие, как проигрыватель фильмов повторяет содержание в конце воспроизведения.

    Объявление

    Swift

    enum MPMovieRepeatMode : Int { case None case One }

    Objective C

    enum { MPMovieRepeatModeNone, MPMovieRepeatModeOne }; typedef NSInteger MPMovieRepeatMode;

    Константы

    • None

      MPMovieRepeatModeNone

      Когда воспроизведение заканчивается, содержание не повторяется

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

    • One

      MPMovieRepeatModeOne

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

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMovieScalingMode

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

    Объявление

    Swift

    enum MPMovieScalingMode : Int { case None case AspectFit case AspectFill case Fill }

    Objective C

    typedef enum { MPMovieScalingModeNone, MPMovieScalingModeAspectFit, MPMovieScalingModeAspectFill, MPMovieScalingModeFill } MPMovieScalingMode;

    Константы

    • None

      MPMovieScalingModeNone

      Не масштабируйте фильм.

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

    • AspectFit

      MPMovieScalingModeAspectFit

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

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

    • AspectFill

      MPMovieScalingModeAspectFill

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

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

    • Fill

      MPMovieScalingModeFill

      Масштабируйте фильм, пока обе размерности не будут соответствовать видимым границам представления точно. Форматное соотношение фильма не сохраняется.

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMovieTimeOption

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

    Объявление

    Swift

    enum MPMovieTimeOption : Int { case NearestKeyFrame case Exact }

    Objective C

    enum { MPMovieTimeOptionNearestKeyFrame, MPMovieTimeOptionExact }; typedef NSInteger MPMovieTimeOption;

    Константы

    • NearestKeyFrame

      MPMovieTimeOptionNearestKeyFrame

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

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

    • Exact

      MPMovieTimeOptionExact

      Используйте точный текущий кадр.

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMovieMediaTypeMask

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

    Объявление

    Swift

    struct MPMovieMediaTypeMask : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var None: MPMovieMediaTypeMask { get } static var Video: MPMovieMediaTypeMask { get } static var Audio: MPMovieMediaTypeMask { get } }

    Objective C

    enum { MPMovieMediaTypeMaskNone = 0, MPMovieMediaTypeMaskVideo = 1 << 0, MPMovieMediaTypeMaskAudio = 1 << 1 }; typedef NSInteger MPMovieMediaTypeMask;

    Константы

    • None

      MPMovieMediaTypeMaskNone

      Типы носителей, доступных в носителях, еще не известны.

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

    • Video

      MPMovieMediaTypeMaskVideo

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

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

    • Audio

      MPMovieMediaTypeMaskAudio

      Файл ролика содержит аудио носители.

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

    Обсуждение

    Вы можете OR указанные константы вместе для указания фильма

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMovieSourceType

    Указывает тип файла ролика.

    Объявление

    Swift

    enum MPMovieSourceType : Int { case Unknown case File case Streaming }

    Objective C

    enum { MPMovieSourceTypeUnknown, MPMovieSourceTypeFile, MPMovieSourceTypeStreaming }; typedef NSInteger MPMovieSourceType;

    Константы

    • Unknown

      MPMovieSourceTypeUnknown

      Тип фильма еще не известен.

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

    • File

      MPMovieSourceTypeFile

      Фильм является локальным файлом или является файлом, который может быть загружен с сети.

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

    • Streaming

      MPMovieSourceTypeStreaming

      Фильм является живым или по требованию потоком.

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

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • Пользовательские информационные ключи уведомления миниатюры

    Следующие ключи могут быть найдены в userInfo словарь a MPMoviePlayerThumbnailImageRequestDidFinishNotification уведомление.

    Объявление

    Swift

    let MPMoviePlayerThumbnailImageKey: String let MPMoviePlayerThumbnailTimeKey: String let MPMoviePlayerThumbnailErrorKey: String

    Objective C

    NSString *const MPMoviePlayerThumbnailImageKey; NSString *const MPMoviePlayerThumbnailTimeKey; NSString *const MPMoviePlayerThumbnailErrorKey;

    Константы

    • MPMoviePlayerThumbnailImageKey

      Значение этого ключа является a UIImage объект, содержащий изображение, полученное для нужного кадра.

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

    • MPMoviePlayerThumbnailTimeKey

      Значение этого ключа является a NSNumber объект, содержащий двойное значение. Это значение представляет фактическое время (измеренный в секундах) с начала фильма, в котором было получено изображение.

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

    • MPMoviePlayerThumbnailErrorKey

      Значение этого ключа NSError объект, идентифицирующий ошибку, произошедшую, если таковые имеются.

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

  • Полноэкранные ключи уведомления

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

    Объявление

    Swift

    let MPMoviePlayerFullscreenAnimationDurationUserInfoKey: String let MPMoviePlayerFullscreenAnimationCurveUserInfoKey: String

    Objective C

    NSString *const MPMoviePlayerFullscreenAnimationDurationUserInfoKey; NSString *const MPMoviePlayerFullscreenAnimationCurveUserInfoKey;

    Константы

    • MPMoviePlayerFullscreenAnimationDurationUserInfoKey

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

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

    • MPMoviePlayerFullscreenAnimationCurveUserInfoKey

      Значение этого ключа NSNumber содержа целочисленное значение, представляющее один из UIViewAnimationCurve константы.

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

  • Воспроизведите законченный ключ уведомления

    Следующий ключ может быть найден в userInfo словаре a MPMoviePlayerPlaybackDidFinishNotification уведомление.

    Объявление

    Swift

    let MPMoviePlayerPlaybackDidFinishReasonUserInfoKey: String

    Objective C

    NSString *const MPMoviePlayerPlaybackDidFinishReasonUserInfoKey;

    Константы

    • MPMoviePlayerPlaybackDidFinishReasonUserInfoKey

      Значение этого ключа NSNumber содержа целочисленное значение, представляющее один из “MPMovieFinishReason” константы.

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

  • MPMovieControlMode

    Опции для отображения управления воспроизведением фильма.

    Используйте “MPMovieControlStyle” константы в сочетании с controlStyle свойство вместо этого.

    Объявление

    Objective C

    typedef enum { MPMovieControlModeDefault, MPMovieControlModeVolumeOnly, MPMovieControlModeHidden } MPMovieControlMode;

    Константы

    • MPMovieControlModeDefault

      Выведите на экран стандартные средства управления для управления воспроизведением. Это включает средства управления игрой/паузой, регулятор громкости и управление временной шкалой.

      Доступный в iOS 2.0 через iOS 7.1.

    • MPMovieControlModeVolumeOnly

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

      Доступный в iOS 2.0 через iOS 7.1.

    • MPMovieControlModeHidden

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

      Доступный в iOS 2.0 через iOS 7.1.

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

    Objective C

    @import MediaPlayer;

    Доступность

    Доступный в iOS 2.0 через iOS 7.1.

Уведомления
  • MPMovieDurationAvailableNotification MPMovieDurationAvailableNotification

    Отправленный, когда была определена продолжительность фильма. Существует нет userInfo словарь.

    Для получения продолжительности фильма получите доступ к проигрывателю фильмов duration свойство. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMovieMediaTypesAvailableNotification MPMovieMediaTypesAvailableNotification

    Отправленный, когда определяются доступные типы среды в фильме. Существует нет userInfo словарь.

    Для получения доступных типов среды в фильме — аудио, видео, или обоих — получают доступ к проигрывателю фильмов movieMediaTypes свойство. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMovieNaturalSizeAvailableNotification MPMovieNaturalSizeAvailableNotification

    Отправленный, когда естественный тип телосложения фильма сначала определяется или впоследствии изменяется. Существует нет userInfo словарь.

    Для получения естественного типа телосложения для фильма получите доступ к проигрывателю фильмов naturalSize свойство. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerContentPreloadDidFinishNotification MPMoviePlayerContentPreloadDidFinishNotification

    Отправленный, когда фильм находится в памяти и готов играть. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением. Если ошибка произошла во время загрузки, userInfo словарь этого уведомления содержит ключ с именем «ошибка», значение которой NSError объект, описывающий проблему.

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

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

    Objective C

    @import MediaPlayer;

    Доступность

    Доступный в iOS 2.0 через iOS 7.1.

    Осуждаемый в iOS 3.2.

  • MPMoviePlayerDidEnterFullscreenNotification MPMoviePlayerDidEnterFullscreenNotification

    Отправленный, когда проигрыватель фильмов ввел полноэкранный режим. Существует нет userInfo словарь.

    Проигрыватель фильмов может перейти к полноэкранному режиму программно (см. setFullscreen:animated: метод) или взаимодействием с пользователем. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerDidExitFullscreenNotification MPMoviePlayerDidExitFullscreenNotification

    Отправленный, когда проигрыватель фильмов вышел из полноэкранного режима. Существует нет userInfo словарь.

    Проигрыватель фильмов может выйти из полноэкранного режима программно (см. setFullscreen:animated: метод) или взаимодействием с пользователем. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerIsAirPlayVideoActiveDidChangeNotification MPMoviePlayerIsAirPlayVideoActiveDidChangeNotification

    Отправленный, когда проигрыватель фильмов запустил или закончил проигрывание фильма через AirPlay. Существует нет userInfo словарь.

    Узнать, запустилось ли воспроизведение AirPlay или остановилось, запрос airPlayVideoActive свойство. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerLoadStateDidChangeNotification MPMoviePlayerLoadStateDidChangeNotification

    Отправленный, когда изменилось сетевое состояние буферизации проигрывателя фильмов. Существует нет userInfo словарь.

    Для получения текущего состояния загрузки проигрывателя фильмов получите доступ к loadState свойство. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerNowPlayingMovieDidChangeNotification MPMoviePlayerNowPlayingMovieDidChangeNotification

    Отправленный, когда изменился в настоящее время проигрывающий фильм. Существует нет userInfo словарь.

    Для получения URL для того, чтобы в настоящее время проигрывать фильм получите доступ к проигрывателю фильмов contentURL свойство. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerPlaybackDidFinishNotification MPMoviePlayerPlaybackDidFinishNotification

    Отправленный, когда фильм закончил играть. userInfo словарь этого уведомления содержит MPMoviePlayerPlaybackDidFinishReasonUserInfoKey ключ, указывающий причину то законченное воспроизведение. Когда воспроизведение перестало работать из-за ошибки, это уведомление также отправляется.

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

    Когда фильм выводит на экран в полноэкранном режиме и пользовательских Сделанных касаниях, это уведомление не отправляется. Воспроизведение пауз кнопки Done и причины проигрыватель фильмов для выхода из полноэкранного режима. Для обнаружения этого сценария зарегистрируйте для других уведомлений такой как MPMoviePlayerDidExitFullscreenNotification.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerPlaybackStateDidChangeNotification MPMoviePlayerPlaybackStateDidChangeNotification

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

    Состояние воспроизведения может измениться программно (см. Ссылку на протокол MPMediaPlayback), или взаимодействием с пользователем. Для получения состояния воспроизведения проигрывателя фильмов получите доступ к playbackState свойство. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerScalingModeDidChangeNotification MPMoviePlayerScalingModeDidChangeNotification

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

    Режим Scaling может измениться программно или взаимодействием с пользователем. Чтобы установить или получить масштабирующийся режим проигрывателя фильмов, получите доступ к scalingMode свойство. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerThumbnailImageRequestDidFinishNotification MPMoviePlayerThumbnailImageRequestDidFinishNotification

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

    Если запрос получения закончился с ошибкой, userInfo словарь содержит значения для следующих двух ключей:

    Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением. Методы для использования для получения миниатюр фильма описаны в Генерации Изображений миниатюр.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerWillEnterFullscreenNotification MPMoviePlayerWillEnterFullscreenNotification

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

    Проигрыватель фильмов может перейти к полноэкранному режиму программно (см. setFullscreen:animated: метод) или взаимодействием с пользователем. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerWillExitFullscreenNotification MPMoviePlayerWillExitFullscreenNotification

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

    Проигрыватель фильмов может выйти из полноэкранного режима программно (см. setFullscreen:animated: метод) или взаимодействием с пользователем. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMovieSourceTypeAvailableNotification MPMovieSourceTypeAvailableNotification

    Отправленный, когда исходный тип фильма был ранее неизвестен и недавно доступен. Существует нет userInfo словарь.

    Для получения исходного типа фильма получите доступ к проигрывателю фильмов movieSourceType свойство. Проигрыватель фильмов, состояние которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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

  • MPMoviePlayerReadyForDisplayDidChangeNotification MPMoviePlayerReadyForDisplayDidChangeNotification

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

    Чтобы проверить, готов ли проигрыватель фильмов к дисплею, получите доступ к readyForDisplay свойство. Проигрыватель фильмов, состояние дисплея которого изменилось, доступен как объект, связанный с уведомлением.

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

    Objective C

    @import MediaPlayer;

    Swift

    import MediaPlayer

    Доступность

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