WCS поддерживает мониторинг параметров публикации и воспроизведения потока в реальном времени при помощи REST API
Запрос /stream/find позволяет найти поток по заданным условиям фильтрации и получить общую информацию о нем. В сборке 5.2.923 также могут быть запрошены метрики потока.
REST-запрос должен быть HTTP/HTTPS POST запросом в таком виде:
Здесь:
REST-метод | Пример тела REST-запроса | Пример тела REST-ответа | Статусы ответа | ||
---|---|---|---|---|---|
/stream/find |
|
| 200 - Данные получены 404 - Поток не найден 500 - Неверные параметры запроса |
Имя параметра | Описание | Пример |
---|---|---|
display | Дополнительные параметры, которые должны быть отображены в ответе | ["metrics"] |
mediaSessionId | Идентификатор медиасессии | 6af0baf1-f014-48d6-b285-c975951a402f |
name | Имя потока | stream1 |
published | Публикация или воспроизведение | true |
hasVideo | Есть ли видео в потоке? | true |
hasAudio | Есть ли аудио в потоке? | true |
status | Статус потока | PUBLISHING |
sdp | SDP потока | |
audioCodec | Аудио кодек | mpeg4-generic |
videoCodec | Видео кодек | H264 |
record | Ведется ли запись потока | false |
width | Ширина картинки, с которой опубликован поток | 640 |
height | Высота картинки, с которой опубликован поток | 360 |
transport | Используемый транспорт WebRTC потока | UDP |
cvoExtension | Используется ли WebRTC расширение для ориентации картинки | false |
createDate | Дата создания потока | 1616730493789 |
mediaType | Тип потока: публикация или воспроизведение | publish |
mediaProvider | Способ публикации или проигрывания (Flash для RTMP) | Flash |
minBitrate | Параметры транскодера, созданного по REST API | |
maxBitrate | ||
quality | ||
gop | ||
fps | ||
audioBitrate | ||
codecImpl |
Метрика | Описание |
VIDEO_HEIGHT | Высота видео |
VIDEO_WIDTH | Ширина видео |
VIDEO_RATE | Битрейт видео |
VIDEO_SYNC | Синхронизация видео |
VIDEO_FPS | Частота кадров видео |
VIDEO_NACK | Количество NACK-запросов |
VIDEO_PLI | Количество PLI-пакетов |
VIDEO_CODEC | Видеокодек |
VIDEO_K_FRAMES | Количество ключевых кадров (I-frames) видео |
VIDEO_P_FRAMES | Количество P-кадров видео |
VIDEO_B_FRAMES | Количество B-кадров видео |
VIDEO_GOP_SIZE | Количество кадров в последней группе между ключевыми кадрами |
VIDEO_LOST | Количество потерянных пакетов видео |
AUDIO_SYNC | Синхронизация аудио |
AUDIO_RATE | Битрейт аудио |
AUDIO_LOST | Количество потерянных пакетов аудио |
AUDIO_CODEC | Аудиокодек |
REST-запрос должен быть HTTP/HTTPS POST запросом в таком виде:
Здесь:
REST-метод | Пример тела REST-запроса | Пример тела REST-ответа | Статусы ответа | |||
---|---|---|---|---|---|---|
/stream/metrics |
или
|
| 200 - Метрики потока получены 404 - Поток не найден |
Имя параметра | Описание | Пример |
---|---|---|
mediaSessionId | Идентификатор медиасессии | 72b76eb8-3c01-47f3-b308-a0516d51249b |
name | Имя потока | testStream |