Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Доступны следующие элементы шаблона:

ЭлементОписаниеМаксимальный размер
{streamName}Имя потока
{startTime}Время начала записи потока (а не его создания)20 символов
{sessionId}Идентификатор сессии в кодировке BASE6460 символов
{mediaSessionId}Идентификатор медиасессии36 символов
{login}Логин32 символа
{audioCodec}Аудиокодек4 символа
{videoCodec}Видеокодек4 символа

Если имя файла создается из имени потока, в нем могут быть символы, недопустимые к использованию в именах, например, прямой слэш '/'. В этом случае имя файла должно быть закодировано при помощи настройки

...

определяет длительность фрагмента в 20 секунд. Части нумеруются последовательно. Если включена ротация, то, при записи в файл с фиксированным именем (например, при помощи REST-запроса), при остановке и возобновлении записи нумерация будет продолжена, начиная с 1, последняя часть не нумеруется.

Скрипт обработки записанных файлов

...

REST-методы и статусы ответа

REST-метод

Пример тела REST-запроса

Пример тела REST-ответа

Статусы ответа

Описание

/stream/startRecording


Code Block
languagejs
themeRDark
{
 "mediaSessionId": "5a072377-73c1-4caf-abd3"
 "fileName": "recordStream.mp4",
 "force": "true"
}

404 - Not found

500 - Internal error


Начать запись потока в указанной медиасессии


/stream/stopRecording
Code Block
languagejs
themeRDark
{
 "mediaSessionId": "5a072377-73c1-4caf-abd3"
}

404 - Not found

500 - Internal error

Завершить запись потока в указанной медиасессии

Параметры

Имя параметра

Описание

Пример

mediaSessionId

Идентификатор сессии

5a072377-73c1-4caf-abd3

fileNameИмя файла записиrecordStream.mp4
forceПерезаписывать указанный файл при повторном вызове /stream/startRecording
true

Если в REST запросе не указано явно имя файла, поток указанной медиасессии будет записан в файл с именем по шаблону, определенному в настройках.

Если имя указано, будет записан файл с таким именем. Если файл уже существует, то, в зависимости от значения параметра force

  • false (по умолчанию) - файл не будет перезаписан, запись

...

  • произведена не будет
  • true - файл будет перезаписан новой записью потока

Известные проблемы

1. Максимальная длина имени файла во всех актуальных файловых системах Linux ограничена 255 символами. При создании файла записи, имя будет сокращено до данного предела, включая расширение и номер части, если включена ротация.

...