Go to documentation repository
Documentation for Axxon One 1.0.
Previous page Next page
Uwaga!
Pozyskać audio można jedynie z Serwera x64.
Nie można pozyskać audio w formacie MJPEG.
Informacje ogólne
GET http://IP-Address:port/prefix/live/media/{VIDEOSOURCEID}
{VIDEOSOURCEID} - trójkomponentowe ID źródłowego punktu końcowego (zobacz: Pozyskaj listę źródeł wideo (kamer)). Przykład: "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".
Uwaga!
Jeśli żaden z parametrów nie jest sprecyzowany, wideo będzie pozyskane w formacie MJPEG.
Parametr | Wymagany | Opis |
---|---|---|
format | Nie | Dostępne wartości parametru: "mp4", "hls". Wideo może być pozyskane w pierwotnym formacie (bez kompresji) poprzez protokoły HLS. Protokół HLS wspiera jedynie format H.264. Odtwarzacz "mp4" pozwala na pozyskiwanie oryginalnego wideo w formatach H.264 oraz H.265. We wszystkich innych przypadkach Serwer automatycznie poddaje pliki rekompresji do formatu MJPEG. Uwaga! Jeśli w zapytaniu widnieje inny format wideo niż oryginalny, nagrania będą musiały ulec rekompresji, co zwiększy obciążenie Serwera. |
w, h | Nie | w – szerokość klatki, h – wysokość klatki. Informacja Jeśli wartości h oraz w są większe niż oryginalnego materiału wideo, będzie ono dostarczone w oryginalnej rozdzielczości. Rozdzielczość oryginalnego wideo jest dzielona przez 2 dopóki nie osiągnie ona wartości równej bądź niższej od podanej w parametrach h i w. Uwaga! Wideo w formacie mp4 są przekazywane bez przeskalowywania. |
fr | Nie | FPS. Uwaga! Ten parametr jest brany pod uwagę tylko dla wideo w formacie MJPEG. |
enable_token_auth | Nie | enable_token_auth - włącz autoryzację poprzez token =1. valid_token_hours - czas walidacji tokenu (w godzinach). Maksymalny okres to tydzień. Domyślna wartość to 12 godzin. |
valid_token_hours | Nie |
Przykładowe zapytanie:
GET http://IP-Address:port/prefix/live/media/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?w=640&h=480&enable_token_auth=1&valid_token_hours=1
HLS video
Wideo korzystające z protokołu HLS może być pozyskane jedynie w oryginalnym formacie. Następujące parametry mogą być użyte przy pozyskiwaniu wideo korzystającego z protokołu HLS:
Parametr | Wymagany | Opis |
---|---|---|
keep_alive | Nie | Czas w sekundach, przez który strumień ma pozostać aktywny. |
hls_time | Nie | Długość segmentu w sekundach. |
hls_list_size | Nie | Maksymalna ilość wpisów listy odtwarzania. Jeśli wartość to 0, plik listy będzie zawierać wszystkie segmenty. |
hls_wrap | Nie | The number after which the segment filename number wraps. If set to 0 the number will be never wrapped. |
Przykładowe zapytanie:
GET http://127.0.0.1:80/live/media/SERVER1/DeviceIpint.23/SourceEndpoint.video:0:0?format=hls&keep_alive=60
Przykładowa odpowiedź:
{ "keep_alive_seconds": 60, "keep_alive_url": "/live/media/hls/keep?stream_id=7e9d8c93-80e2-4521-9a54-cb854fe3cd2d", "stop_url": "/live/media/hls/stop?stream_id=7e9d8c93-80e2-4521-9a54-cb854fe3cd2d", "stream_url": "/hls/7e9d8c93-80e2-4521-9a54-cb854fe3cd2d/playout.m3u8" }
Parametr | Opis |
---|---|
keep_alive_seconds | Czas w sekundach, przez który strumień ma pozostać aktywny. |
keep_alive_url | URL służący do przedłużenia czasu aktywności strumienia. |
stop_url | URL służący do zatrzymania strumienia |
stream_url | URL zapewniający dostęp do listy segmentów. |
Uwaga!
Aby odtwarzać wideo poprzez protokół HLS, użyj parametru stream_url z odpowiedzi w następujący sposób:
ffplay "http://root:root@10.0.12.65:80/hls/c83b48d5-2ab7-49eb-91ef-593f808d4e51/playout.m3u8"
Wideo RTSP
Strumieniowanie wideo za pośrednictwem protokołu RTSP wyświetla wideo jedynie w jego pierwotnym formacie.
Zapytanie o strukturę linku RTSP: http://login:password@IP-address:Port/live/media/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?format=rtsp
Przykładowa odpowiedź:
{ "http": { "description": "RTP/RTSP/HTTP/TCP", "path": "hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0", "port": "8554" }, "rtsp": { "description": "RTP/UDP or RTP/RTSP/TCP", "path": "hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0", "port": "554" } }
Zapytanie w celu pozyskania wideo: GET rtsp://login:password@IP-address:554/hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0
Uwaga!
W niektórych przypadkach wideo poprzez RTSP może być strumieniowane z artefaktami. Aby to naprawić, zmień ustawienia TCP/IP korzystając z następującego pliku reg.
Informacje o strumieniu RTSP:
GET http://IP-Address:port/prefix/rtsp/stat
Wideo HTTP
ffplay.exe -v debug "http://login:password@IP-address:8001/live/media/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?w=1600&h=0"
Uwaga!
HTTP wysyła wideo jedynie w formacie mjpeg; parametry w oraz h są wymagane.
Tunelowanie RTSP poprzez HTTP
Zobacz: Skonfiguruj tunelowanie RTSP poprzez HTTP w VLC
Wideo jest wysyłane poprzez tunel, w pierwotnym formacie wideo.
Przykładowe zapytanie:
ffplay -rtsp_transport http "rtsp://login:password@IP-Address:80/rtspproxy/hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0"
GET dla VLC: rtsp://login:password@IP-Address:80/rtspproxy/hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0
Wideo w formatach H.264 oraz H.265
Aby pozyskać wideo na żywo oryginalnie w formacie H.264/H.265, skorzystaj z formatu mp4.
Przykładowe zapytanie:
ffplay.exe "http://root:root@192.168.25.112:8001/live/media/Server1/DeviceIpint.61/SourceEndpoint.video:0:0?format=mp4"