Kinesis Video Streams データモデル

Kinesis Video Streams へのアップロード および パーサーライブラリを使用してカメラからの出力を監視する は、動画データに伴う情報の埋め込みをサポートする形式で動画データを送受信します。この形式は Matroska (MKV) 仕様に基づいています。

MKV 形式は、メディアデータのオープン仕様です。Amazon Kinesis Video Streams デベロッパーガイドのすべてのライブラリとコード例は、 MKV形式でデータを送受信します。

Kinesis Video Streams へのアップロード は、 StreamDefinitionおよび MKV Frameタイプを使用して、ストリームヘッダー、フレームヘッダー、フレームデータを生成します。

仕様の詳細については、「Matroska MKV仕様」を参照してください。 https://www.matroska.org/technical/specs/index.html

以下のセクションでは、 によって生成される MKV形式のデータのコンポーネントについて説明しますC++。

ストリームヘッダー要素

次のMKVヘッダー要素は StreamDefinition ( で定義) によって使用されますStreamDefinition.h。

要素	説明	一般的な値
stream_name	Kinesis のビデオストリームの名前。	my-stream
retention_period	ストリームデータが Kinesis Video Streams によって保持される時間単位の期間。データを保持しないストリーム0には を指定します。	24
[タグ]	ユーザーデータのキーと値のコレクション。このデータは AWS Management Console に表示され、クライアントアプリケーションにより読み取ることでストリームに関する情報をフィルタリングまたは取得できます。
kms_key_id	存在する場合、ユーザー定義 AWS KMS キーを使用してストリーム上のデータを暗号化します。存在しない場合、データは Kinesis が提供するキー () によって暗号化されますaws/kinesisvideo。	01234567-89ab-cdef-0123-456789ab
streaming_type	現在、有効なストリーミングタイプは STREAMING_TYPE_REALTIME のみです。	STREAMING_TYPE_REALTIME
content_type	ユーザー定義のコンテンツタイプ。動画データをストリーミングしてコンソールで再生する場合、コンテンツタイプは video/h264 である必要があります。	video/h264
max_latency	この値は現在使用されていないため、0 に設定する必要があります。	0
fragment_duration	フラグメントの継続時間 (推定)。この時間が最適化に使用されます。実際のフラグメント継続時間は、ストリーミングデータによって決定します。	2
timecode_scale	フレームタイムスタンプで使用されるスケールを示します。デフォルト値は 1 ミリ秒です。0 を指定すると、デフォルト値の 1 ミリ秒も割り当てられます。この値は 100 ナノ秒～1 秒の範囲で指定できます。 詳細については、Matroska ドキュメントTimecodeScaleの「」を参照してください。
key_frame_fragmentation	true の場合、ストリームはキーフレームが受信された場合に新たなクラスターを開始します。	true
frame_timecodes	の場合true、Kinesis Video Streams は受信したフレームの表示タイムスタンプ (pts) とデコードタイムスタンプ (dts) の値を使用します。の場合false、Kinesis Video Streams はシステム生成の時間値でフレームを受信したときにフレームをスタンプします。	true
absolute_fragment_time	true の場合、クラスタータイムコードは絶対時間 (プロデューサーのシステムクロックなど) を用いて解釈されます。false の場合、クラスタータイムコードはストリームの開始時刻の相対値として解釈されます。	true
fragment_acks	の場合true、Kinesis Video Streams がデータを受信すると確認応答 (ACKs) が送信されます。は、 KinesisVideoStreamFragmentAckまたは KinesisVideoStreamParseFragmentAckコールバックを使用して受信ACKsできます。	true
restart_on_error	ストリームのエラーが発生した後、ストリームが送信を再開すべきかどうかを示します。	true
nal_adaptation_flags	NAL (Network Abstraction Layer) 適応またはコーデックプライベートデータがコンテンツに存在するかどうかを示します。有効なフラグには NAL_ADAPTATION_ANNEXB_NALS および NAL_ADAPTATION_ANNEXB_CPD_NALS が含まれます。	NAL_ADAPTATION_ANNEXB_NALS
frame_rate	コンテンツの推定フレームレート。この値は最適化に使用され、実際のフレームレートは受信データのレートにより決定されます。0 を指定すると、デフォルトの 24 が割り当てられます。	24
avg_bandwidth_bps	コンテンツ帯域幅の Mbps 単位の推定値。この値は最適化に使用され、実際のレートは受信データの帯域幅により決定されます。例えば、25 で実行されている 720 p 解像度のビデオストリームの場合FPS、平均帯域幅は 5 Mbps と予想できます。	5
buffer_duration	コンテンツがプロデューサー上でバッファされる時間。ネットワークレイテンシーが低い場合は、この値を減らすことができます。ネットワークレイテンシーが高い場合、この値を大きくすると、割り当てがフレームをより小さいバッファに入れることに失敗したため、送信前にフレームがドロップされるのを防ぎます。
replay_duration	接続が失われた場合にビデオデータストリームが「巻き戻し」される時間。接続損失によるフレームの損失が懸念されない場合、この値はゼロになる可能性があります。消費するアプリケーションが冗長フレームを削除できる場合は、値を増やすことができます。この値はバッファ期間よりも短くする必要があります。そうでない場合はバッファ期間が使用されます。
connection_staleness	データが受信されない場合に接続を維持する期間。
codec_id	コンテンツで使用されるコーデック。詳細情報については Matroska 仕様の「CodecID」を参照してください。	V_MPEG2
track_name	ユーザー定義のトラック名。	my_track
codecPrivateData	多くのダウンストリームコンシューマーにおいて必要となる、フレームデータのデコードのためにエンコーダーが提供するデータ (ピクセル単位でのフレーム幅および高さなど)。C++ プロデューサーライブラリでは、 のgMkvTrackVideoBits配列にフレームのピクセル幅と高さMkvStatics.cppが含まれます。
codecPrivateData[Size] (サイズ)	codecPrivateData パラメータのデータのサイズ。
track_type	ストリームのトラックのタイプ。	MKV_TRACKINFO_TYPE_ AUDIOまたは MKV_TRACK_INFO_TYPE_VIDEO
segment_uuid	ユーザー定義のセグメント uuid (16 バイト)。
default_track_id	トラックの、一意のゼロ以外の数。	1

トラックデータのストリーミング

次のMKVトラック要素は StreamDefinition ( で定義) によって使用されますStreamDefinition.h。

要素	説明	一般的な値
track_name	ユーザー定義のトラック名。たとえば、オーディオトラック用の「audio」。	audio
codec_id	トラック用のコーデック ID。例えば、オーディオトラックの「A_AAC」などです。	A_AAC
cpd	フレームデータのデコードのためにエンコーダーが提供するデータ。このデータには、フレームの幅と高さ (ピクセル単位) を含めることができます。この情報は多くのダウンストリームコンシューマーで必要となります。C++ プロデューサーライブラリでは、 MkvStatics.cpp の gMkvTrackVideoBits 配列にフレームのピクセル幅と高さが含まれます。
cpd_size	codecPrivateData パラメータのデータのサイズ。
track_type	トラックのタイプ。例えば、オーディオには MKV_TRACK_INFOTYPE_AUDIO の列挙値を使用できます。	MKV_TRACK_INFO_TYPE_AUDIO

フレームヘッダー要素

次のMKVヘッダー要素は、 によって使用されます Frame ( KinesisVideoPic パッケージ、 で定義mkvgen/Include.h）。

• Frame Index: 一定間隔で増加する値。

• Flags: フレームのタイプ。有効な値には次のようなものがあります。

  • FRAME_FLAGS_NONE

  • FRAME_FLAG_KEY_FRAME: key_frame_fragmentation がストリーム上で設定されている場合、キーフレームは新たなフラグメントを開始します。

  • FRAME_FLAG_DISCARDABLE_FRAME: デコーダーに対し、デコーディングが遅い場合はこのフレームを破棄できることを通知します。

  • FRAME_FLAG_INVISIBLE_FRAME: このブロックの時間は 0 です。

• Decoding Timestamp: このフレームがデコードされた時刻のタイムスタンプ。以前のフレームがデコードのためにこのフレームに依存している場合、このタイムスタンプは以前のフレームよりも前になる可能性があります。この値はフラグメントの開始の相対値です。

• プレゼンテーションタイムスタンプ： このフレームが表示されるときのタイムスタンプ。この値はフラグメントの開始の相対値です。

• Duration: フレームの再生時間。

• Size: フレームデータのサイズ (バイト単位)

MKV フレームデータ

frame.frameData 内のデータには、使用されるエンコーディングスキーマに応じ、フレームのメディアデータのみが含まれている場合、あるいはさらにネスト化されたヘッダー情報が含まれている場合があります。に表示するには AWS Management Console、データを H.264 コーデックでエンコードする必要がありますが、Kinesis Video Streams は任意の形式で時間シリアル化されたデータストリームを受信できます。