Поддерживаемые кодеки

H.264
VP8
H265 (начиная со сборки 5.2.1579)
AAC
G.711
Speex

Поддерживаемые платформы и браузеры

...

Code Block

theme	RDark

h264_check_and_skip_annexb=true

Начиная со сборки 5.2.946, данная опция удалена из настроек, и фреймы в AnnexB формате определяются и проигрываются автоматически.

Исключение аудио кодеков

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

...

Кодеки исключаются на уровне SDP, по названиям.

Краткое руководство по тестированию

Захват видеопотока с IP-камеры и трансляция в браузер

1. Для теста используем:

демо-сервер demo.flashphoner.com;
веб-приложение Player для захвата и воспроизведения потока

2. Откройте веб-приложение Player, укажите в поле "Stream" URL веб-камеры:

Image Removed

3. Нажмите кнопку "Start". Начнется трансляция захваченного потока.

Image Removed

4. Графики WebRTC internals:

Image Removed

Управление захватом видеопотока с IP-камеры при помощи REST API

Как правило, для захвата потока с IP-камеры достаточно указать URL-камеры в качестве имени потока при его создании. Однако, при необходимости, возможно управлять захватом RTSP-потока при помощи REST API.

Тестирование

1. Для теста используем:

...

Установка режима пакетизации H264

По умолчанию, согласно спецификации H264, если в SDP потока не указан явно режим пакетизации, он присваивается равным 0. Однако, некоторые RTSP камеры могут передавать поток, закодированный в режиме пакетизации 1, и при этом не указывать режим в SDP потока. Это приводит к включению транскодинга и снижению качества картинки в браузере Safari.

В сборке 5.2.820 добавлена возможность установить режим пакетизации по умолчанию для использования таких камер при помощи настройки

Code Block

theme	RDark

default_packetization_mode=1

Краткое руководство по тестированию

Захват видеопотока с IP-камеры и трансляция в браузер

1. Для теста используем:

демо-сервер demo.flashphoner.com;
веб-приложение Player для захвата и воспроизведения захваченного потока в браузере.

2. Откройте REST-клиент. Отправьте запрос /rtsp/startup, указав в параметрах веб-приложение Player, укажите в поле "Stream" URL веб-камеры:

Image RemovedImage Added

3. Убедитесь, что поток захвачен сервером. Для этого отправьте запрос /rtsp/find_all:

Image Removed

4. Откройте веб-приложение Player, укажите в поле "Stream" URL веб-камеры и нажмите Start. Начнется воспроизведение потока в браузере:

Image Removed

5. Отправьте запрос /rtsp/terminate, указав в параметрах URL веб-камеры:

Image Removed

6. Воспроизведение потока прервется с ошибкой:

Image Removed

REST-вызовы

REST-запрос должен быть HTTP/HTTPS POST запросом в таком виде:

HTTP: http://test.flashphoner.com:8081/rest-api/rtsp/startup
HTTPS: https://test.flashphoner.com:8444/rest-api/rtsp/startup

Здесь:

test.flashphoner.com - адрес WCS-сервера
8081 - стандартный REST / HTTP порт WCS-сервера
8444 - стандартный HTTPS порт
rest-api - обязательная часть URL
/rtsp/startup - используемый REST-метод

REST-методы и статусы ответа

...

REST-метод

...

Пример тела REST-запроса

...

Пример тела REST-ответа

...

Статусы ответа

...

Описание

...

/rtsp/startup

...

Code Block

language	js
theme	RDark

{
 "uri":"rtsp://myserver.com/live/myStream",
 "localStreamName": "myRTSPstream"
}

409 - Conflict

500 - Internal error

Извлечь RTSP-поток по указанному URL

...

/rtsp/find_all

Нажмите кнопку "Start". Начнется трансляция захваченного потока.

Image Added

4. Графики WebRTC internals:

Image Added

Управление захватом видеопотока с IP-камеры при помощи REST API

Как правило, для захвата потока с IP-камеры достаточно указать URL-камеры в качестве имени потока при его создании. Однако, при необходимости, возможно управлять захватом RTSP-потока при помощи REST API.

Тестирование

1. Для теста используем:

демо-сервер demo.flashphoner.com;
браузер Chrome и REST-клиент для отправки запросов на сервер;
веб-приложение Player для воспроизведения захваченного потока в браузере.

2. Откройте REST-клиент. Отправьте запрос /rtsp/startup, указав в параметрах URL веб-камеры:

Image Added

3. Убедитесь, что поток захвачен сервером. Для этого отправьте запрос /rtsp/find_all:

Image Added

4. Откройте веб-приложение Player, укажите в поле "Stream" URL веб-камеры и нажмите Start. Начнется воспроизведение потока в браузере:

Image Added

5. Отправьте запрос /rtsp/terminate, указав в параметрах URL веб-камеры:

Image Added

6. Воспроизведение потока прервется с ошибкой:

Image Added

REST-вызовы

REST-запрос должен быть HTTP/HTTPS POST запросом в таком виде:

HTTP: http://test.flashphoner.com:8081/rest-api/rtsp/startup
HTTPS: https://test.flashphoner.com:8444/rest-api/rtsp/startup

Здесь:

test.flashphoner.com - адрес WCS-сервера
8081 - стандартный REST / HTTP порт WCS-сервера
8444 - стандартный HTTPS порт
rest-api - обязательная часть URL
/rtsp/startup - используемый REST-метод

REST-методы и статусы ответа

REST-метод

Пример тела REST-запроса

Пример тела REST-ответа

Статусы ответа

Описание

/rtsp/startup

Code Block

language	js
theme	RDark

{
 "uri": "rtsp://myserver.com/live/myStream",
"status": "PLAYING",
" "localStreamName": "myRTSPstream"
}

200 – потоки найдены

404 – потоки не найдены

Найти все извлеченные RTSP-потоки409 - Conflict

500 - Internal error

Извлечь RTSP-поток по указанному URL

/rtsp/terminatefind_all

Code Block

language	js
theme	RDark

{
"uri": "rtsp://myserver.com/live/myStream",
"status": "PLAYING",
"localStreamName": "myRTSPstream"
}

200 - поток завершен– потоки найдены

404 - поток – потоки не найденЗавершить извлеченный найдены

Найти все извлеченные RTSP-поток

Параметры

потоки

/rtsp/terminate

Code Block

language	js
theme	RDark

{
"uri":"rtsp://myserver.com/live/myStream"
}

200 - поток завершен

404 - поток не найден

Завершить извлеченный RTSP-поток

Параметры

Имя параметра	Описание	Пример
uri	URL RTSP-потока	rtsp://myserver.com/live/myStream
localStreamName	Имя, которое будет присвоено извлеченному потоку	myRTSPstream
status	Текущий статус потока	PLAYING

...

Если захваченному RSTP потоку назначено имя, этот поток может быть воспроизведен по имени в CDN (по умолчанию, для RTSP потоков эта функция недоступна, т.к. они захватываются локально). они захватываются локально).

Захват H265 RTSP потока

В сборке 5.2.1579 добавлена возможность захвата RTSP потока, публикуемого камерой в кодеке H265. Для этого H265 должен быть добавлен в список поддерживаемых кодеков

Code Block

theme	RDark

codecs=opus,alaw,ulaw,g729,speex16,g722,mpeg4-generic,telephone-event,h264,vp8,flv,mpv,h265

и в списки исключений

Code Block

theme	RDark

codecs_exclude_sip=mpeg4-generic,flv,mpv,h265
codecs_exclude_sip_rtmp=opus,g729,g722,mpeg4-generic,vp8,mpv,h265
codecs_exclude_sfu=alaw,ulaw,g729,speex16,g722,mpeg4-generic,telephone-event,flv,mpv,h265

Захваченный поток может быть проигран как WebRTC, RTMP, MSE, HLS с транскодингом и как RTSP без транскодинга

Warning
Поток не должен содержать B-фреймы! Если в потоке есть B-фреймы, его можно проигрывать только по RTSP без транскодинга

Проблема первого подписчика

До сборки 5.2.1760 RTSP потоки могли долго начинать играть у первого подписчика. Это было вызвано тем, что процесс подписчика стартовал позде процесса публикации, и мог пропускать первые ключевые кадры. В сборке 5.2.1760 это поведение изменено: процесс публикации стартует после процесса подписчика. При необходимости, можно вернуться к старому варианту при помощи настройки

Code Block

theme	RDark

agent_use_subscriber_listener=false

Исправление временных меток в потоке

В некоторых RTSP потоках временные метки могут идти не в нужном порядке, например, у двух кадров подряд может быть одинаковая метка. При проигрывании такого потока по WebRTC поток может долго не отображаться, и периодически давать серый фон. Для исправления таких временных меток, в сборке 5.2.1794 добавлена настройка

Code Block

theme	RDark

jitter_buffer_attempt_to_correct_broken_timestamp=true

В этом случае в клиентском логе будут сообщения

Code Block

language	text
theme	RDark

Non-monotonous timestamp in input stream; previous: 453424, current: 453424; changing to 453425. This may result in incorrect timestamps in the output

и проблемный поток будет играть нормально.

Известные проблемы

Excerpt Include

	С другого сервера по RTMP
	С другого сервера по RTMP
nopanel	true

...

Code Block

theme	RDark

streams_synchronization=camera1/-21800;camera2/2079600704

Решение: в сборках до 5.2.1775 увеличить буфер синхронизации для аудио и видео

Code Block

theme	RDark

audio_incoming_buffer_size=100
video_incoming_buffer_size=100

начиная со сборки 5.2.1775 увеличить интервал принудительной синхронизации для аудио и видео

Code Block

theme	RDark

video_force_sync_timeout=1000
audio_force_sync_timeout=1000

Space shortcuts

Page tree

Versions Compared

Old Version 17

New Version Current

Key

Поддерживаемые кодеки

Поддерживаемые платформы и браузеры

Исключение аудио кодеков

Краткое руководство по тестированию

Захват видеопотока с IP-камеры и трансляция в браузер

Управление захватом видеопотока с IP-камеры при помощи REST API

Тестирование

Установка режима пакетизации H264

Краткое руководство по тестированию

Захват видеопотока с IP-камеры и трансляция в браузер

REST-вызовы

REST-методы и статусы ответа

Управление захватом видеопотока с IP-камеры при помощи REST API

Тестирование

REST-вызовы

REST-методы и статусы ответа

Параметры

Параметры

Захват H265 RTSP потока

Проблема первого подписчика

Исправление временных меток в потоке

Известные проблемы

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 17

New Version Current

Key

Поддерживаемые кодеки

Поддерживаемые платформы и браузеры

Исключение аудио кодеков

Краткое руководство по тестированию

Захват видеопотока с IP-камеры и трансляция в браузер

Управление захватом видеопотока с IP-камеры при помощи REST API

Тестирование

Установка режима пакетизации H264

Краткое руководство по тестированию

Захват видеопотока с IP-камеры и трансляция в браузер

REST-вызовы

REST-методы и статусы ответа

Управление захватом видеопотока с IP-камеры при помощи REST API

Тестирование

REST-вызовы

REST-методы и статусы ответа

Параметры

Параметры

Захват H265 RTSP потока

Проблема первого подписчика

Исправление временных меток в потоке

Известные проблемы