Versions Compared

Key

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

...

Section


Column
width50%


Panel
borderColor#CCCCCC
bgColor#FFFFFF
titleBGColor#F0F0F0
borderStylesolid
titleOn the page:
Table of Contents



Column



Note
titleAttention!
  • You can get audio from x64 Server only.
  • You can't get audio in MJPEG format.

...

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

일반 정보

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

Tip

{VIDEOSOURCEID}a three-component source endpoint ID (see Get list of video cameras and information about them). For instance—세 부분으로 구성된 소스 엔드포인트 ID (비디오 카메라 목록 및 정보 가져오기 참조). 예를 들어, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".


Note
titleAttention!

If no parameters are specified in the request, then the video will be received in the MJPEG format.

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


파라미터필수설명ParameterRequiredDescription
formatNo

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

Video can be received in the original format (without recompression) via HLS protocols. HLS protocol supports only H.264 format.

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

"mp4" 플레이어는 원본 비디오를 H.264 및 H.265 형식으로 수신할 수 있습니다. 그 외의 경우에는 서버가 MJPEG 형식으로 재압축합니다The "mp4" player allows to receive the original video in H.264 and H.265 formats. In all other cases the Server recompresses it to MJPEG format

Note
titleAttention!

If video is requested in the format that differs from the original one, then recompression will be performed, therefore, Server load will increase원본과 다른 형식으로 비디오를 요청하면 재압축이 수행되므로 서버 부하가 증가합니다.


w, hNo

wframe width—프레임 너비h—frame height.—프레임 높이

Note
titleAttention!

The mp4 video is transferred without scalingmp4 비디오는 크기 조정 없이 전송됩니다.

If the h and w values are greater than the size of the original video, the video will be received with the original size.Zooming out of width and height is available only discretely—in 2, 4, 8 times, etc. If specified sizes are not corresponding to w 값이 원본 비디오 크기보다 크면, 비디오는 원본 크기로 수신됩니다.

너비와 높이의 축소는 2배, 4배, 8배 등으로만 가능합니다. 지정된 크기가 원본 비디오 크기의 1/2, 1/4 etc. of original video size, the video will be received with size divisible by the original video size close to specified values.등과 일치하지 않으면 비디오는 지정된 값에 가까운 원본 비디오 크기로 나누어 떨어지는 크기로 수신됩니다.


frNo

The FPS value.

Note
titleAttention!

This parameter is relevant only for MJPEG video이 파라미터는 MJPEG 비디오에만 해당됩니다.


enable_token_auth No

Get authorized and signed links to video streams.비디오 스트림에 대한 인증된 서명 링크를 가져오기

  • enable_token_auth—enable authorization by token —토큰을 통한 인증 활성화 = 1.
  • valid_token_hours—signature validation time (in hours). The maximum value is a week. The default value is 12 hours—서명 유효 시간(시간 단위). 최대 값은 일주일이며, 기본 값은 12시간입니다.
valid_token_hoursNo

key_frames

No

1playback only by key frames;—키 프레임만으로 재생

0—원본 프레임 속도 (기본값0original frame rate (default)

authTokenNo

Starting with Axxon One 2.00부터

Connecting via AxxonNet.을 통해 연결

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

auth_tokenNo

Starting with Axxon One 2.0

Authorizing when connecting directly to the Server and authorizing by token.

0부터

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

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


Sample request요청 예시
:

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

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

HLS

...

비디오

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

파라미터필수설명

HLS protocol video can be received in the original format only. The following parameters are used when receiving HLS protocol video:

Time in seconds in which the stream is to be kept aliveThe segment length in secondsThe maximum number of playlist entries. If set to 0, the list file will contain all segments
ParameterRequiredDescription
keep_aliveNo스트림을 유지할 시간(초 단위)
hls_timeNo세그먼트 길이(초 단위)
hls_list_sizeNo최대 플레이리스트 항목 수. 0으로 설정하면 목록 파일에 모든 세그먼트가 포함됩니다.
hls_wrapNoThe number after which the segment filename number wraps. If set to 0, the number will be never wrapped세그먼트 파일명 번호가 랩핑되는 번호. 0으로 설정하면 번호는 절대 랩핑되지 않습니다.

요청 예시Sample request:

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

Sample response응답 예시:

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


Parameter파라미터Description설명
keep_alive_secondsTime in seconds in which the stream is to be kept alive스트림을 유지할 시간(초 단위)
keep_alive_url The url to keep the stream alive스트림을 유지하기 위한 URL
stop_urlThe url to stop the stream스트림을 중지하기 위한 URL
stream_urlThe url to access the list of segments세그먼트 목록에 접근하기 위한 URL


Note
titleAttention!

HLS protocol video becomes available with some delay (about 20 seconds). This is due to a feature of the HLS protocol: after receiving the link, it forms a cache of several video segments, and only after that the video starts playing.프로토콜 비디오는 약 20초의 지연 후에 사용 가능합니다. 이는 HLS 프로토콜의 특성 때문입니다. 링크를 받은 후, 여러 비디오 세그먼트의 캐시를 형성하고, 그 후에 비디오가 재생되기 시작합니다.

HLS 프로토콜을 통해 비디오를 재생하려면, 응답에서 stream_url 파라미터를 다음과 같이 사용하세요.To playback video via HLS protocol, use the stream_url parameter from the response as follows:

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

RTSP

...

비디오

RTSP protocol video is sent in the original format only.프로토콜 비디오는 원본 형식으로만 전송됩니다.

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

Sample response응답 예시:

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

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

Note
titleAttention!

In some cases, the RTSP video can be streamed with artifacts. To fix this, change the TCP/IP settings using this reg file.

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

RTSP 스트림 정보RTSP stream information:

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"

Note
titleAttention!

HTTP sends video in mjpeg only, the w and h parameters are mandatory.

Tunneling RTSP over HTTP

See Configure tunneling RTSP over HTTP in VLC.

Video is sent over the tunnel in the original format.

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

RTSP를 HTTP를 통해 터널링하기

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

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

요청 예시Sample request:

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

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

H.264

...

H.

...

265 비디오

원본

...

To get live video in the original H.264 and H.265  formats, use mp4 format.형식으로 실시간 비디오를 받으려면 mp4 형식을 사용하세요.

요청 예시Sample request:

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

...