StartSelector - Amazon Kinesis Video Streams
内容以下の資料も参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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 です。

パターン: ^[0-9]+$

必須: いいえ

ContinuationToken

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

タイプ: 文字列

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

パターン: ^[a-zA-Z0-9_\.\-]+$

必須: いいえ

StartTimestamp

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

型: タイムスタンプ

必須: いいえ

以下の資料も参照してください。

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