Go to documentation repository
Documentation for Axxon Next 4.5.0. Documentation for other versions of Axxon Next is available too.
Previous page Next page
On page:
Important!
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} - three-component source endpoint ID (zobacz: Get list of video sources (cameras)). Przykład: "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".
Important!
Jeśli żaden z parametrów nie jest sprecyzowany, wideo będzie pozyskane w formacie MJPEG.
| Parametr | Wymagany | Opis |
|---|---|---|
| format | No | 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. Important! 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 | No | w – szerokość klatki, h – wysokość klatki. Note 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. Important! Wideo w formacie mp4 są przekazywane bez przeskalowywania. |
| fr | No | FPS. Important! Ten parametr jest brany pod uwagę tylko dla wideo w formacie MJPEG. |
| enable_token_auth | No | 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 | No |
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. |
Important!
Wideo korzystające z protokołu HLS staje się dostępne kilka sekund po otrzymaniu odpowiedzi.
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
Important!
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"
Important!
HTTP wysyła wideo jedynie w formacie mjpeg; parametry w oraz h są wymagane.
Tunelowanie RTSP nad HTTP
Zobacz: Configure tunneling RTSP over HTTP in 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"
Overview
Content Tools