翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Kinesis Video Streams データモデル
[Kinesis Video Streams へのアップロード](producer-sdk.md) および [パーサーライブラリを使用してカメラからの出力を監視する](parser-library.md) は、動画データに伴う情報の埋め込みをサポートする形式で動画データを送受信します。この形式は Matroska (MKV) 仕様に基づいています。
[MKV 形式](https://en.wikipedia.org/wiki/Matroska)は、メディアデータに対するオープン仕様です。*Amazon Kinesis Video Streams Developer Guide* 内のすべてのライブラリおよびコードの例は、MKV 形式でデータを送受信します。
[Kinesis Video Streams へのアップロード](producer-sdk.md) は `StreamDefinition`および `Frame`タイプを使用して、MKV ストリームヘッダー、フレームヘッダー、フレームデータを生成します。
MKV 仕様の詳細については「[Matroska Specification](https://www.matroska.org/technical/specs/index.html)」を参照してください。
以下のセクションでは、[C\$1\$1](producer-sdk-cpp.md) によって作成された MKV 形式データのコンポーネントについて説明します。
**Topics**
+ [ストリームヘッダー要素](#how-data-header-streamdefinition)
+ [トラックデータをストリーミングする](#how-data-header-streamtrack)
+ [フレームヘッダー要素](#how-data-header-frame)
+ [MKV フレームデータ](#how-data-frame)
## ストリームヘッダー要素
`StreamDefinition` では次の MKV ヘッダー要素が使用されます (`StreamDefinition.h` で定義)。
****
| Element | 説明 | 一般的な値 |
| --- | --- | --- |
| stream\$1name | Kinesis のビデオストリームの名前。 | my-stream |
| retention\$1period | ストリームデータが Kinesis Video Streams によって保持される時間単位の期間。データを保持しないストリーム0に を指定します。 | 24 |
| [タグ] | ユーザーデータのキーと値のコレクション。このデータは AWS マネジメントコンソール に表示され、クライアントアプリケーションにより読み取ることでストリームに関する情報をフィルタリングまたは取得できます。 | |
| kms\$1key\$1id | 存在する場合、ユーザー定義 AWS KMS キーを使用してストリーム上のデータを暗号化します。存在しない場合、データは Kinesis が提供するキー () によって暗号化されますaws/kinesisvideo。 | 01234567-89ab-cdef-0123-456789ab |
| streaming\$1type | 現在、有効なストリーミングタイプは STREAMING\$1TYPE\$1REALTIME のみです。 | STREAMING\$1TYPE\$1REALTIME |
| content\$1type | ユーザー定義のコンテンツタイプ。動画データをストリーミングしてコンソールで再生する場合、コンテンツタイプは video/h264 である必要があります。 | video/h264 |
| max\$1latency | この値は現在使用されていないため、0 に設定する必要があります。 | 0 |
| fragment\$1duration | フラグメントの継続時間 (推定)。この時間が最適化に使用されます。実際のフラグメント継続時間は、ストリーミングデータによって決定します。 | 2 |
| timecode\$1scale | フレームタイムスタンプで使用されるスケールを示します。デフォルト値は 1 ミリ秒です。`0` を指定すると、デフォルト値の 1 ミリ秒も割り当てられます。この値は 100 ナノ秒～1 秒の範囲で指定できます。 詳細については、Matroska のドキュメントの「[TimecodeScale](https://matroska.org/technical/specs/notes.html#TimecodeScale)」を参照してください。 | |
| key\$1frame\$1fragmentation | true の場合、ストリームはキーフレームが受信された場合に新たなクラスターを開始します。 | true |
| frame\$1timecodes | の場合true、Kinesis Video Streams は受信したフレームの表示タイムスタンプ (pts) とデコードタイムスタンプ (dts) の値を使用します。の場合false、Kinesis Video Streams はシステム生成の時間値でフレームを受信したときにフレームをスタンプします。 | true |
| absolute\$1fragment\$1time | true の場合、クラスタータイムコードは絶対時間 (プロデューサーのシステムクロックなど) を用いて解釈されます。false の場合、クラスタータイムコードはストリームの開始時刻の相対値として解釈されます。 | true |
| fragment\$1acks | true の場合、Kinesis Video Streams がデータを受信した際に確認 (ACK) が送信されます。ACK は KinesisVideoStreamFragmentAck または KinesisVideoStreamParseFragmentAck コールバックを用いて受信できます。 | true |
| restart\$1on\$1error | ストリームのエラーが発生した後、ストリームが送信を再開すべきかどうかを示します。 | true |
| nal\$1adaptation\$1flags | コンテンツ内に NAL (Network Abstraction Layer) 適応またはコーデックプライベートデータが含まれるかどうかを示します。有効なフラグには NAL\$1ADAPTATION\$1ANNEXB\$1NALS および NAL\$1ADAPTATION\$1ANNEXB\$1CPD\$1NALS が含まれます。 | NAL\$1ADAPTATION\$1ANNEXB\$1NALS |
| frame\$1rate | コンテンツの推定フレームレート。この値は最適化に使用され、実際のフレームレートは受信データのレートにより決定されます。0 を指定すると、デフォルトの 24 が割り当てられます。 | 24 |
| avg\$1bandwidth\$1bps | コンテンツ帯域幅の推定値。Mbps 単位。この値は最適化に使用され、実際のレートは受信データの帯域幅により決定されます。たとえば、25 FPS で動作する 720p の解像度のビデオストリームでは、平均 5 Mbps の帯域幅を期待できます。 | 5 |
| buffer\$1duration | コンテンツがプロデューサー上でバッファされる時間。ネットワークレイテンシーが低い場合、この値を減らすことができます。ネットワークレイテンシーが高い場合、この値を大きくすると、割り当てが小さいバッファにフレームを配置できないため、送信前にフレームがドロップされるのを防ぎます。 | |
| replay\$1duration | 接続が失われた場合にビデオデータストリームが「巻き戻」される時間。接続損失によるフレームの損失が懸念されない場合、この値はゼロになります。消費するアプリケーションが冗長フレームを削除できる場合は、値を増やすことができます。この値はバッファ期間より短くする必要があります。そうでない場合はバッファ期間が使用されます。 | |
| connection\$1staleness | データが受信されない場合に接続を維持する期間。 | |
| codec\$1id | コンテンツで使用されるコーデック。詳細情報については Matroska 仕様の「[CodecID](https://matroska.org/technical/specs/codecid/index.html)」を参照してください。 | V\$1MPEG2 |
| track\$1name | ユーザー定義のトラック名。 | my\$1track |
| codecPrivateData | 多くのダウンストリームコンシューマーにおいて必要となる、フレームデータのデコードのためにエンコーダーが提供するデータ (ピクセル単位でのフレーム幅および高さなど)。[C\$1\$1 プロデューサーライブラリ](producer-sdk-cpp.md)では、 のgMkvTrackVideoBits配列にフレームのピクセル幅と高さMkvStatics.cppが含まれます。 | |
| codecPrivateDataSize | codecPrivateData パラメータのデータのサイズ。 | |
| track\$1type | ストリームのトラックのタイプ。 | MKV\$1TRACK\$1INFO\$1TYPE\$1AUDIO または MKV\$1TRACK\$1INFO\$1TYPE\$1VIDEO |
| segment\$1uuid | ユーザー定義のセグメント uuid (16 バイト)。 | |
| default\$1track\$1id | トラックの、一意のゼロ以外の数。 | 1 |
## トラックデータをストリーミングする
`StreamDefinition` では次の MKV トラック要素が使用されます (`StreamDefinition.h` で定義)。
****
| Element | 説明 | 一般的な値 |
| --- | --- | --- |
| track\$1name | ユーザー定義のトラック名。たとえば、オーディオトラック用の「audio」。 | audio |
| codec\$1id | トラック用のコーデック ID。たとえば、オーディオトラック用の「A\$1AAC」。 | A\$1AAC |
| cpd | フレームデータのデコードのためにエンコーダーが提供するデータ。このデータには、フレームの幅と高さ (ピクセル単位) を含めることができます。この情報は多くのダウンストリームコンシューマーで必要となります。[C\$1\$1 プロデューサーライブラリ](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/producer-sdk-cpp.html)では、MkvStatics.cpp の gMkvTrackVideoBits 配列にフレームのピクセル幅と高さが含まれています。 MkvStatics.cpp | |
| cpd\$1size | codecPrivateData パラメータのデータサイズ。 | |
| track\$1type | トラックのタイプ。たとえば、オーディオ用の MKV\$1TRACK\$1INFO\$1TYPE\$1AUDIO の列挙値を使用できます。 | MKV\$1TRACK\$1INFO\$1TYPE\$1AUDIO |
## フレームヘッダー要素
`Frame` では次の MKV ヘッダー要素が使用されます (`mkvgen/Include.h` の `KinesisVideoPic` パッケージで定義)。
+ **Frame Index:** 一定間隔で増加する値。
+ **Flags:** フレームのタイプ。有効な値は次のとおりです。
+ `FRAME_FLAGS_NONE`
+ `FRAME_FLAG_KEY_FRAME`: `key_frame_fragmentation` がストリーム上で設定されている場合、キーフレームは新たなフラグメントを開始します。
+ `FRAME_FLAG_DISCARDABLE_FRAME`: デコーダーに対し、デコーディングが遅い場合はこのフレームを破棄できることを通知します。
+ `FRAME_FLAG_INVISIBLE_FRAME`: このブロックの時間は 0 です。
+ **デコードタイムスタンプ:** このフレームがデコードされた時刻のタイムスタンプ。以前のフレームがデコードのためにこのフレームに依存している場合、このタイムスタンプは以前のフレームよりも前になる可能性があります。この値はフラグメントの開始の相対値です。
+ **プレゼンテーションタイムスタンプ:** このフレームが表示されるときのタイムスタンプ。この値はフラグメントの開始の相対値です。
+ **Duration:** フレームの再生時間。
+ **Size:** フレームデータのサイズ (バイト単位)
## MKV フレームデータ
`frame.frameData` 内のデータには、使用されるエンコーディングスキーマに応じ、フレームのメディアデータのみが含まれている場合、あるいはさらにネスト化されたヘッダー情報が含まれている場合があります。に表示するには AWS マネジメントコンソール、データを [H.264](https://en.wikipedia.org/wiki/H.264/MPEG-4_AVC) コーデックでエンコードする必要がありますが、Kinesis Video Streams はタイムシリアル化されたデータストリームを任意の形式で受信できます。