XML-описание видео

Формат видео описывается в атрибутах элемента ovs:available_format. Каждое сочетание качества видео и параметров кодека следует описывать в атрибутах отдельного элемента format.

Поддерживаются следующие поля:

• codecs (обязательный атрибут) — кодек, доступный для данного формата.

• width — ширина видео в пикселях.

• height — высота видео в пикселях.

• bitrate — максимальный битрейт в килобитах в секунду (kbps).

• quality — качество видео.

  Поддерживаемые значения:

  • low — низкое качество (разрешение меньше 360×640, битрейт ниже 717 kbps);

  • medium — среднее качество (разрешение от 360×640 до 720×1280, битрейт от 717 kbps до 1 Mbps);

  • HD — HD-качество (разрешение от 720×1280 до 1080×1920, битрейт 1-2 Mbps);

  • full HD — качество Full HD (разрешение больше 1080×1920, битрейт выше 2 Mbps).

• size — размер файла видео в килобайтах.

Пример разметки:

<ovs:available_format>
  <ovs:format codecs="h.264" width="320" height="240" 
              quality="low" bitrate="250"/>
  <ovs:format codecs="h.264" width="854" height="480" 
              quality="medium" bitrate="800"/>
  <ovs:format codecs="h.264" width="1280" height="720" 
              quality="HD" bitrate="1800"/>
  <ovs:format codecs="h.264" width="1920" height="1080" 
              quality="full HD" bitrate="2800"/>
</ovs:available_format>

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

Доступные категории

• Авто-мото (auto_moto).

• Анимация (animation).

• Вебинары (webinars).

• Вебкамеры (webcams).

• Дом, семья, дети (home_family_kids).

• Животные (animals).

• Здоровье (health).

• Игры (games).

• Интервью (interview).

• Интернет (internet).

• Искусство (art).

• История (history).

• Караоке (karaoke).

• Катастрофы и происшествия (disasters_and_accidents).

• Клип (clip).

• Концерт (concert).

• Короткое видео (short_video).

• Красота и мода (beauty_and_fashion).

• Кулинария (recipe).

• Музыка и видеоклипы (music).

• Мультфильмы (cartoons).

• Наука (science).

• Новости (news).

• Образование (education).

• Пародия (parody).

• Политика (politics).

• Природа (nature).

• Программы (software).

• Прямые трансляции (broadcast).

• Путешествия (travel).

• Развлечения (entertainment).

• Реклама (commercial).

• Сад и огород (Gardening).

• Сделай сам (handmade).

• Слайдшоу (slideshow).

• Спорт (sport).

• Стиль жизни (lifestyle).

• Танцы (dancing).

• ТВ (TV).

• Телесериалы (tvseries).

• Телешоу (tvshow).

• Технологии (gadget).

• Товары (goods).

• Трейлер (trailer).

• Увлечения (hobby).

• Фильмы (movie).

• Фильм о фильме (movie_about_movie).

• Фрагмент (fragment).

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

Пример разметки:

<ovs:category>movie</ovs:category>
<ovs:category>trailer</ovs:category>

Для некоторых категорий видео доступна дополнительная разметка:

Фильм (ovs:movie)

Поддерживаемые характеристики:

• ovs:original_name — название фильма на языке производителя.

• ovs:release_date — дата выхода фильма в прокат. Если точная дата неизвестна, указывайте первое января года выхода фильма.

• ovs:part — номер части, если фильм состоит из нескольких частей (например: «Гарри Поттер и Дары смерти: Часть 1»).

Пример разметки:

<ovs:movie>
  <ovs:original_name>Гарри Поттер и Дары смерти</ovs:original_name>
  <ovs:release_date>2013-03-04T00:00:00</ovs:release_date>
  <ovs:part>1</ovs:part>
</ovs:movie>

Серия сериала (ovs:tvseries)

Поддерживаемые характеристики:

• ovs:episode (обязательное поле) — номер эпизода.

• ovs:season — номер сезона.

• ovs:release_date — дата выхода серии в эфир.

• ovs:original_name — название на языке производителя.

Пример разметки:

<ovs:tvseries>
  <ovs:original_name>The Big Bang Theory</ovs:original_name>
  <ovs:release_date>2013-03-04T00:00:00</ovs:release_date>
  <ovs:season>6</ovs:season>
  <ovs:episode>15</ovs:episode>
</ovs:tvseries>

Музыкальное видео (ovs:music)

Поддерживаемые характеристики:

• ovs:track_name (обязательное поле) — название трека.

• ovs:album — название альбома

Пример разметки:

<ovs:music>
  <track_name>A Bar In Amsterdam</track_name>
  <album>Le Pop</album>
</ovs:music>

Выпуск шоу (ovs:tvshow)

Поддерживаемые характеристики:

• ovs:episode (обязательное поле) — номер выпуска.

• ovs:season — номер сезона.

• ovs:release_date — дата выхода выпуска телешоу в эфир.

Пример разметки:

<ovs:tvshow>
  <ovs:original_name>Top Gear</ovs:original_name>
  <ovs:release_date>2013-03-04T00:00:00</ovs:release_date>
  <ovs:season>19</ovs:season>
  <ovs:episode>2</ovs:episode>
</ovs:tvshow>

Прямая трансляция (ovs:broadcast)

Поддерживаемые характеристики:

• ovs:start_date (обязательное поле) — дата и время начала трансляции.

• ovs:end_date — дата и время окончания трансляции. Не нужно заполнять, если по окончании трансляции запись доступна по тому же адресу.

Пример разметки:

<ovs:broadcast>
      <ovs:start_date>2013-04-04T00:00:00</ovs:start_date>
      <ovs:end_date>2013-04-04T00:30:00</ovs:end_date>
</ovs:broadcast>

Для дополнительного описания видео можно использовать только одну из этих категорий (например, нельзя одновременно использовать элементы ovs:movie и ovs:tvshow). Указывать дополнительные элементы необязательно — если подробных данных о видео нет, просто задайте нужное значение для элемента ovs:category.

Поддерживаемые характеристики:

• embed_url — ссылка для вставки видео, размещенного на отдельной странице.

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

• embed_html — HTML-код для вставки плеера, проигрывающего видео (указывается, если не удалось сформировать ссылку для поля embed_url).

• allow_embed — признак того, что видео можно показывать на странице результатов поиска Яндекса.

  По умолчанию видео можно проигрывать прямо в результатах поиска. Чтобы видео можно было посмотреть только на вашем сайте, задайте элемент <ovs:allow_embed>no</ovs:allow_embed>.

• available_platform — платформа, на которой можно воспроизвести данное видео.

  Пример списка поддерживаемых платформ:

  <ovs:available_platform>Windows</ovs:available_platform>
  <ovs:available_platform>WindowsPhone</ovs:available_platform>

  Полный список поддерживаемых значений

  • Desktop — указание на то, что поддерживаются основные платформы персональных компьютеров (перечислены ниже)

  • Windows

  • Linux

  • OSX

  • Mobile — указание на то, что поддерживаются основные мобильные платформы (перечислены ниже)

  • iOS

  • Android

  • WindowsPhone

  • WindowsMobile

  • Symbian

  • Bada

  • BlackBerry

  • MeeGo

Дату и время следует указывать согласно стандарту ISO 8601, в формате YYYY-MM-DDTHH:mm:ss+03:00, где:

• YYYY — год

• MM — месяц

• DD — день

• HH — час

• mm — минута

• ss — секунда

• +03:00 — часовой пояс (в данном случае — московское время).

Если вы хотите указать только год (например, в качестве даты выхода фильма), укажите полночь 1 января в нужном году, например, 2001-01-01T00:00:00.

Пример разметки:

<ovs:created_date>2013-07-15T15:00:00</ovs:created_date>
<ovs:upload_date>2013-07-19T02:35:10</ovs:upload_date>

Статистику просмотров и рейтингов видео можно описать в элементе ovs:stats с помощью следующих свойств:

• views_last_day — количество просмотров за день.

• views_last_month — количество просмотров за месяц.

• views_last_week — количество просмотров за неделю.

• views_total — общее количество просмотров.

• comments — количество отзывов на видео.

• likes — общее количество пользователей, которым понравилось видео.

• dislikes — общее число пользователей, которым не понравилось видео.

• rating — усредненный рейтинг видео (по шкале от 0 до 10).

Пример разметки:

<ovs:stats>
  <views_last_day>0</views_last_day>
  <views_last_month>45454</views_last_month>
  <views_last_week>5454</views_last_week>
  <views_total>544787</views_total>
  <comments>5</comments>
  <likes>54</likes>
  <dislikes>1</dislikes>
  <rating>6</rating>
  <rating_count>54444</rating_count>
</ovs:stats>

С помощью элементов ovs:allow_countries и ovs:disallow_countries вы можете точно указать ограничения на международные показы видео. Элемент ovs:allow_countries рекомендуется использовать, если видео разрешено показывать только в определенных странах. Элемент ovs:disallow_countries рекомендуется использовать, если показ видео ограничен только в некоторых странах. Несколько ограничений можно перечислить через запятую или указать в отдельных элементах.

Примеры разметки:

<!-- Показ видео разрешен только в России (для аудитории 12+) и Турции (для аудитории 18+). -->
<ovs:allow_countries>ru(12+), tr(18+)</ovs:allow_countries>

<!-- Показ видео разрешен везде, кроме Великобритании. В России видео разрешено к показу для аудитории 12+, а в Турции — для аудитории 18+. -->
<ovs:disallow_countries>ru(12+), tr(18+)</ovs:disallow_countries>
<ovs:disallow_countries>uk</ovs:disallow_countries>

Информация о стоимости видео указывается в элементе price. Можно указать несколько цен — например, стоимость подписки на видеосервис и стоимость загрузки данного видеоролика.

Поддерживаемые атрибуты:

• type — тип оплаты.

  Допустимые значения:

  • rent — право на просмотр в течение ограниченного времени,

  • subscription — подписка на серию роликов или на длительный срок,

  • purchase — приобретение видео.

• duration — продолжительность (для оплаты за период времени) в формате ISO 8601.

• currency — валюта в формате ISO 4217.

Пример разметки:

<!-- Стоимость аренды ролика на 36 часов. -->
<ovs:price type="rent" duration="P1DT12H" currency="rur">100</ovs:price>
<!-- Стоимость подписки на месяц. -->
<ovs:price type="subscription" duration="P1M" currency="rur">1000</ovs:price>
<!-- Стоимость покупки видео. -->
<ovs:price type="purchase" currency="rur">100</ovs:price>