VoD

Video on Demand (видео по запросу) — система индивидуальной доставки пользователю медиапотока, при котором видео не скачивается как файл, а смотрится напрямую через сеть Интернет, при этом его можно запросить в любое удобное время с возможностью перемотки, паузы, закладки и т.д.

Объект vod

Для управления услугой в системе создается объект vod. Основной параметр, необходимый для vod - это источник видео файлов.

Подключение

Для подключения VoD необходимо указать в качестве источника видео ресурс, на котором хранятся видео файлы. Источником видео файлов может быть заранее созданный и активированный объект domain или s3-bucket.

примечание

Поддерживаемые форматы исходных видео файлов, хранящихся на источнике: mp4

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

Если источником выбран сайт:

• HLS: https://{vod_domain}/hls/{filename}/master.m3u8
• DASH: https://{vod_domain}/dash/{filename}/manifest.mpd
• MSS: https://{vod_domain}/mss/{filename}/manifest

Если источником выбран бакет:

• HLS: https://{vod_domain}/hls/{bucket_name}/{filename}/master.m3u8
• DASH: https://{vod_domain}/dash/{bucket_name}/{filename}/manifest.mpd
• MSS: https://{vod_domain}/mss/{bucket_name}/{filename}/manifest

warning

При удалении из системы источника видео файлов автоматически удаляется и объект vod

Подписанные ссылки

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

Подписанная ссылка представляет собой URL вида {vod_url}?token={vod_token}, где vod_url - оригинальный URL плейлиста VoD, vod_token - сгенерированный токен с цифровой подписью.

В качестве параметров токена могут быть использованы время действия ссылки lifetime в секундах и шаблон пути к файлам acl_path, используемым в качестве источника VoD, на которые распространяется действие токена. Примеры acl_path:

• /* - все файлы (используется по умолчанию)
• /private_* - все файлы в корневой папке с префиксом private_
• /media/* - только файлы в папке media и вложенных папках
• /example.mp4 - только файл example.mp4

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

примечание

Ограничение доступа возможно только для протоколов HLS и DASH

Ограничение доступа

Для объектов VoD доступна функция ограничения доступа из определенных стран.

Адаптивный битрейт

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

примечание

Для корректной работы плеер должен поддерживать функию адаптивного битрейта (ABR)

примечание

Опция доступна только для протоколов HLS и DASH

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

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

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

примечание

При очистке кеша будут удалены преобразованные файлы для всех видео, связанных с объектом VoD