...
- HTTP: http://streaming.flashphoner.com:8081/rest-api/streamrecorder/startRecordingstartup
- HTTPS: https://streaming.flashphoner.com:8444/rest-api/streamrecorder/startRecordingstartup
Здесь:
- streaming.flashphoner.com - адрес WCS-сервера
- 8081 - стандартный REST / HTTP порт WCS-сервера
- 8444 - стандартный HTTPS порт
- rest-api - обязательный префикс
- /streamrecorder/startRecording startup - используемый REST-вызов
...
REST-метод | Пример тела REST-запроса | Пример тела REST-ответа | Статусы ответа | Описание | |||||||
---|---|---|---|---|---|---|---|---|---|---|---|
/stream/startRecording, /recorder/startup |
| 404 - Not found 500 - Internal error | Начать запись потока в указанной медиасессии | ||||||||
/stream/stopRecording, /recorder/terminate |
| 404 - Not found 500 - Internal error | Завершить запись потока в указанной медиасессии | ||||||||
/recorder/find_all |
|
Параметры
Имя параметра | Описание | Пример |
---|---|---|
mediaSessionId | Идентификатор сессии | 5a072377-73c1-4caf-abd3 |
config | Настройки записи, имеют приоритет над настройками сервера | |
fileTemplate | Шаблон имени файла записи | {streamName}-{startTime}-{endTime} |
rotation | Включает/отключает ротацию файлов и способ нарезки (время или объем) | 20M |
Логика работы записи по требованию выглядит следующим образом:
- При вызове REST API API /streamrecorder/startRecording startup завершается текущая запись, если она идет в данный момент.
- Стартует новая запись, при этом применяются переданные через REST настройки.
- Если какая-либо из настроек не передана, применяется соответствующая настройка сервера.
...
Code Block | ||||
---|---|---|---|---|
| ||||
/streamrecorder/startRecordingstartup { "mediaSessionId":"1234567890abcdefgh", "config": { "fileTemplate": "test", "rotation": "disabled" } } |
REST запрос /recorder/find_all возвращает список записей, ведущихся в данный момент. В списке отражаются как записи по требованию, запущенные через REST API, так и записи, инициированные через WebSDK:
Code Block | ||||
---|---|---|---|---|
| ||||
[
{
"fileName": "003f-1563776713987-{endTime}.mp4",
"mediaSessionId": "5af9c820-ac49-11e9-9f06-693cb47c4042"
},
{
"fileName": "stream-57882100-ac49-11e9-afdd-6752f5be57a9-jtdvnittjkrd8rsc3dnfbger2o.mp4",
"mediaSessionId": "57882100-ac49-11e9-afdd-6752f5be57a9"
}
] |
Получение имени записанного файла
...