...
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 или MPEG-TS потока | UDP |
| cvoExtension | Используется ли WebRTC расширение для ориентации картинки | false |
| createDate | Дата создания потока | 1616730493789 |
| mediaType | Тип потока: публикация или воспроизведение | publish |
| mediaProvider | Способ публикации или проигрывания (Flash для RTMP) | Flash |
| minBitrate | Параметры транскодера, созданного по REST API | |
| maxBitrate | ||
| quality | ||
| gop | ||
| fps | ||
| audioBitrate | ||
| codecImpl |
Отображение параметров аудио кодека
В сборке 5.2.1619 добавлено отображение частоты дискретизации и количества каналов аудио дорожки:
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
...,
"name": "stream1",
...,
"audioCodec": "mpeg4-generic/48000/2",
"videoCodec": "H264",
...
} |
Если аудио в потоке нет, audioCodec не отображается.
Отображение статистики восстановления аудио пакетов
В сборке 5.2.2066 добавлено отображение статистики восстановления аудио пакетов по запросу
| Code Block | ||||
|---|---|---|---|---|
| ||||
POST /rest-api/stream/find HTTP/1.1
Host: localhost:8081
Content-Type: application/json
{
"name":"stream1",
"published":true,
"display":["red"]
} |
Пример статистики для опубликованного потока
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
...,
"name": "stream1",
...,
"red": {
"output": {
"totalRedundantBytes": 0,
"totalRedundantPackets": 0
},
"input": {
"totalRedundantBytes": 862151,
"usedRedundantBytes": 24115,
"totalRedundantPackets": 24633,
"usedRedundantPackets": 689
}
}
} |
Здесь:
- totalRedundantBytes - количество байтов избыточной информации для восстановления аудиоданных
- usedRedundantBytes - количество использованных байтов избыточной информации
- totalRedundantPackets - количество пакетов избыточной информации для восстановления аудиоданных
- usedRedundantPackets - количество использованных пакетов избыточной информации
Статистика будет ненулевой только в том случае, если включена поддержка избыточности для восстановления потерянного аудио (RED)
| Code Block | ||
|---|---|---|
| ||
codecs=red,opus,... |
Получение метрик потока
Доступные метрики
Метрика | Описание |
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 | Аудиокодек |
...