Трансляция Facecast и HLS-поток

Кратко

В мобильное приложение мероприятия и в личный кабинет участника можно встроить стороннюю видеотрансляцию. Event Rocks поддерживает два способа:

Прямая ссылка на HLS-поток (.m3u8). В этом случае в мобильном приложении работает режим «картинка в картинке».
Встраивание плеера целиком через iframe. Подходит, когда нужны элементы управления провайдера, чат или защита ключом.

Когда использовать

Сценарий	Рекомендуемый способ
Нужно только проигрывать видео, без чата и кнопок провайдера	HLS-ссылка `.m3u8`
Участники смотрят трансляцию с телефона и параллельно листают расписание	HLS-ссылка — работает «картинка в картинке»
Нужен встроенный чат, донат, регистрация зрителя на стороне провайдера	iframe плеера
Трансляция защищена ключом доступа	iframe плеера с параметром `key`
У подрядчика собственный сервер и он выдаёт HLS	HLS-ссылка

Как настроить

Способ 1. Подключить HLS-поток ссылкой

Получите у подрядчика публичную ссылку на манифест HLS. Она должна заканчиваться на .m3u8.

Пример ссылки:
```
https://cdn-1.facecast.net/public/60869/1080p.m3u8
```
Добавьте эту ссылку в настройках трансляции в административной панели Event Rocks.
Проверьте воспроизведение в мобильном приложении. Видео должно сворачиваться в плавающее окно поверх других экранов — это режим «картинка в картинке».

Трансляция в режиме «картинка в картинке» в мобильном приложении

Способ 2. Встроить плеер Facecast iframe-ом

Скопируйте публичную ссылку на трансляцию в Facecast. Формат ссылки:
```
https://facecast.net/w/w2jqkr
```
В административной панели откройте поле «Настройки трансляции в формате JSON» и вставьте конфиг:
```
{
  "frameUrl": "https://facecast.net/w/w2jqkr"
}
```
Если трансляция защищена ключом, добавьте параметр key в адрес и в конфиг:
```
https://facecast.net/w/wfqidc?key=i2ovjv3i
```
```
{
  "frameUrl": "https://facecast.net/w/wfqidc?key=i2ovjv3i"
}
```

Примеры использования

Конференция на 1000 участников. Организатор берёт у видеопродакшна HLS-ссылку и вставляет её в приложение. Участники листают расписание и параллельно слушают пленарный доклад в «картинке в картинке».
Закрытое заседание совета директоров. Используется Facecast с ключом доступа. В приложение встраивается iframe, ссылка на стрим отправляется только приглашённым.
Выставка со стендами. Для каждого стенда своя HLS-ссылка, зрители переключаются между презентациями, не выходя из приложения.

Ограничения и нюансы

Публичные сервисы HLS платные. Бесплатных поставщиков с публичной ссылкой на .m3u8 нет. Если бюджета на подписку нет, попросите подрядчика поднять собственный сервер, который отдаст поток в HLS.
«Картинка в картинке» доступна только в мобильном приложении. В веб-версии личного кабинета HLS-ссылка воспроизводится обычным плеером без сворачивания.
iframe-встраивание не поддерживает режим «картинка в картинке». Если нужен этот режим, используйте первый способ со ссылкой.
Защита ключом работает только для Facecast через iframe. В способе с HLS-ссылкой защита потока ложится на провайдера — на стороне Event Rocks ключ не проверяется.
Качество и стабильность зависят от провайдера. Перед публикацией трансляции в приложении сделайте тестовый прогон: проверьте запуск на iOS и Android, на разных скоростях интернета и при уходе экрана в фон.

Связанные статьи

Видеотрансляции: обзор раздела
Подключение YouTube и VK Видео
Настройка расписания докладов
Личный кабинет участника