P2P LiveFree live streaming · peer-to-peer delivery

P2P Live — Руководство пользователя

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

Коротко: зарегистрируйтесь, вставьте адрес своего HLS-потока (ссылку .m3u8) — и вы получите публичную страницу https://p2p.gia.tv/ваше_имя и код для встраивания. Зрители этой страницы делятся видео друг с другом через свои браузеры, поэтому ваш стриминговый сервер или CDN отдаёт поток один раз, а не по разу на каждого зрителя.

Как это работает

На каждой странице канала стоит обычный HLS-плеер (hls.js), к которому подключён P2P-движок.

  1. Первый зритель канала загружает плейлист и сегменты видео с вашего исходного сервера (указанного адреса .m3u8) — точно так же, как любой другой плеер.
  2. Каждый следующий зритель открывает ту же страницу. Плееры находят друг друга через сервер сигнализации этого сайта (небольшой WebSocket-сервис) и соединяются напрямую, от браузера к браузеру, по каналам данных WebRTC.
  3. Каждый сегмент видео загружает с источника один зритель (лидер роя), а затем он пересылается остальным по P2P-соединениям. Если сегмент не пришёл от другого зрителя вовремя, плеер сам берёт его с источника, так что воспроизведение никогда не зависит от других зрителей.
  4. Каждый сегмент проверяется (хеш и анализ содержимого) перед тем, как попасть в плеер. Другой участник не может подмешать испорченные данные в воспроизведение зрителя.
  5. Плееры отправляют анонимную статистику (байты с источника, байты от других зрителей, остановки, подключённые участники), чтобы вы видели долю разгрузки в панели управления.

Что это значит для вас:

Требования

Ваш поток должен соответствовать этим требованиям. Кнопка Проверить поток сейчас в панели управления проверит большинство из них за вас.

ТребованиеЗачемКак проверить
HLS (плейлист .m3u8) по http:// или https://Плеер — это HLS-плеер. RTMP, RTSP, DASH, приём WebRTC и обычные файлы MP4 напрямую не поддерживаются.Откройте ссылку в браузере: должен загрузиться небольшой текстовый файл, начинающийся с #EXTM3U.
Заголовок CORS Access-Control-Allow-Origin: * (или ровно https://p2p.gia.tv) у плейлистов и сегментов, с каждого узла вашей CDNБез него браузеры отклоняют запросы с другого сайта. Без CORS поток не воспроизводится вообще, с P2P или без. Заголовок, где указан другой сайт, не подходит.Панель управления → Проверить поток сейчас → «CORS». Или curl -sI -H 'Origin: https://p2p.gia.tv' ВАША_ССЫЛКА и найдите заголовок.
https://, если ваши зрители используют https (этот сайт работает по https)Браузеры блокируют http://-медиа на https://-страницах (смешанное содержимое).Убедитесь, что ссылка начинается с https://.
Постоянные адреса сегментовУчастники обмениваются сегментами по имени. Если каждый зритель получает для одного и того же сегмента ссылку с другим именем (токены на зрителя, подсказки балансировщика вроде lb_backend_hint, абсолютные ссылки на меняющихся серверах), делиться не получится.Панель управления → Проверить поток сейчас → «Совместное использование». Или откройте медиаплейлист дважды: имена сегментов должны совпадать. Подписанные ссылки, одинаковые для всех зрителей, допустимы.
Длительность сегмента 2–10 сОчень короткие сегменты (< 1 с) увеличивают объём сигнализации; очень длинные (> 10 с) задерживают обмен между участниками.#EXT-X-TARGETDURATION в медиаплейлисте.
Кодеки: видео H.264, звук AAC или MP3 (сегменты TS или fMP4); H.265/HEVC — только там, где его поддерживает браузерДекодеры браузера.Через диагностический режим или проверку в панели управления.

Требования к источнику

Проверка загружает плейлист с этого сервера. CDN или источник, который по-разному обслуживает зрителей в зависимости от страны или сети (геоблокировка, защита от хотлинков, региональные узлы без заголовков CORS), может выглядеть здесь исправным и всё равно не работать у части зрителей. Такие зрители видят под плеером Ошибка потока — источник отказал этому зрителю: HTTP 403 …, а у вас та же причина появляется в разделе Администрирование → Аналитика в реальном времени (если вы администратор сайта). Спросите у зрителя, какая причина показана, или попросите журнал событий из диагностического режима.

CORS

Самая частая проблема — с большим отрывом. Ваш источник должен отправлять Access-Control-Allow-Origin: * (или ровно адрес сайта https://p2p.gia.tv) в каждом ответе: для главного плейлиста, медиаплейлистов и сегментов. Примеры:

nginx

location /live/ {
    add_header Access-Control-Allow-Origin * always;
    add_header Access-Control-Allow-Headers Range always;
    add_header Access-Control-Expose-Headers Content-Length always;
    types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; video/mp4 m4s mp4; }
}

Apache (.htaccess в каталоге HLS)

Header always set Access-Control-Allow-Origin "*"
Header always set Access-Control-Allow-Headers "Range"

Wowza Streaming Engine: Application → Properties → Custom → добавьте cupertinoUserHTTPHeaders = Access-Control-Allow-Origin: * (модуль cupertinostreaming) или используйте настройку CORS у HTTP-источника.

CDN (Cloudflare, Akamai, CloudFront, Bunny…): включите CORS в настройках источника или pull-зоны, указав * как разрешённый источник. В Cloudflare заголовок можно добавить через «Transform Rules → Response headers».

Проверка из командной строки (заголовок должен быть в выводе):

curl -sI -H "Origin: https://p2p.gia.tv" https://your-server.example.com/live/stream/playlist.m3u8 | grep -i access-control

Источники, которые хорошо работают

Регистрация

  1. Перейдите на https://p2p.gia.tv/signup.
  2. Выберите имя пользователя: 3–20 символов — строчные латинские буквы, цифры и подчёркивание. Оно станет вашим публичным адресом https://p2p.gia.tv/имя_пользователя, и изменить его потом нельзя.
  3. Укажите адрес эл. почты и пароль (не меньше 8 символов).
  4. При желании сразу вставьте адрес .m3u8 и название канала или добавьте их позже в панели управления.
  5. Примите Условия использования и Правила допустимого использования. У вас должны быть права на всё, что вы транслируете.
  6. Нажмите Создать канал. Вы сразу войдёте в систему и попадёте в панель управления.

На некоторых сайтах регистрация закрыта; в этом случае воспользуйтесь страницей контактов.

Панель управления

https://p2p.gia.tv/dashboard показывает:

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

Если сайт отправляет письма, после регистрации панель управления попросит вас подтвердить адрес эл. почты (см. Частые вопросы).

Настройки канала

Страница канала

https://p2p.gia.tv/имя_пользователя показывает плеер, название, описание, текущее число зрителей, ссылку для распространения, код для встраивания и небольшой блок диагностики.

Под видео есть строка состояния P2P:

СостояниеЗначение
P2P работаетЭтот зритель получает сегменты от других участников (или он лидер роя и раздаёт другим).
P2P: запускПодключён к сигнализации, ждёт других участников или первого общего сегмента. Нормально для первого зрителя и в первые 10–20 секунд.
P2P не работаетСм. текст рядом: WebRTC недоступен, встроенное воспроизведение (Safari на iOS), сигнализация недоступна или все участники не ответили. Видео продолжает идти с источника.

Страница никогда не блокирует воспроизведение из-за P2P. Если что-то пошло не так, зритель просто смотрит с источника.

Мобильные устройства: Chrome и Firefox на Android поддерживают P2P. Safari на iOS воспроизводит HLS встроенными средствами (без Media Source Extensions), поэтому iPhone и iPad всегда смотрят с источника и в P2P не участвуют. Safari на компьютере участвует.

Встраивание

Скопируйте код для встраивания из панели управления или со страницы канала:

<iframe src="https://p2p.gia.tv/embed/user_name" width="854" height="480" frameborder="0" scrolling="no"
        allow="autoplay; encrypted-media; fullscreen; picture-in-picture" allowfullscreen></iframe>

Варианты:

<div style="position:relative;aspect-ratio:16/9;max-width:960px">
  <iframe src="https://p2p.gia.tv/embed/user_name" style="position:absolute;inset:0;width:100%;height:100%;border:0"
          allow="autoplay; encrypted-media; fullscreen; picture-in-picture" allowfullscreen></iframe>
</div>

Плеер без оформления сайта доступен по адресам https://p2p.gia.tv/?src=ВАШ_M3U8 (рабочий) и https://p2p.gia.tv/debug.html?src=ВАШ_M3U8 (диагностика). Они используют тот же P2P-движок и тот же рой, что и страница канала, потому что рой определяется по адресу потока.

Проверка

Чтобы увидеть P2P, нужны два плеера: один зритель всегда загружает с источника.

  1. Откройте страницу канала в одном браузере (например, Chrome). Дождитесь, пока пойдёт видео.
  2. Откройте ту же страницу во втором браузере (Firefox, Edge, другой профиль Chrome, окно инкогнито или другой компьютер/телефон в любой сети).
  3. Примерно через 10–20 секунд строка состояния второго плеера должна показать P2P работает. Первый становится лидером и показывает, что раздаёт другим.
  4. Для подробностей откройте ссылку Диагностический режим (также https://p2p.gia.tv/debug.html?src=ВАШ_M3U8). Там видно каждый сегмент и его источник (ORIGIN или PEER), подключённых участников, байты в каждом направлении, состояние сигнализации, итоговый вывод о том, почему P2P работает или нет, и встроенную инструкцию по проверке.

Примечания:

Ограничения

ПараметрЗначениеПримечание
Каналов на учётную запись1Для других потоков создайте другие учётные записи.
Зрителей на канал (рой)по умолчанию до 500Задаёт администратор. Сверх лимита новые зрители по-прежнему смотрят с источника, но без P2P.
Участников на зрителядо 12Управляется автоматически (сайт может изменить это число).
Длина адреса потока1024 символа
Название / описание120 / 600 символов
Нагрузка на источникот 1 до нескольких полных загрузок на ройЛидер плюс зрители, у которых слишком медленные соседи.
Отдача плеераограничена на участника и в целомЗрители с медленной отдачей автоматически раздают меньше.

Решение проблем

«Поток не в эфире» в панели управления / видео нет совсем

У меня воспроизводится, а у зрителя в другой стране — нет

В VLC воспроизводится, а в браузере — нет

«P2P не работает: сигнализация недоступна»

«P2P не работает: нет WebRTC» / «встроенное воспроизведение»

«P2P: запуск» не проходит при двух зрителях

Видео останавливается / подгружается

Мой канал не показывается на главной

Встроенный плеер показывает чёрный экран

Я забыл пароль

Я сменил адрес эл. почты, а в настройках всё ещё старый

Частые вопросы

Моё видео записывается или ретранслируется? Нет. Сайт только знакомит плееры друг с другом. Видео браузеры зрителей берут с вашего источника и передают друг другу. На сервере ничего не хранится.

Можно ли использовать поток другого поставщика (например, мой канал Tulix/SSH101)? Да, если у вас есть право его распространять и источник отправляет заголовки CORS. Пример интеграции — на странице каталога SSH101.

Это бесплатно? Да. Сервис предоставляется «как есть» на условиях, описанных в Условиях использования. Злоупотребления (нарушение авторских прав, незаконные материалы) ведут к блокировке; см. Правила допустимого использования.

Сколько у меня может быть зрителей? Столько, сколько ваш источник смог бы обслужить без P2P при примерно 5–20 % нагрузки. На практике на каждый канал действует лимит роя, заданный администратором (по умолчанию 500).

Видят ли зрители друг друга? Только технически (IP-адреса внутри WebRTC, как в любом P2P-видеосервисе). Ни имён, ни чата, ни истории.

Какие браузеры? Chrome, Edge, Firefox, Opera, Brave (с разрешённым WebRTC), Safari на компьютере, Chrome/Firefox на Android. Safari на iOS воспроизводит без P2P.

Работает ли с DRM / зашифрованным HLS? Плейлисты с шифрованием AES-128 работают (сегменты передаются в зашифрованном виде; каждый зритель получает ключ с вашего сервера ключей). DRM FairPlay/Widevine не поддерживаются.

Можно ли изменить имя пользователя? Нет, это постоянный адрес вашей страницы. Для нового имени создайте новую учётную запись.

Можно ли удалить учётную запись? Да: Настройки → Удаление учётной записи, с текущим паролем. Учётная запись и страница канала удаляются сразу, текущие зрители отключаются, а на ваш адрес эл. почты приходит уведомление. Отменить это нельзя. (Учётные записи администраторов удаляет другой администратор.)

Почему панель управления просит подтвердить адрес эл. почты? Если сайт отправляет письма, новые учётные записи получают ссылку для подтверждения (действует 7 дней). Откройте её и нажмите Подтвердить; кнопка Отправить ссылку ещё раз в панели управления присылает новую (до 3 в час). Некоторые сайты показывают канал на главной только после подтверждения адреса.

Контакты

Вопросы и жалобы на нарушения: страница контактов · эл. почта: info@tulix.com · нарушения/DMCA: https://p2p.gia.tv/report.