

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

# GetHLSStreamingSessionURL
<a name="API_reader_GetHLSStreamingSessionURL"></a>

ストリームの HTTP ライブストリーミング (HLS) URL を取得します。その後、ブラウザまたはメディアプレーヤーで URL を開いて、ストリームのコンテンツを表示できます。

`StreamName` と `StreamARN` のパラメータは両方ともオプションですが、この API 操作を呼び出すときは `StreamName` または `StreamARN` を指定する必要があります。

Amazon Kinesis ビデオストリームには、HLS を介してデータを提供するための次の要件があります。
+  [動画再生トラックの要件](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html)。
+ データの保持期間が 0 より大きい。
+ 各フラグメントのビデオトラックには、H.264 形式の場合は AVC (Advanced Video Coding) 、H.265 形式の場合は HEVC ([MPEG-4 仕様 ISO/IEC 14496-15](https://www.iso.org/standard/55980.html)）のコーデックプライベートデータが含まれている必要があります。ストリームデータを特定の形式に適応させる方法については、「[NAL 適応フラグ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html)」を参照してください。
+ 各フラグメントのオーディオトラック（存在する場合）に、コーデックプライベートデータが AAC 形式 ([AAC specification ISO/IEC 13818-7](https://www.iso.org/standard/43345.html)) で含まれている必要があります。

Kinesis Video Streams HLS セッションには、フラグメント化された MPEG-4 形式（fmp4 または CMAF とも呼ばれる）または MPEG-2 形式（HLS 仕様でもサポートされている TS チャンクとも呼ばれる）のフラグメントが含まれています。HLS フラグメントタイプの詳細については、[HLS の仕様](https://tools.ietf.org/html/draft-pantos-http-live-streaming-23)を参照してください。

以下の手順は、Kinesis Video Streams で HLS を使用する方法を示しています。

1. `GetDataEndpoint` API を呼び出してエンドポイントを取得します。次に、[--endpoint-url parameter](https://docs.aws.amazon.com/cli/latest/reference/) を使用して `GetHLSStreamingSessionURL` リクエストをこのエンドポイントに送信します。

1. `GetHLSStreamingSessionURL` を使用して HLS URL を取得します。Kinesis Video Streams は、HLS プロトコルを使用してストリーム内のコンテンツにアクセスするために使用される HLS ストリーミングセッションを作成します。 `GetHLSStreamingSessionURL` は、セッションの * HLS マスタープレイリスト* (HLS でのストリーミングに必要なルートリソース) の認証済みURL (暗号化されたセッショントークンを含む) を返します。
**注記**  
許可されていないエンティティがアクセスできる場所に、このトークンを共有したり保存したりしないでください。トークンがストリームのコンテンツへのアクセスを提供します。認証情報で使用する AWS のと同じ方法でトークンを保護します。

   プレイリストを通じて利用できるメディアは、要求されたストリーム、時間範囲、および形式のみで構成されます。他のメディアデータ（リクエストされた画面外のフレーム、代替ビットレートなど）は利用できません。

1. HLS マスタープレイリストの URL（暗号化されたセッショントークンを含む）を、HLS プロトコルをサポートするメディアプレーヤーに指定します。Kinesis Video Streams は、HLS メディアプレイリスト、初期化フラグメント、およびメディアフラグメントをマスタープレイリスト URL から使用できるようにします。初期化フラグメントには、ストリームのコーデックプライベートデータ、およびビデオまたはオーディオデコーダーとレンダラーのセットアップに必要なその他のデータが含まれています。　　　　　　　 メディアフラグメントには、H.264 エンコードされたビデオフレームまたは AAC でエンコードされたオーディオサンプルが含まれています。

1. メディアプレーヤーは、認証された URL を受け取り、ストリームメタデータとメディアデータを通常通りリクエストします。メディアプレーヤーがデータを要求すると、次のアクションが呼び出されます。
   +  **GetHLSMasterPlaylist:** 各トラックの `GetHLSMediaPlaylist` アクションの URL と、推定ビットレートや解像度など、メディアプレーヤーの追加のメタデータを含む HLS マスタープレイリストを取得します。
   +  **GetHLSMediaPlaylist:** `GetMP4InitFragment` アクションで MP4 初期化フラグメントにアクセスするための URL と `GetMP4MediaFragment` アクションで MP4 メディアフラグメントにアクセスするための URL を含む HLS メディアプレイリストを取得します。HLSメディアプレイリストには、`PlaybackMode` が `LIVE` または `ON_DEMAND` の設定など、プレーヤーが再生するのに必要なストリームに関するメタデータも含まれています。HLS メディアプレイリストは通常、`PlaybackType` が `ON_DEMAND` のセッションでは静的です。HLS メディアプレイリストは、`PlaybackType` が `LIVE` のセッションの新しいフラグメントで継続的に更新されます。ビデオトラックとオーディオトラック（該当する場合）には、特定のトラックの MP4 メディア URL を含む個別の HLS メディアプレイリストがあります。
   +  **GetMP4InitFragment:** MP4 初期化フラグメントを取得。通常、メディアプレーヤーがメディアフラグメントをロードする前に、初期化フラグメントをロードします。このフラグメントには、「`fytp`」 および 「`moov`」MP4 atom 、およびメディアプレーヤーデコーダを初期化するために必要な子 atom が含まれています。

     初期化フラグメントは、Kinesis ビデオストリームのフラグメントには対応していません。これには、メディアプレーヤーがメディアフレームをデコードするために必要な、ストリームと各トラックのコーデックプライベートデータだけが含まれます。
   +  **GetMP4MediaFragment:** MP4 メディアフラグメントを取得。これらのフラグメントは、「`moof`」および「`mdat`」MP4 atom とその子 atom で構成され、エンコードされたフラグメントのメディアフレームとそのタイムスタンプを含みます。
**注記**  
各フラグメントに含まれるコーデックプライベートデータ (CPD) には、フラグメントを適切にデコードするために必要なフレームレート、解像度、エンコーディングプロファイルなどのコーデック固有の初期化情報が含まれています。TS と MP4 の両方で、CPD の変更はストリーミングセッション中にサポートされます。したがって、セッション内のフラグメントは、再生を中断することなく CPD で異なる情報を持つことができます。ストリーミングセッションごとに許可される CPD の変更は 500 個のみです。
**重要**  
トラックの変更はサポートされていません。トラックは、クエリされたメディア全体で一貫性を維持する必要があります。ストリーム内のフラグメントがビデオのみからオーディオとビデオの両方に変わった場合、または AAC オーディオトラックが A-Law オーディオトラックに変更された場合、ストリーミングは失敗します。

     このアクションで取得されたデータは請求対象です。詳細については、「[ 料金表](https://aws.amazon.com/kinesis/video-streams/pricing/)」を参照してください。
   +  **GetTSFragment** ストリーム内のすべてのトラックの初期化データとメディアデータの両方を含む MPEG TS フラグメントを取得します。
**注記**  
`ContainerFormat` が `MPEG_TS` の場合、`GetMP4InitFragment` と `GetMP4MediaFragment` の代わりにこのAPIを使用してストリームメディアを取得します。

     このアクションで取得されたデータは請求対象です。詳細については、「[Amazon Kinesis Video Streams の料金表](https://aws.amazon.com/kinesis/video-streams/pricing/)」を参照してください。

ストリーミングセッション URL をプレイヤー間で共有することはできません。複数のメディアプレーヤーがセッションを共有している場合、サービスはセッションをスロットリングする場合があります。接続制限については、[「Kinesis Video Streams クォータ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html)」を参照してください。

`GetMP4MediaFragment.OutgoingBytes` Amazon CloudWatch メトリックスをモニタリングすることで、メディアプレーヤーが消費するデータの量をモニタリングできます。CloudWatch を使用して Kinesis Video Streams をモニタリングする方法については、「[Monitoring Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html)」を参照してください。料金情報については、[Amazon Kinesis Video Streams の料金](https://aws.amazon.com/kinesis/video-streams/pricing/)と[AWS 料金](https://aws.amazon.com/pricing/)」を参照してください。HLS セッションと送信 AWS データの両方の料金が適用されます。

ドキュメントガイドの動画再生の例: [を使用して HLS ストリーミングセッション URL AWS CLI を取得する](hls-playback.md#retrieve-hls-url)および を参照してください[例: HTML および JavaScript で HLS を使用する](hls-playback.md#how-hls-ex1)。

HLSの詳細については、[Apple 開発者サイト](https://developer.apple.com)の [HTTP ライブストリーミング](https://developer.apple.com/streaming/)を参照してください。

**重要**  
Kinesis Video Streams アーカイブメディア API を呼び出した後にエラーがスローされた場合、HTTP ステータスコードとレスポンス本文に加えて、次の情報が含まれます。  
 `x-amz-ErrorType` HTTP ヘッダー — HTTP ステータスコードで提供されるものに加えて、より具体的なエラータイプが含まれます。
 `x-amz-RequestId` HTTP ヘッダー – 問題を に報告する場合 AWS、リクエスト ID を指定すれば、サポートチームが問題をより適切に診断できます。
HTTP ステータスコードと ErrorType ヘッダーの両方を使用すれば、エラーが再試行可能かどうか、またはどのような条件下でエラーが再試行可能かについてプログラムで判断したり、クライアントプログラマーが再度試行するために必要なアクションに関する情報を提供したりできます。  
詳細については、このトピックの下部にある**[Errors]** (エラー) セクションおよび「[Common Errors](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html)」を参照してください。

## リクエストの構文
<a name="API_reader_GetHLSStreamingSessionURL_RequestSyntax"></a>

```
POST /getHLSStreamingSessionURL HTTP/1.1
Content-type: application/json

{
   "ContainerFormat": "string",
   "DiscontinuityMode": "string",
   "DisplayFragmentTimestamp": "string",
   "Expires": number,
   "HLSFragmentSelector": { 
      "FragmentSelectorType": "string",
      "TimestampRange": { 
         "EndTimestamp": number,
         "StartTimestamp": number
      }
   },
   "MaxMediaPlaylistFragmentResults": number,
   "PlaybackMode": "string",
   "StreamARN": "string",
   "StreamName": "string"
}
```

## URI リクエストパラメータ
<a name="API_reader_GetHLSStreamingSessionURL_RequestParameters"></a>

リクエストでは URI パラメータを使用しません。

## リクエストボディ
<a name="API_reader_GetHLSStreamingSessionURL_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [ContainerFormat](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) **   <a name="KinesisVideo-reader_GetHLSStreamingSessionURL-request-ContainerFormat"></a>
メディアのパッケージ化に使用するフォーマットを指定します。`FRAGMENTED_MP4` コンテナ形式を指定すると、メディアが MP4 フラグメント（fMP4 または CMAF）にパッケージ化されます。これは、パッケージのオーバーヘッドが最小限なので、推奨されるパッケージングです。別のコンテナ形式オプションは `MPEG_TS` です。HLS は、リリースされてから MPEG TS チャンクをサポートしました。MPEG TS は、古い HLS プレーヤーでサポートされている唯一のパッケージである場合があります。MPEG TS は通常、5〜25 % のパッケージングオーバーヘッドがあります。つまり、MPEG TS は通常 fMP4 より 5～25 % 広い帯域幅とコストを必要とします。  
デフォルトは `FRAGMENTED_MP4` です。  
型: 文字列  
有効な値：`FRAGMENTED_MP4 | MPEG_TS`  
必須：いいえ

 ** [DiscontinuityMode](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) **   <a name="KinesisVideo-reader_GetHLSStreamingSessionURL-request-DiscontinuityMode"></a>
フラグメント間の不連続性を示すフラグをメディアプレイリストに追加するタイミングを指定します。  
メディアプレーヤーは通常、各フラグメントのタイムスタンプに基づいて、再生するメディアコンテンツのタイムラインを作成します。これは、フラグメント間でオーバーラップやギャップがある場合（一般に、[HLSFragmentSelector](API_reader_HLSFragmentSelector.md) が `SERVER_TIMESTAMP` に設定されている）、メディアプレーヤーのタイムラインでも一部の位置でフラグメント間に小さなギャップがあり、他の位置でフレームが上書きされることを意味します。メディアプレーヤーでタイムラインにギャップがあると、再生が停止したり、オーバーラップによって再生が不安定になる場合があります。フラグメント間に不連続フラグがある場合、メディアプレーヤーはタイムラインをリセットし、前のフラグメントの直後に次のフラグメントを再生します。  
次のモードがサポートされています。  
+  `ALWAYS`: 不連続マーカーは、HLS メディアプレイリストのすべてのフラグメントの間に配置されます。フラグメントのタイムスタンプが正確でない場合は、`ALWAYS` の値を使用することをお勧めします。　
+  `NEVER`: 不連続マーカーはどこにでも配置されません。メディアプレーヤーのタイムラインがプロデューサーのタイムスタンプに最適にマップされるように、`NEVER` の値を使用することをお勧めします。
+  `ON_DISCONTINUITY`：不連続マーカーは、50 ミリ秒を超えるギャップまたはオーバーラップを持つフラグメントの間に配置されます。ほとんどの再生シナリオでは、メディアタイムラインに重大な問題（フラグメントの欠落など）がある場合にのみメディアプレーヤーのタイムラインがリセットされるように、`ON_DISCONTINUITY` の値を使用することをお勧めします。
デフォルトでは、[HLSFragmentSelector](API_reader_HLSFragmentSelector.md) が `SERVER_TIMESTAMP` に設定されている場合は `ALWAYS`、`PRODUCER_TIMESTAMP` に設定されている場合は `NEVER` です。　  
型: 文字列  
有効な値：`ALWAYS | NEVER | ON_DISCONTINUITY`  
必須：いいえ

 ** [DisplayFragmentTimestamp](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) **   <a name="KinesisVideo-reader_GetHLSStreamingSessionURL-request-DisplayFragmentTimestamp"></a>
フラグメントの開始タイムスタンプを HLS メディアプレイリストに含めるタイミングを指定します。通常、メディアプレーヤーは、再生セッションの最初のフラグメントの開始に対して相対的な時間として再生ヘッドの位置を報告します。ただし、開始タイムスタンプが HLS メディアプレイリストに含まれている場合、一部のメディアプレーヤーは、フラグメントのタイムスタンプに基づいて現在の再生ヘッドを絶対時間として報告することがあります。これは、閲覧者にメディアのウォールクロック時刻を表示する再生エクスペリエンスを作成するのに便利です。  
デフォルトは `NEVER` です。[HLSFragmentSelector](API_reader_HLSFragmentSelector.md) が `SERVER_TIMESTAMP` の場合、タイムスタンプはサーバーの開始タイムスタンプになります。同様に、[HLSFragmentSelector](API_reader_HLSFragmentSelector.md) が `PRODUCER_TIMESTAMP` の場合、タイムスタンプはプロデューサーの開始タイムスタンプになります。  
型: 文字列  
有効な値：`ALWAYS | NEVER`  
必須：いいえ

 ** [Expires](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) **   <a name="KinesisVideo-reader_GetHLSStreamingSessionURL-request-Expires"></a>
要求されたセッションの有効期限が切れるまでの時間（秒）。この値は 300 (5 分) から 43200 (12 時間) の間です。  
セッションの有効期限が切れると、そのセッションに対して `GetHLSMasterPlaylist`、`GetHLSMediaPlaylist`、`GetMP4InitFragment`、`GetMP4MediaFragment`、または `GetTSFragment` への新しい呼び出しは行われません。  
デフォルトは300(5分)です。  
型: 整数  
値の範囲: 最小値 は 300 です。最大値は 43200 です。  
必須: いいえ

 ** [HLSFragmentSelector](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) **   <a name="KinesisVideo-reader_GetHLSStreamingSessionURL-request-HLSFragmentSelector"></a>
要求されたフラグメントの時間範囲とタイムスタンプのソース。  
このパラメーターは、`PlaybackMode` が `ON_DEMAND` または `LIVE_REPLAY` の場合に必要です。このパラメーターは、PlaybackMode が `` `LIVE` の場合にはオプションになります。`PlaybackMode` が `LIVE` の場合、`FragmentSelectorType` は設定できますが、`TimestampRange` は設定しないでください。`PlaybackMode` が `ON_DEMAND` または `LIVE_REPLAY` の場合、`FragmentSelectorType` と `TimestampRange` の両方を設定する必要があります。  
型: [HLSFragmentSelector](API_reader_HLSFragmentSelector.md) オブジェクト  
必須: いいえ

 ** [MaxMediaPlaylistFragmentResults](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) **   <a name="KinesisVideo-reader_GetHLSStreamingSessionURL-request-MaxMediaPlaylistFragmentResults"></a>
HLS メディアプレイリストで返されるフラグメントの最大数。  
`PlaybackMode` が `LIVE` の場合、最新のフラグメントがこの値まで返されます。`PlaybackMode` が `ON_DEMAND` の場合、この最大数まで、最も古いフラグメントが返されます。  
ライブ HLS メディアプレイリストでフラグメントの数が多い場合、ビデオプレーヤーは、再生を開始する前にコンテンツをバッファリングすることがよくあります。バッファサイズを大きくすると再生レイテンシーが増加しますが、再生中にバッファリングが発生する可能性は低くなります。ライブ HLS メディアプレイリストには、最低 3 つのフラグメントと最大 10 個のフラグメントを含めることをお勧めします。  
デフォルトでは、`PlaybackMode` が `LIVE` または `LIVE_REPLAY` の場合は 5 個のフラグメント、`PlaybackMode` が `ON_DEMAND` の場合は 1,000 個のフラグメントです。　   
5,000 フラグメントの最大値は、1 秒のフラグメントを含むストリームでは 80 分を超える動画に対応し、10 秒のフラグメント含むストリームでは 13 時間を超える動画に相当します。  
タイプ: Long  
有効範囲: 最小値は 1 です。最大値は 5,000 です。  
必須: いいえ

 ** [PlaybackMode](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) **   <a name="KinesisVideo-reader_GetHLSStreamingSessionURL-request-PlaybackMode"></a>
ライブ、ライブリプレイ、またはアーカイブ済のオンデマンドデータを取得するかどうか。  
3 種類のセッションの機能は次のとおりです。  
+  ** `LIVE` **：このタイプのセッションでは、HLS メディアプレイリストは、最新のフラグメントが利用可能になると継続的に更新されます。メディアプレーヤーは 1 秒間隔で新しいプレイリストを取得することをお勧めします。このタイプのセッションがメディアプレーヤーで再生される場合、ユーザーインターフェイスには、通常「live (ライブ)」通知が表示されます。再生ウィンドウ内の位置を選択するためのスクラバーコントロールはありません。
**注記**  
`LIVE` モードでは、フラグメント間にギャップ（フラグメントの欠落）がある場合でも、利用可能な最新のフラグメントが HLS メディアプレイリストに含まれます。このようなギャップにより、メディアプレーヤーが再生中に停止したり、途切れたりすることがあります。このモードでは、フラグメントがプレイリストの最新のフラグメントよりも古い場合、HLS メディアプレイリストに追加されません。後続のフラグメントがプレイリストに追加された後に欠落フラグメントが使用可能になっても、古いフラグメントは追加されず、ギャップは埋められません。
+  ** `LIVE_REPLAY` **：このタイプのセッションでは、HLS メディアプレイリストは、`LIVE` モードの更新方法と同様に更新されますが、特定の開始時刻からのフラグメントを含めることによって開始される点が異なります。フラグメントは、取り込まれるときに追加されるのではなく、次のフラグメントの期間が経過すると追加されます。例えば、セッション内のフラグメントの長さが 2 秒の場合、2 秒ごとに新しいフラグメントがメディアプレイリストに追加されます。このモードは、イベントの検出で再生を開始し、セッションの作成時点でまだ取り込まれていないライブストリーミングメディアを継続できるようにする場合に便利です。また、`ON_DEMAND` モードの 1,000 フラグメントの制限に制約されることなく、以前にアーカイブされたメディアをストリーミングする場合にも役立ちます。
+  ** `ON_DEMAND` **：このタイプのセッションの場合、HLS メディアプレイリストには、`MaxMediaPlaylistFragmentResults` で指定された数までのセッションのすべてのフラグメントが含まれます。プレイリストは、セッションごとに 1 回だけ取得する必要があります。このタイプのセッションがメディアプレーヤーで再生される場合、ユーザーインターフェイスには、通常再生ウィンドウ内の位置を選択するためのスクラバーコントロールが表示されます。
すべての再生モードで、`FragmentSelectorType` が `PRODUCER_TIMESTAMP` で、開始タイムスタンプが同じフラグメントが複数ある場合、フラグメント番号が大きいフラグメント（つまり、新しいフラグメント）が HLS メディアプレイリストに含まれます。他のフラグメントは含まれません。タイムスタンプは異なるが、期間が重複しているフラグメントは、HLS メディアプレイリストに引き続き含まれます。これにより、メディアプレーヤーで予期しない動作が発生する場合があります。  
デフォルトは `LIVE` です。  
型: 文字列  
有効な値：`LIVE | LIVE_REPLAY | ON_DEMAND`  
必須：いいえ

 ** [StreamARN](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) **   <a name="KinesisVideo-reader_GetHLSStreamingSessionURL-request-StreamARN"></a>
HLS マスタープレイリスト URL を取得するストリームの Amazon リソースネーム (ARN)。  
`StreamName` または `StreamARN` のパラメータを指定する必要があります。  
タイプ: 文字列  
長さの制限: 最小長は 1 です。最大長は 1,024 です。  
パターン: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`   
必須: いいえ

 ** [StreamName](#API_reader_GetHLSStreamingSessionURL_RequestSyntax) **   <a name="KinesisVideo-reader_GetHLSStreamingSessionURL-request-StreamName"></a>
HLS マスタープレイリスト URL を取得するストリームの名前。  
`StreamName` または `StreamARN` のパラメータを指定する必要があります。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `[a-zA-Z0-9_.-]+`   
必須: いいえ

## レスポンスの構文
<a name="API_reader_GetHLSStreamingSessionURL_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "HLSStreamingSessionURL": "string"
}
```

## レスポンス要素
<a name="API_reader_GetHLSStreamingSessionURL_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [HLSStreamingSessionURL](#API_reader_GetHLSStreamingSessionURL_ResponseSyntax) **   <a name="KinesisVideo-reader_GetHLSStreamingSessionURL-response-HLSStreamingSessionURL"></a>
メディアプレーヤーが HLS マスタープレイリストを取得するために使用できる URL（セッショントークンを含む）。  
タイプ: 文字列

## エラー
<a name="API_reader_GetHLSStreamingSessionURL_Errors"></a>

すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。

 ** ClientLimitExceededException **   
制限を超えたため、Kinesis Video Streams がリクエストをスロットリングしました。後で呼び出しを試みてください。制限の詳細については、[「Kinesis Video Streams クォータ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html)」を参照してください。  
HTTP ステータスコード: 400

 ** InvalidArgumentException **   
指定されたパラメータが制限を超えているか、サポートされていない、または使用できません。  
HTTP ステータスコード: 400

 ** InvalidCodecPrivateDataException **   
ビデオストリームの少なくとも 1 つのトラックにあるコーデックのプライベートデータは、この操作には無効です。  
HTTP ステータスコード: 400

 ** MissingCodecPrivateDataException **   
ビデオストリームの少なくとも 1 つのトラックにコーデックのプライベートデータがありませんでした。  
HTTP ステータスコード: 400

 ** NoDataRetentionException **   
 `GetImages` は、データを保持しないストリーム (つまり、 `DataRetentionInHours`の が 0) に対してリクエストされました。  
HTTP ステータスコード: 400

 ** NotAuthorizedException **   
ステータスコード: 403 呼び出し元が指定されたストリームで操作を実行する権限がないか、トークンの有効期限が切れています。  
HTTP ステータスコード: 401

 ** ResourceNotFoundException **   
 `GetImages` Kinesis Video Streams が指定したストリームを見つけられない場合、 はこのエラーをスローします。  
 `GetHLSStreamingSessionURL` リクエストされた時間範囲内にフラグメントがないストリームに対して `ON_DEMAND`または `PlaybackMode`のセッション`LIVE_REPLAY`がリクエストされた場合、または過去 30 秒以内にフラグメントがないストリームに対して `PlaybackMode`のセッション`LIVE`がリクエストされた場合、 と はこのエラーを`GetDASHStreamingSessionURL`スローします。  
HTTP ステータスコード: 404

 ** UnsupportedStreamMediaTypeException **   
メディアのタイプ (h.264 または h.265 ビデオ、AAC または G.711 オーディオなど) は、再生セッションの最初のフラグメントのトラックのコーデック IDs から判断できませんでした。トラック 1 のコーデック ID は `V_MPEG/ISO/AVC` である必要があります。また、オプションでトラック 2 のコーデック ID は `A_AAC` である必要があります。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_reader_GetHLSStreamingSessionURL_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetHLSStreamingSessionURL) 