StartSelector

GetMedia API がメディアデータの返送を開始する Kinesis ビデオストリームのチャンクを識別します。開始チャンクを識別するには、次のオプションがあります。

• 最後の (または最も古い) チャンクを選択します。

• 特定のチャンクを識別します。特定のチャンクを識別するには、フラグメント番号またはタイムスタンプ (サーバーまたはプロデューサー) を指定します。

• 各チャンクのメタデータには、Matroska (MKV) タグ (AWS_KINESISVIDEO_CONTINUATION_TOKEN) として継続トークンが含まれています。前の GetMedia リクエストが終了した場合、このタグ値を次の GetMedia リクエストで使用できます。次に、API は、最後の API が終了した場所からチャンクの返送を開始します。

コンテンツ

StartSelectorType

データの取得を開始する Kinesis ビデオストリーム上のフラグメントを識別します。

• NOW – ストリームの最後のチャンクから開始します。

• EARLIEST – ストリームの利用可能な最初のチャンクから開始します。

• FRAGMENT_NUMBER – 特定のフラグメントの後のチャンクから開始します。また、AfterFragmentNumber パラメータを指定する必要があります。

• PRODUCER_TIMESTAMP または SERVER_TIMESTAMP – 指定したプロデューサーまたはサーバーのタイムスタンプを持つフラグメントを含むチャンクから開始します。StartTimestamp を追加してタイムスタンプを指定します。

• CONTINUATION_TOKEN – 指定した継続トークンを使用して読み込みます。

注記

NOW、EARLIEST、または CONTINUATION_TOKEN を startSelectorType として選択する場合、startSelector に追加情報を入力しません。

型: 文字列

有効な値：FRAGMENT_NUMBER | SERVER_TIMESTAMP | PRODUCER_TIMESTAMP | NOW | EARLIEST | CONTINUATION_TOKEN

必須: はい

AfterFragmentNumber

GetMedia API がフラグメントの返送を開始するフラグメント番号を指定します。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 128 です。

Pattern: ^[0-9]+$

必須: いいえ

ContinuationToken

Kinesis Video Streams が前の GetMedia 応答で返した継続トークン。次に、GetMedia API は、継続トークンで識別されるチャンクから開始します。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 128 です。

Pattern: ^[a-zA-Z0-9_\.\-]+$

必須: いいえ

StartTimestamp

タイムスタンプ値。この値は、PRODUCER_TIMESTAMP または SERVER_TIMESTAMP を startSelectorType として選択した場合に必要です。次に、GetMedia API は、指定したタイムスタンプを持つフラグメントを含むチャンクから開始します。

型: タイムスタンプ

必須：いいえ

その他の参照資料

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。

• AWS SDK for C++

• AWS Java V2 用 SDK

• AWS ルビー V3 用 SDK