Содержание
В движке вся работа с видео – импорт, конвертация, хранение – выполняется посредством гибкой системы видео провайдеров. Список всех поддерживаемых провайдеров находится в админке:
Компоненты => iVideo => Провайдеры
В этом списке вы можете включать и выключать провайдеров, видеть возможности каждого провайдера и сортировать по ним, видеть ссылку на сайт провайдера, видеть версию провайдера (а для некоторых провайдеров видеть наличие возможного обновления, которое ставится тут же в админке) и выполнять действия над провайдерами: удалять, изменять настройки, изменять данные, экспортировать и публиковать в общем каталоге.
На этой же странице есть ссылки на установку пакетов сторонних провайдеров, добавление провайдеров из админки, импорт провайдеров и общий каталог провайдеров.
Типы возможностей провайдеров
Провайдеры классифицируются по их функциональным возможностям.
Импорт по ссылке
Провайдеры, имеющие такую возможность, позволяют выполнять импорт по ссылке на страницу ролика сайта, который они обслуживают. Например, провайдер YouTube имеет возможность импорта по ссылке. Переходим на сайте youtube.com, открываем страницу нужного ролика и копируем ссылку с адресной строки браузера. Это и есть та ссылка, по которой движок импортирует видео на ваш сайт. Аналогично и с другими провайдерами импорта по ссылке. Для пользователей сайта эта возможность регулируется правилами доступа группы.
Массовый импорт видео на сайт
Провайдеры, имеющие такую возможность, позволяют массово, через форму поиска, добавлять видео на ваш сайт. Форма добавления массовым импортом доступна на сайте через меню «Добавить ролик». Для пользователей сайта эта возможность регулируется правилами доступа группы. Кроме того, если это разрешено правилами доступа, пользователи могут создавать задания для автоматического наполнения сайта роликами по критериям поиска в массовом импорте. О функциях и возможностях массового импорта описано отдельно.
Конвертация видео
Провайдеры, имеющие такую возможность, могут выполнять конвертацию файлов, загружаемых пользователями через форму на сайте. Для пользователей сайта эта возможность регулируется правилами доступа группы.
Возможности воспроизведения видео на сайте
Выше были перечислены основные типы возможностей провайдеров. Дополнительно провайдеры классифицируются:
- Поддерживается ретрансляция;
- Поддерживается прямое воспроизведение.
Что такое ретрансляция и прямое воспроизведение описано здесь.
Провайдеры, поддерживающие ретрансляцию и прямое воспроизведения, могут воспроизводить видео файлы (это поведение может отключаться) в любом из плееров комплекта движка взамен их оригинальных плееров сайтов-доноров.
Действия над провайдерами
Для каждого провайдера в списке доступны возможные действия, они отображены иконками в колонке «Действия» таблицы списка.
Массовый импорт
Это действие доступно для тех провайдеров, которые имеют возможность массового импорта. После нажатия на кнопку откроется форма массового импорта выбранного провайдера.
Настройки провайдера
Это действие доступно для всех провайдеров. Как минимум, в форме опций будут настройки прав доступа. Права доступа могут содержать правила для ограничений групп в массовом импорте и/или ограничений в импорте по ссылке.
Для тех провайдеров, которые поддерживают воспроизведение в плеерах движка, будет показана вкладка «Плеер», в которой можно выбрать плеер для воспроизведения видео файлов провайдера и если плеер поддерживает смену скинов – то выбрать скин, а также, если плеер имеет возможность, открыть форму настроек плеера. Итого, для каждого провайдера можно выбрать свой плеер, свой скин и по-разному его настроить.
Если провайдер поддерживает прямое воспроизведение и/или ретрансляцию, то будет показана вкладка «Опции», в которой можно задать:
- Переменная seek. Название параметра url пути к файлу, который будет передаваться при псевдостримминге. Обычно это «start». Значением будет либо количество секунд (миллисекунд), либо количество байт, с которых нужно начать загрузку файлов. Параметр актуален при воспроизведении во flash плеерах. В случае HTML5 плееров, параметр смещения (range) передаётся в заголовках запроса и сервер сам должен (если это не так, то сервер нужно правильно сконфигурировать) на основе этих данных отдать нужный кусок файла.
- Прямое воспроизведение с сервера провайдера. Этот чекбокс появляется в том случае, если провайдер поддерживает данный тип воспроизведения. Если он включен, то движок (взамен показа оригинального ролика провайдера) покажет выбранный плеер движка, а ссылка на файл воспроизведения будет прямая на сервер сайта-донора. Таким образом проигрываться видео файл будет, минуя ваш сервер. Отключать данную опцию полезно, если по каким-то причинам алгоритм формирования прямых ссылок от данного провайдера сломался, и чтобы не терять посетителей до момента исправления алгоритма, можно показывать плеер сайта-донора.
- Использовать ретрансляцию. Эта опция в целом схожа по смыслу с предыдущей опций с тем отличием, что регулирует она возможность ретрансляции. В выпадающем списке можно выбрать сервер для ретрансляции или отключить её.
-
Время жизни временной ссылки на файл. Эта опция появляется в случае, если одной из предыдущих двух опций включен заданный тип воспроизведения. В ней задаётся время жизни в минутах, на которое кешировать получаемые прямые ссылки на файлы воспроизведения, т.к. они, как правило, имеют ограниченное по времени действие. Для каждого провайдера оптимальное время жизни выясняется экспериментально. В случае же, если вычислить однозначно не получается, то просто не ставьте слишком большое значение.
-
Добавлять в описание ссылку на ваш сайт. Эта опция появляется, если провайдер поддерживает конвертацию на стороннем сайте, например YouTube, Вконтакте. Если опция включена, то при загрузке файла провайдеру в описание ролика будет в самый конец добавлена ссылка на ваш сайт.
- Время, по истечении которого неконвертированные ролики удаляются. Опция актуальна для провайдеров конвертации. В ней указывается время в часах, по прошествии которого, те ролики, которые по какой-то причине не успели конвертироваться (ошибка провайдера или что-то иное) будут удалены.
- Сохранять оригинальные файлы пользователей. Эта опция также присутствует только у провайдеров конвертации. Если она включена, то все загружаемые файлы пользователей после конветации не будут удаляться, а будут сохраняться в директорию /upload/video/originals_storage/
Для провайдеров, которым для работы API необходим так называемый токен доступа (например для YouTube или Вконтакте), над формой появится ссылка «Получить токен доступа» («Очистить токен доступа»). Пользоваться этой ссылкой нужно при уже заполненных параметрах API выбранного провайдера. Если токен доступа еще не был получен, то будет показана кнопка «Получить токен доступа», если уже был – «Очистить токен доступа». Очищать токен и впоследствии его перезапрашивать полезно в случаях перебоев в работе с API. Диагностируются перебои в разделе «Логи» админки.
Некоторые провайдеры дополняют общий набор опций своими.
Редактирование данных провайдера
Это действие доступно для провайдеров, созданных в админке, добавленных из каталога провайдеров или импортированных из файла YAML. Форма настроек такая же, как и при добавлении провайдера в админке. Редактированием полезно пользоваться в случаях, когда провайдер перестал работать (изменился алгоритм у сайта донора) и необходимо изменить регулярные выражения парсинга полей.
Удаление провайдера
Это действие, как и предыдущее, доступно для провайдеров, созданных в админке, добавленных из каталога провайдеров или импортированных из файла YAML. Удаление необратимое.
Экспорт провайдера
Это действие доступно для всех провайдеров, созданных в админке. При нажатии на иконку движок даёт сохранить специальный файл данных провайдера в формате YAML. Вы можете использовать это действие в качестве бэкапа своих провайдеров, можете поделиться этим файлом с другим клиентом InstantVideo.
Публикация провайдера в общем каталоге
Это действие доступно для провайдеров, созданных вами в админке. При нажатии «Опубликовать», провайдер будет опубликован в общем каталоге InstantVideo и станет доступен всем пользователям InstantVideo2 для установки. Это действие исключительно на ваше усмотрение, в случае если вы хотите поделиться своими наработками с сообществом.
Добавление провайдеров
В движке заложено три типа добавления провайдеров: инсталляция файла провайдера, импорт провайдера и добавление провайдера в админке.
Инсталляция провайдера
Инсталляция файла провайдера (обработчика) выполняется в три этапа:
- Загрузка файла-обработчика в директорию /system/controllers/video/providers/ вашего сайта;
- Перейти в админке по пути Компоненты => Ivideo => Провайдеры => Установить нового провайдера;
- Будет показан список доступных провайдеров для установки, необходимо кликнуть на название нужного.
Инсталляция завершена, и новый провайдер появится в общем списке.
Импорт провайдера
При помощи механизма импорта вы можете добавлять себе в движок новых провайдеров, которые вы получили файлом в формате YAML (расширение файла .yaml). Для добавления провайдера перейдите по пути Компоненты => Ivideo => Провайдеры => Импорт провайдера. В форме импорта выберите файл и нажмите «Импорт». Провайдер будет установлен. Через эту же форму вы можете обновлять существующих провайдеров, если добавляемая версия выше, чем установленная у вас.
Добавление провайдера
Этот механизм предполагает создание провайдера пошагово в админке. О том, как это делать, мы описали в отдельной статье.
Каталог провайдеров
Компоненты => Ivideo => Провайдеры => Каталог провайдеров
В этом разделе показан общедоступный для всех клиентов каталог провайдеров. В нём вы можете в один клик установить любого из доступных провайдеров. Каталог физически находится на нашем сервере, поэтому для его просмотра у вашего сервера должен быть выход в Интернет.
Каталог разделяет провайдеров на:
- Доступные для установки;
- Доступные для обновления;
- Обновление не требуется.
Провайдеры, для которых доступны обновления, также подсвечиваются (мигает версия) в общем списке провайдеров.
Опубликовать в каталог нового провайдера может каждый из клиентов при помощи кнопки «Опубликовать» – об этом было написано выше.