Skip to main content
Skip table of contents

CreateStream

Создание и конфигурирование потока на медиасервере. Если отправить запрос с уже существующим индентификатором потока на сервере, то поток перезапустится с новыми конфигурационными параметрами: обрывается текущее и устанавливается новое соединение с источником, очищается состояние потока и буферов.

POST /streams/{new-stream-uid}/
Body
json
JSON
{
    "primary-node": "node-host-1",
    "secondary-node": "node-host-2",
    "stream-enable": true,
    "stream-url": "rtsp://admin:admin@192.168.7.34:554/Streaming/Channels/101",
    "stream-proto": "rtsp,hls",
    "stream-tracks": "video,audio",
    "stream-limit": 0,
    "stream-access": "public",
    "stream-whitelist": "",
    "reconnect-numbers": 500,
    "reconnect-timeout": "10s",
    "reconnect-interval": "30m",
    "reconnect-invalid": 10,
    "dvr-enable": true,
    "dvr-archive": "/storage",
    "dvr-duration": "3d",
    "dvr-capacity": "10G",
    "dvr-chunk": "2m"
}
tokenrequired
string
Токен авторизации API запросов. см. Mediaserver/Web API/Authorization/CreateApiToken
new-stream-uidoptional
uid
Уникальный идентификатор виртуальной камеры {@hint:uid}
stream-urlrequired
url
URL подключения к потоку или URL публикации потока см. Mediaserver/Конфигурирование/Поток (stream.ini)
stream-tracksoptional
array
Список каналов, разрешенных для захвата, вне зависимости от того, существует канал в потоке или нет.
stream-protooptional
array
Протоколы, по которым клиенту разрешено подключаться к медиасерверу для просмотра потока.
stream-enableoptional
bool
Разрешено или запрещено подключение медиасервера к потоку (если запрещено, то воспроизведение и запись live и dvr недоступны).
dvr-enablerequired
enum
Разрешает\Запрещает серверу записывать и хранить копию потока.
dvr-archiverequired
path
Задает корневую директорию хранения DVR.
dvr-durationrequired
seconds
Задает длительность хранения записи.
dvr-capacityrequired
bytes
Ограничивает размер дискового пространства для записей. Параметр информационный. Физических ограничений не накладывает.
dvr-chunkrequired
seconds
Задает длительность сегмента записи.
stream-accessrequired
string
Определяет тип авторизации клиентов при подключении к просмотру потока.
stream-whitelistrequired
array
Список разрешенных IP-адресов, с которых могут производиться подключения к просмотру потока
stream-limitrequired
int
Ограничивает максимальное количество одновременных подключений клиентов для просмотра потоков по всем видам протоколов.
reconnect-numbersoptional
int
Количество попыток переподключений. Лимит последовательных попыток переподключения к потоку, исчерпав который медиасервер пометит поток как недоступный и исключит из дальнейшего захвата.
reconnect-timeoutoptional
seconds
Прогрессивная временная задержка между попытками подключения
reconnect-intervaloptional
seconds
Максимальное значение прогрессивной задержки между подключениями
reconnect-invalidoptional
seconds
primary-nodeoptional
string
Если доступна функциональность кластера, то параметр задает первичную ноду захвата потока
secondary-nodeoptional
string
Если доступна функциональность кластера, то параметр задает вторичную (резервную) ноду захвата потока
Response
200
Поток успешно создан
403
Ошибка авторизации. Неверный или отсутствует токен доступа к API см. Mediaserver/Web API/Authorization/CreateApiToken
Пример
JSON
curl -k --location --request POST 'https://localhost:8080/streams/{new-stream-uid}/?token=string' \
--header 'Content-Type: application/json \
--data-raw '{
    "primary-node": "node-host-1",
    "secondary-node": "node-host-2",
    "stream-enable": true,
    "stream-url": "rtsp://admin:admin@192.168.7.34:554/Streaming/Channels/101",
    "stream-proto": "rtsp,hls",
    "stream-tracks": "video,audio",
    "stream-limit": 0,
    "stream-access": "public",
    "stream-whitelist": "",
    "reconnect-numbers": 500,
    "reconnect-timeout": "10s",
    "reconnect-interval": "30m",
    "reconnect-invalid": 10,
    "dvr-enable": true,
    "dvr-archive": "/storage",
    "dvr-duration": "3d",
    "dvr-capacity": "10G",
    "dvr-chunk": "2m"
}'
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.