CreateStream
Создание и конфигурирование потока на медиасервере. Если отправить запрос с уже существующим индентификатором потока на сервере, то поток перезапустится с новыми конфигурационными параметрами: обрывается текущее и устанавливается новое соединение с источником, очищается состояние потока и буферов.
POST /streams/{new-stream-uid}/
Body | |||||||||
json |
JSON
| ||||||||
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
|