英文 | 韩文 | 中文 | 日文

第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":false, "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: 夏令时期间开始和结束时的分钟级时间差。

· changeTimeSec: 从当天开始计算的秒数,表示时间变更的精确时刻。

 

请求夏令时信息

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

· date: 指定请求夏令时信息的日期,格式为 `YYYYMMDD`。

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

· dstInfo: 提供该日期的夏令时(DST)调整信息。

· biasMinStart / biasMinEnd: 该日期开始和结束时的分钟级时间差。

· biasDstMinStart / biasDstMinEnd: 夏令时期间开始和结束时的分钟级时间差。

· changeTimeSec: 从当天开始计算的秒数,表示时间变更的精确时刻。