Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is [available too].

Previous page 선택한 카메라 정보 가져오기  고화질 및 저화질 스트림 가져오기 Next page

On the page:

Attention!

  • 오디오는 x64 서버에서만 가져올 수 있습니다.
  • MJPEG 형식에서는 오디오를 가져올 수 없습니다.

일반 정보

GET http://IP Address:port/prefix/live/media/{VIDEOSOURCEID}

{VIDEOSOURCEID}—세 부분으로 구성된 소스 엔드포인트 ID (비디오 카메라 목록 및 정보 가져오기 참조). 예를 들어, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".

Attention!

요청에 파라미터가 지정되지 않으면 비디오는 MJPEG 형식으로 수신됩니다.

파라미터필수설명
formatNo

파라미터 값은 "mp4", "hls"입니다.

비디오는 HLS 프로토콜을 통해 원본 형식(재압축 없이)으로 수신할 수 있습니다. HLS 프로토콜은 H.264 형식만 지원합니다. 

"mp4" 플레이어는 원본 비디오를 H.264 및 H.265 형식으로 수신할 수 있습니다. 그 외의 경우에는 서버가 MJPEG 형식으로 재압축합니다. 

Attention!

원본과 다른 형식으로 비디오를 요청하면 재압축이 수행되므로 서버 부하가 증가합니다.

w, hNo

w—프레임 너비, h—프레임 높이

Attention!

mp4 비디오는 크기 조정 없이 전송됩니다.

h 및 w 값이 원본 비디오 크기보다 크면, 비디오는 원본 크기로 수신됩니다.

너비와 높이의 축소는 2배, 4배, 8배 등으로만 가능합니다. 지정된 크기가 원본 비디오 크기의 1/2, 1/4 등과 일치하지 않으면 비디오는 지정된 값에 가까운 원본 비디오 크기로 나누어 떨어지는 크기로 수신됩니다.

frNo

FPS 값

Attention!

이 파라미터는 MJPEG 비디오에만 해당됩니다.

enable_token_auth No

비디오 스트림에 대한 인증된 서명 링크를 가져오기

  • enable_token_auth—토큰을 통한 인증 활성화 = 1.
  • valid_token_hours—서명 유효 시간(시간 단위). 최대 값은 일주일이며, 기본 값은 12시간입니다.
valid_token_hoursNo

key_frames

No

1—키 프레임만으로 재생

0—원본 프레임 속도 (기본값)

authTokenNo

Axxon One 2.0부터

AxxonNet을 통해 연결

예: https://axxonnet.com/arpserver/25455_0/webclient/live/media/SERVER/DeviceIpint.1/SourceEndpoint.video:0:1?authToken=...

auth_tokenNo

Axxon One 2.0부터

서버에 직접 연결할 때 인증과 토큰으로 인증.

예: http://127.0.0.1:80/live/media/SERVER/DeviceIpint.1/SourceEndpoint.video:0:0?format=mp4&auth_token=...


요청 예시:

GET http://127.0.0.1:80/live/media/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?w=640&h=480&enable_token_auth=1&valid_token_hours=1

HLS 비디오

HLS 프로토콜 비디오는 원본 형식으로만 수신할 수 있습니다. HLS 프로토콜 비디오를 수신할 때 사용되는 파라미터는 다음과 같습니다:

파라미터필수설명
keep_aliveNo스트림을 유지할 시간(초 단위)
hls_timeNo세그먼트 길이(초 단위)
hls_list_sizeNo최대 플레이리스트 항목 수. 0으로 설정하면 목록 파일에 모든 세그먼트가 포함됩니다.
hls_wrapNo세그먼트 파일명 번호가 랩핑되는 번호. 0으로 설정하면 번호는 절대 랩핑되지 않습니다.

요청 예시:

GET http://127.0.0.1:80/live/media/SERVER1/DeviceIpint.23/SourceEndpoint.video:0:0?format=hls&keep_alive=60

응답 예시:

{
    "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"
}
파라미터설명
keep_alive_seconds스트림을 유지할 시간(초 단위)
keep_alive_url 스트림을 유지하기 위한 URL
stop_url스트림을 중지하기 위한 URL
stream_url세그먼트 목록에 접근하기 위한 URL

Attention!

HLS 프로토콜 비디오는 약 20초의 지연 후에 사용 가능합니다. 이는 HLS 프로토콜의 특성 때문입니다. 링크를 받은 후, 여러 비디오 세그먼트의 캐시를 형성하고, 그 후에 비디오가 재생되기 시작합니다.

HLS 프로토콜을 통해 비디오를 재생하려면, 응답에서 stream_url 파라미터를 다음과 같이 사용하세요.

ffplay "http://root:root@10.0.12.65:80/hls/c83b48d5-2ab7-49eb-91ef-593f808d4e51/playout.m3u8"

RTSP 비디오

RTSP 프로토콜 비디오는 원본 형식으로만 전송됩니다.

RTSP 링크 구조를 가져오기 위한 요청: http://login:password@IP Address:Port/live/media/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?format=rtsp

응답 예시:

{
    "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"
    }
}

비디오를 가져오기 위한 요청: GET rtsp://login:password@IP Address:554/hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0

Attention!

경우에 따라 RTSP 비디오에 아티팩트가 발생할 수 있습니다. 이를 수정하려면 레지스트리 파일을 사용하여 TCP/IP 설정을 변경하세요.

RTSP 스트림 정보:

GET http://IP Address:port/prefix/rtsp/stat

HTTP 비디오

ffplay.exe -v debug "http://login:password@IP Address:8001/live/media/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?w=1600&h=0"

Attention!

HTTP는 비디오를 MJPEG 형식으로만 전송하며 w와 h 파라미터는 필수입니다.

RTSP를 HTTP를 통해 터널링하기

VLC에서 RTSP를 HTTP를 통해 터널링 설정하기 을/를 참조하세요.

비디오는 터널을 통해 원본 형식으로 전송됩니다.

요청 예시:

ffplay -rtsp_transport http "rtsp://login:password@IP Address:80/rtspproxy/hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0"

VLC용 GET 요청: rtsp://login:password@IP Address:80/rtspproxy/hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0

H.264 및 H.265 비디오

원본 H.264 및 H.265 형식으로 실시간 비디오를 받으려면 mp4 형식을 사용하세요.

요청 예시:

ffplay.exe "http://root:root@192.168.25.112:8001/live/media/Server1/DeviceIpint.61/SourceEndpoint.video:0:0?format=mp4"


  • No labels

고화질 및 저화질 스트림 가져오기

VLC에서 RTSP를 HTTP를 통해 터널링 설정하기