英語 | 韓国語 | 中国語 | 日本語

第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,
   "ptz":false, "live_hls":true,
   "recordingStart": "2025-04-01", "recordingEnd": "2025-04-17"},
   ...
  {"ch":8, "sub":0, "title":"Playground", "connected":false, "recording":false,
   "ptz":false, "live_hls":true,
   "recordingStart": "2025-04-01", "recordingEnd": "2025-04-17"}
]

· ch: チャンネル番号。

· sub: サブストリームのインデックス。0はプライマリーチャンネル、1は第1サブチャンネル、2は第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: その日の開始からの秒数で表される時刻変更の正確なタイミング。

 

DST情報のリクエスト

 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: サマータイム期間の開始時と終了時における分単位の時差。

· changeTimeSec: その日の開始からの秒数で表される時刻変更の正確なタイミング。