영어 | 한국어 | 중국어 | 일본어

제2장 녹화 정보 요청 API

채널 목록 요청

 Request
http://<address>:<port>/reqChannelList

 Response
[
  {"ch":1, "sub":0, "title":"Garden#1", "connected":true, "recording":true,
   "live_hls":true, "ptz":true,
   "ptz_presets": [{"no": 1, "title": "Position#1"},{"no": 2, "title": "Position#2"}],
   "recordingStart": "2025-04-01", "recordingEnd": "2025-04-17"},
  {"ch":2, "sub":0, "title":"Garden#2", "connected":true, "recording":false,
   "live_hls":true, "ptz":false,
   "recordingStart": "2025-04-01", "recordingEnd": "2025-04-17"},
   ...
  {"ch":8, "sub":0, "title":"Playground", "connected":false, "recording":false,
   "live_hls":true, "ptz":false,
   "recordingStart": "2025-04-01", "recordingEnd": "2025-04-17"}
]

· ch: 채널 번호.

· sub: 서브 스트림 인덱스; 0은 기본 채널, 1은 첫 번째 서브 채널, 2는 두 번째 서브 채널을 의미합니다.

· title: 채널 제목.

· connected: 카메라가 연결되어 있는지 여부.

· recording: 카메라가 녹화 중인지 여부.

· live_hls: HLS 라이브 스트리밍 여부.

· ptz: 카메라가 PTZ(팬-틸트-줌) 카메라인지 여부.

· ptz_presets: PTZ 프리셋 목록. "no"는 프리셋 번호, "title"은 프리셋 제목입니다.

· recordingStart: 녹화 시작 날짜.

· recordingEnd: 녹화 종료 날짜.

 

녹화 날짜 요청

 Request
http://<address>:<port>/reqRecordingDates?month=<YYYYMM>

· month: 녹화 날짜를 요청할 연도와 월을 YYYYMM 형식으로 지정.

 Response
[
  {"ch":1, "dates":[17,19,20,21]},
  {"ch":2, "dates":[17,19,20,21]},
  ...
  {"ch":8, "dates":[17,19,20,21]}
]

· ch: 채널 번호.

· dates: 녹화가 있었던 날짜 배열.

 

녹화 시간 요청

 Request
http://<address>:<port>/reqRecordingTimes?date=<YYYYMMDD>
  &ch=<channel no>
  [&sub=<sub-stream index, default=0>]

· date: 요청할 녹화 날짜를 YYYYMMDD 형식으로 지정.

· ch: 채널 번호.

· sub: 서브 스트림 인덱스; 지정되지 않으면 기본값은 0(기본 스트림).

 Response
{
  "recordings": [
    [40593, 490],[41240, 2870],[44112, 4806],[48920, 1100]
  ],
  "startTimestamp": 1613660400,
  "totalSeconds": 86400,
  "dstInfo": {
    "biasMinStart": 0,
    "biasMinEnd": 0,
    "biasDstMinStart": 0,
    "biasDstMinEnd": 0,
    "changeTimeSec": 0
  }
}

· recordings: 지정된 날짜의 녹화 배열.

· 각 녹화는 [seconds, duration] 쌍으로 표현됩니다:

· seconds: startTimestamp 이후의 비디오 시작 초.

· duration: 비디오 구간의 길이(초).

· startTimestamp: 녹화 시작 시간의 Unix 타임스탬프.

· totalSeconds: 하루의 총 초수. 서머타임(DST) 변경이 있는 날에는 이 값이 달라질 수 있습니다.

· dstInfo: 해당 날짜의 일광 절약 시간제(DST) 조정 정보를 제공합니다.

· biasMinStart / biasMinEnd: 해당 날짜 시작과 종료 시점의 분 단위 시간 차이.

· biasDstMinStart / biasDstMinEnd: DST 기간 시작과 종료 시점의 분 단위 시간 차이.

· changeTimeSec: 하루 시작 기준 초 단위로 표현된 시간 변경의 정확한 시점.

 

서머타임 정보 요청

 Request
http://<address>:<port>/reqDSTInfo?date=<YYYYMMDD>

· date: 서머타임(DST) 정보를 요청할 날짜를 YYYYMMDD 형식으로 지정.

 Response
{
  "dstInfo": {
    "biasMinStart": 0,
    "biasMinEnd": 0,
    "biasDstMinStart": 0,
    "biasDstMinEnd": 0,
    "changeTimeSec": 0
  }
}

· dstInfo: 해당 날짜의 일광 절약 시간제(DST) 조정 정보를 제공합니다.

· biasMinStart / biasMinEnd: 해당 날짜 시작과 종료 시점의 분 단위 시간 차이.

· biasDstMinStart / biasDstMinEnd: DST 기간 시작과 종료 시점의 분 단위 시간 차이.

· changeTimeSec: 하루 시작 기준 초 단위로 표현된 시간 변경의 정확한 시점.