Управление архивом

Важно

Управление архивом возможно только после получение потока архива по следующему алгоритму:

  1. Выполнить запрос Token с параметром stream=archive_main или stream=archive_sub.
  2. По Token выполнить запрос потока.
  3. С помощью команд управления архивом указать точку начала воспроизведения и запустить воспроизведение видео.

Примеры запросов:

  • Включить воспроизведение фрагмента архива

    https://192.168.1.200:8080/archive_command?command=play&start=20180117T110734&stop=20180117T110834&speed=1&sid=e03qD0eg&token=P2FYkjcP

  • Остановить воспроизведение архива

    https://192.168.1.200:8080/archive_command?command=stop&sid=e03qD0eg&token=P2FYkjcP

  • Переместится на определенное время к ближайшему фрагменту архива

    https://192.168.1.200:8080/archive_command?command=seek&timestamp=20180117T110734&direction=0&sid=e03qD0eg&token=P2FYkjcP

  • Переместится к следующему кадру фрагмента архива

    https://192.168.1.200:8080/archive_command?command=frame_next&sid=e03qD0eg&token=P2FYkjcP

  • Переместится к предыдущему кадру фрагмента архива

    https://192.168.1.200:8080/archive_command?command=frame_prev&sid=e03qD0eg&token=P2FYkjcP

  • Переместится к первому кадру фрагмента архива

    https://192.168.1.200:8080/archive_command?command=frame_first&sid=e03qD0eg&token=P2FYkjcP

  • Переместится к последнему кадру фрагмента архива

    https://192.168.1.200:8080/archive_command?command=frame_last&sid=e03qD0eg&token=P2FYkjcP

Ключевые элементы запросов:

  • command=[команда] - команда управления архивом:
    • stop - остановить воспроизведение архива;
    • play - включить воспроизведение архива;
    • seek - поиск по архиву;
    • next - перейти к следующему фрагменту архива;
    • prev - перейти к предыдущему фрагменту архива;
    • frame_first - перейти к первому кадру фрагмента архива;
    • frame_last - перейти к последнему кадру фрагмента архива;
    • frame_next - перейти к следующему кадру фрагмента архива;
    • frame_prev - перейти к предыдущему кадру фрагмента архива.
  • start=[дата и время] и stop=[дата и время] - дата и время начала и конца проигрываемого фрагмента архива;
  • speed=[число] - скорость воспроизведения архива (от 1 до 16);
  • timestamp=[дата и время] - дата и время точки начала воспроизведения фрагмента архива;
  • direction=[число] - направление поиска ближайшего кадра фрагмента архива:
    • 1 - искать ближайший кадр, расположенный впереди от даты timestamp;
    • -1 - искать ближайший кадр, расположенный позади от даты timestamp;
    • 0 - искать ближайший кадр в обоих направлениях от даты timestamp.
  • sid=[id_сессии] - id сессии, в которой выполняется запрос (см. пример Получение id сессии);
  • token=[Token] - уникальный Token видео (см. пример Получение видео и аудиопотоков).

Подсказка

Для указания даты и времени, данные в запросе должны быть представлены в одном из предложенных форматов:

  • YYYY-MM-DD HH:MM:SS
  • YYYY-MM-DDTHH:MM:SS
  • YYYYMMDD-HHMMSS
  • YYYYMMDDTHHMMSS
  • а так же в UNIX(10 знаков) и TIMESTAMP(16 знаков) форматах.

Пример ответа сервера: 

{
    "success" : "1",
}

См. также