Описание
В сборке 5.2.1193 добавлена возможность публикации MPEG-TS RTP потока по UDP на WCS. Данный способ может быть удобен для публикации H264+ACC потока из программного или аппаратного кодировщика, поддерживающего MPEG-TS.
Поддержка кодеков
- H264
- AAC
Схема работы
1. Публикующий клиент отправляет REST API запрос /mpegts/startup
2. Публикующий клиент получает ответ 200 OK c URI для публикации потока
3. Поток публикуется на WCS по указанному URI
4. Браузер устанавливает соединение по Websocket и отправляет команду play.
5. Браузер получает WebRTC поток и воспроизводит этот поток на странице.
Тестирование
1. Для теста используем:
- WCS сервер
- ffmpeg для публикации MPEG-TS потока
- веб-приложение Player в браузере Chrome для воспроизведения потока
2. Отправляем запрос /mpegts/startup
с указанием имени потока test
curl -H "Content-Type: application/json" -X POST http://test1.flashphoner.com:8081/rest-api/mpegts/startup -d '{"localStreamName":"test"}'
Здесь test1.flashphoner.com
- адрес WCS сервера
3. Получаем от сервера ответ 200 OK
{ "localMediaSessionId": "32ec1a8e-7df4-4484-9a95-e7eddc45c508", "localStreamName": "test", "uri": "udp://test1.flashphoner.com:31006", "status": "CONNECTED", "hasAudio": true, "hasVideo": true, "record": false, "timeout": 90000, "maxTimestampDiff": 90000 }
4. Публикуем MPEG-TS поток по указанному URI
ffmpeg -re -i bunny360p.mp4 -c:v libx264 -c:a aac -b:a 160k -bsf:v h264_mp4toannexb -keyint_min 60 -profile:v baseline -preset veryfast -f mpegts "udp://test1.flashphoner.com:31006?pkt_size=1316"
5. Открываем веб-приложение Player. Укажите в поле "Stream" имя потока test
и нажмите кнопку "Start". Начнется трансляция опубликованного потока
Настройки
Остановка публикации при отсутствии медиаданных
По умолчанию, публикация MPEG-TS потока будет остановлена на стороне сервера, если сервер не получает медиаданных в течение 90 секунд. Это время задается настройкой в миллисекундах
mpegts_stream_timeout=90000
Отключение подписчиков при остановке передачи данных от публикующего клиента
Если публикующий клиент по какой-то причине остановил передачу медиаданных, а затем возобновил (например, перезапустил ffmpeg), нарушается последовательность временных меток кадров потока. Такой поток не может быть корректно воспроизведен по WebRTC. В связи с этим, если зафиксировано нарушение последовательности временных меток для публикуемого MPEG TS потока, все подписчики принудительно отключаются, и должны заново подключиться к нему. Максимально допустимое изменение двух соседних временных меток задается настройкой в секундах
mpegts_max_pts_diff=1
REST API
REST-запрос должен быть HTTP/HTTPS POST запросом в таком виде:
- HTTP: http://test.flashphoner.com:8081/rest-api/mpegts/startup
- HTTPS: https://test.flashphoner.com:8444/rest-api/mpegts/startup
Здесь:
- test.flashphoner.com - адрес WCS-сервера
- 8081 - стандартный REST / HTTP порт WCS-сервера
- 8444 - стандартный HTTPS порт
- rest-api - обязательная часть URL
- /mpegts/startup - используемый REST-метод
REST-методы и статусы ответа
REST-метод | Пример тела REST-запроса | Пример тела REST-ответа | Статусы ответа | Описание |
---|---|---|---|---|
/mpegts/startup | { "localStreamName":"test" } | { "localMediaSessionId": "32ec1a8e-7df4-4484-9a95-e7eddc45c508", "localStreamName": "test", "uri": "udp://192.168.1.39:31006", "status": "CONNECTED", "hasAudio": true, "hasVideo": true, "record": false, "timeout": 90000, "maxTimestampDiff": 90000 } | 200 - OK 409 - Conflict 500 - Internal error | Начать публикацию MPEG-TS потока |
/mpegts/find_all | [ { "localMediaSessionId": "32ec1a8e-7df4-4484-9a95-e7eddc45c508", "localStreamName": "test", "uri": "udp://192.168.1.39:31006", "status": "CONNECTED", "hasAudio": true, "hasVideo": true, "record": false, "timeout": 90000, "maxTimestampDiff": 90000 } ] | 200 – потоки найдены 404 – потоки не найдены 500 - Internal error | Найти все опубликованные MPEG-TS потоки | |
/mpegts/terminate | { "localStreamName":"test" } | 200 - поток завершен 404 - поток не найден 500 - Internal error | Завершить MPEG-TS поток |
Параметры
Имя параметра | Описание | Пример |
---|---|---|
localStreamName | Имя, которое будет присвоено опубликованному потоку | test |
uri | URI для публикации потока | udp://192.168.1.39:31006 |
localMediaSessionId | Идентификатор медиасессии потока | 32ec1a8e-7df4-4484-9a95-e7eddc45c508 |
status | Статус потока | CONNECTED |
hasAudio | Поток содержит аудио | true |
hasVideo | Поток содержит видео | true |
record | Поток записывается | false |
timeout | Максимальное время ожидания медиаданных, мс | 90000 |
maxTimestampDiff | Максимально допустимое изменение метки времени, мс | 90000 |
Известные проблемы
1. Если публикация MPEG-TS потока была остановлена на стороне сервера по REST API /mpegts/terminate
, публикующий кодировщик продолжает отправлять медиаданные
Симптомы: при остановке публикации MPEG-TS потока на сервера ffmpeg продолжает отправлять данные по UDP
Решение: это ожидаемое поведение, поскольку самим протоколом не предусмотрены никакие оповещения отправляющей стороны о том. что порт, принимающий данные, уже закрыт