Versions Compared

Key

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

...

Section


Column
width35%


Panel
borderColor#CCCCCC
bgColor#FFFFFF
titleBGColor#F0F0F0
borderStylesolid
titleНа странице:
Table of Contents

Получение подписанных ссылок на видео потоки



Column



Note
titleВнимание!

Получение звука возможно только с 64-битного Сервера.

Передача звука в формате MJPEG невозможна.

...

GET http://IP-адрес:порт/префикс/archive/media/{VIDEOSOURCEID}/{STARTTIME?параметры,}где 

Tip

{VIDEOSOURCEID

...

} - трехкомпонентный идентификатор endpoint-а источника

...

(см. Получение списка источников видео (камер)).  Например,  "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".


Tip

{STARTTIME} - время в формате ISO.

...

Note
titleВнимание!

Время  Время задается в часовом поясе UTC+0

Параметры:

...

.


ПараметрОбязательныйОписание
speed НетСкорость воспроизведения, может принимать отрицательные значения.
format

...

Нет

Параметр может принимать значения "mjpeg", "rtsp

...

"

...

. В случае, если  формат не указан, указан "rtsp" или не распознан, сервер выбирает нативный формат (чтобы избежать перекодирования). Если при этом нативный формат не поддерживается клиентом, сервер выбирает WebM.

В случае, если не задано значение ни одного из двух вышеперечисленных параметров, скорость считается равной 0, а формат - JPEG, и запрос интерпретируется как запрос на покадровый просмотр архива.

id

...

НетУникальный идентификатор архивного потока

...

. Необходим для получения информации о потоке или для управления им.

w

...

h

Нет

w – ширина кадра, h – высота

...

кадра.

fr

...

Нет

Частота кадров

Note
titleВнимание!

Данный параметр актуален только для видео в формате MJPEG.


archiveНетИмя архива из запроса получения списка архивов (см. Получение содержания архивов). Если не задано, используется архив по умолчанию.
enable_token_auth Нет

Получение авторизованных и подписанных ссылок на видеопотоки.

enable_token_auth - включить авторизацию по токену =1.

valid_token_hours - время действительности подписи в часах. Максимальное значение - неделя. Значение по умолчанию 12 часов.

valid_token_hoursНет

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

GET http://IP-адрес:порт/префикс127.0.0.1:80/archive/media/HOSTNAMEServer1/DeviceIpint.231/SourceEndpoint.video:0:0/20110608T060141.375?format=rtsp&speed=1&w=640&h=480

Note
titleВнимание!

Архивное видео по протоколу HLS будет доступно в течение 30 секунд после ответа

&enable_token_auth=1&valid_token_hours=1

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

Code Block
{
    "http":
{ {
        "description": "RTP/RTSP/HTTP/TCP",
        "path": "archive/hosts/HOSTNAMEServer1/DeviceIpint.1/SourceEndpoint.video:0:0/20161206T06014120110608T060141.375000?speed=1&id=729955cda865fcea-7787cfe6-4d6c44a1-87eb-cd6dd6d4a940",bf7b-9e6a94c44a53&exp=20200525T171234&nonce=1&hmac=wVlyHvZkB2TnqftTfYugtwmZ7g8=",
        "port": "8554"
    },
    "httpproxy": {
        "description": "RTP/RTSP/HTTP/TCP Current Http Port",
        "path": "rtspproxy/archive/hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20110608T060141.375000?speed=1&id=a865fcea-cfe6-44a1-bf7b-9e6a94c44a53&exp=20200525T171234&nonce=2&hmac=BVICx8NVV4yijwqc0Q6Xzji41Rg="
    },
    "rtsp":
{ {
        "description": "RTP/UDP or RTP/RTSP/TCP",
        "path": "archive/hosts/HOSTNAMEServer1/DeviceIpint.1/SourceEndpoint.video:0:0/20161206T06014120110608T060141.375000?speed=1&id=729955cda865fcea-7787cfe6-4d6c44a1-87eb-cd6dd6d4a940",bf7b-9e6a94c44a53&exp=20200525T171234&nonce=1&hmac=wVlyHvZkB2TnqftTfYugtwmZ7g8=",
        "port": "554"
    }
}


HTML
<script type="text/javascript" src="https://asciinema.org/a/99469.js" id="asciicast-99469" async></script>

...

В качестве id можно использовать и другие значения, состоящие из букв и цифр латинского алфавита. Рекомендуется для получения уникальных значений использовать функцию UUID (см. Получение уникального идентификатора).

Получение архивного потока из конкретного архива

GET http://IP-адрес:порт/префикс/archive/media/VIDEOSOURCEID/STARTTIME?параметры&archive=hosts/SERVER1/MultimediaStorage.Имя_Архива/MultimediaStorage

Архивное видео по протоколу RTSP

...

Архивное видео по протоколу HTTP

GET ffplay.exe -v debug "http://логин:пароль@IP-адрес:80/asip-api/archive/media/SERVER1/DeviceIpint.4/SourceEndpoint.video:0:0/20170112T113526?w=1600&h=0&speed=1"

...

см. Настройка туннелирования RTSP по HTTP в VLC.

GET ffplay ffplay -rtsp_transport http "rtsp://логин:пароль@IP-адрес:8554/rtspproxy/archive/hosts/SERVER1/DeviceIpint.4/SourceEndpoint.video:0:0/20170115T113526"

...