第3章 HLS API

設定

構成でいくつかの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は1番目のサブチャンネル、2は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`）に設定されている場合、HLSビデオはナビゲーションなしのライブモードでストリーミングされます（キープアライブ信号は不要）。

· 期間が10秒などの正の値に設定されている場合、VMSサーバーがHLSビデオファイルを削除しないように、2秒ごとにキープアライブ信号を送信する必要があります。

{
  "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: ユニークなファイルID。

· timestamp: 映像フレームの時間をUnixタイムスタンプ形式で指定します。

· duration":

· 期間がゼロ（`0`）に設定されている場合、HLSビデオはナビゲーションなしのライブモードでストリーミングされます（キープアライブ信号は不要）。

· 期間が10秒などの正の値に設定されている場合、VMSサーバーがHLSビデオファイルを削除しないように、2秒ごとにキープアライブ信号を送信する必要があります。

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

· id: キープアライブ信号を送信するための一意のIDです。このIDはストリームをアクティブに保つために後続のリクエストで使用する必要があります。

· path: HLSストリームにアクセスするためのURLパスです。

プレイバック HLS ストリーミングのキープアライブ信号送信

### 録画ビデオ再生
http://<address>:<port>>/reqPlaybackKeepAlive?id=<id.no>
### アーカイブビデオ再生
http://<address>:<port>>/reqFilePlaybackKeepAlive?id=<id.no>

· id_no: 「プレイバック HLS ストリーミングのリクエスト」の応答で受け取った一意の識別子。このIDはHLSストリームをアクティブ状態に保つために使用されます。