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" }
token^required	string	Токен авторизации API запросов. см. Mediaserver/Web API/Authorization/CreateApiToken
new-stream-uid^optional	uid	Уникальный идентификатор виртуальной камеры {@hint:uid}
stream-url^required	url	URL подключения к потоку или URL публикации потока см. Mediaserver/Конфигурирование/Поток (stream.ini)
stream-tracks^optional	array	Список каналов, разрешенных для захвата, вне зависимости от того, существует канал в потоке или нет.
stream-proto^optional	array	Протоколы, по которым клиенту разрешено подключаться к медиасерверу для просмотра потока.
stream-enable^optional	bool	Разрешено или запрещено подключение медиасервера к потоку (если запрещено, то воспроизведение и запись live и dvr недоступны).
dvr-enable^required	enum	Разрешает\Запрещает серверу записывать и хранить копию потока.
dvr-archive^required	path	Задает корневую директорию хранения DVR.
dvr-duration^required	seconds	Задает длительность хранения записи.
dvr-capacity^required	bytes	Ограничивает размер дискового пространства для записей. Параметр информационный. Физических ограничений не накладывает.
dvr-chunk^required	seconds	Задает длительность сегмента записи.
stream-access^required	string	Определяет тип авторизации клиентов при подключении к просмотру потока.
stream-whitelist^required	array	Список разрешенных IP-адресов, с которых могут производиться подключения к просмотру потока
stream-limit^required	int	Ограничивает максимальное количество одновременных подключений клиентов для просмотра потоков по всем видам протоколов.
reconnect-numbers^optional	int	Количество попыток переподключений. Лимит последовательных попыток переподключения к потоку, исчерпав который медиасервер пометит поток как недоступный и исключит из дальнейшего захвата.
reconnect-timeout^optional	seconds	Прогрессивная временная задержка между попытками подключения
reconnect-interval^optional	seconds	Максимальное значение прогрессивной задержки между подключениями
reconnect-invalid^optional	seconds
primary-node^optional	string	Если доступна функциональность кластера, то параметр задает первичную ноду захвата потока
secondary-node^optional	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"
}'