제3장 HLS APIs

설정

설정에서 여러 HLS 매개변수를 설정할 수 있습니다.

· HLS 목록 크기: 플레이리스트 항목의 최대 개수를 설정합니다. 기본값은 3입니다. 이 설정은 지정된 기간이 없는 라이브 스트림과 재생 스트림 모두에 적용됩니다.

· HLS 시간(초): 세그먼트의 목표 길이를 초 단위로 설정합니다. 기본값은 1입니다. 이 시간이 경과하면 다음 I-프레임에서 세그먼트가 분할됩니다. 이 설정은 지정된 기간이 없는 라이브 스트림과 재생 스트림에 적용됩니다.

· HLS 시간(재생): 지정된 기간이 있는 재생 스트림의 세그먼트 목표 길이를 초 단위로 설정합니다. 기본값은 2입니다. 이 시간이 경과하면 다음 I-프레임에서 세그먼트가 분할됩니다.

필요하지 않은 한, 일반적으로 이 값들을 변경할 필요는 없습니다.

라이브 HLS 스트리밍

### 주 스트림
http://<address>:<port>/hlsLive/ch[chno]/stream.m3u8
### 보조 스트림
http://<address>:<port>/hlsLive/ch[chno]_[sub]/stream.m3u8

· chno: 채널 번호.

· sub: 보조 스트림 인덱스; 첫 번째 보조 채널은 1, 두 번째 보조 채널은 2입니다.

· 라이브 스트리밍은 설정에서 활성화되어야 합니다.

녹화비디오 HLS 스트리밍 요청

### 방법 1: YYYYMMDDHHMMSS 형식으로 시간 지정
http://<address>:<port>>/hlsPlayback?ch=<channel no>
    [&sub=<sub-stream index, default=0>]
    &time=<YYYYMMDDHHMMSS>&duration=<seconds>
### 방법 2: Unix 타임스탬프를 사용하여 시간 지정
http://<address>:<port>/hlsPlayback?ch=<channel no>
    [&sub=<sub-stream index, default=0>]
    &timestamp=<Unix Timestamp>&duration=<seconds>

· ch: 채널 번호.

· sub: 보조 스트림 인덱스; 제공되지 않으면 기본값은 0(주 스트림)입니다.

· time: 비디오 이미지의 정확한 시간을 `YYYYMMDDHHMMSS` 형식으로 지정합니다.

· timestamp: 비디오 이미지의 시간을 Unix 타임스탬프 형식으로 지정합니다.

· duration:

· 기간이 0(`0`)으로 설정된 경우, HLS 비디오는 라이브 모드로 스트리밍되며 비디오 시간 탐색이 불가능합니다(유지 신호 필요 없음).

· 기간이 양수(예: 10초(10))로 설정된 경우, 2초마다 유지 신호를 보내야 하며, 그렇지 않으면 VMS 서버에서 HLS 비디오 파일이 삭제될 수 있습니다.

{
  "id: "<id.no>",
  "path: "/hlsPlayback/id<id.no>/stream.m3u8"
}

· id: 유지 신호를 보내는 데 사용되는 고유 ID. 이 ID는 스트림을 활성 상태로 유지하기 위해 이후 요청에 사용해야 합니다.

· path: HLS 스트림에 접근할 수 있는 URL 경로.

저장파일 비디오 HLS 스트리밍 요청

http://<address>:<port>/reqFilePlayback?id=<file id>
    &timestamp=<Unix Timestamp>&duration=<seconds>

· id: 고유 파일 번호.

· timestamp: 비디오 이미지의 시간을 Unix 타임스탬프 형식으로 지정합니다.

· duration:

· 기간이 0(`0`)으로 설정된 경우, HLS 비디오는 라이브 모드로 스트리밍되며 비디오 시간 탐색이 불가능합니다(유지 신호 필요 없음).

· 기간이 양수(예: 10초(10))로 설정된 경우, 2초마다 유지 신호를 보내야 하며, 그렇지 않으면 VMS 서버에서 HLS 비디오 파일이 삭제될 수 있습니다.

{
  "id: "<id.no>",
  "path: "/hlsFilePlayback/id<id.no>/stream.m3u8"
}

· id: 유지 신호를 보내는 데 사용되는 고유 ID. 이 ID는 스트림을 활성 상태로 유지하기 위해 이후 요청에 사용해야 합니다.

· path: HLS 스트림에 접근할 수 있는 URL 경로.

재생 HLS 스트리밍을 위한 유지 신호 전송

### 녹화비디오 재생
http://<address>:<port>>/hlsPlaybackKeepAlive?id=<id.no>
### 저장파일 재생
http://<address>:<port>>/reqFilePlaybackKeepAlive?id=<id.no>

· id_no: "재생 HLS 스트리밍 요청" 응답에서 받은 고유 식별자. 이 ID는 HLS 스트림의 활성 상태를 유지하는 데 사용됩니다.