| MKV タイムコードスケール (ミリ秒単位)。MKV クラスター内でフレームのタイムコードの詳細度を指定します。MKV フレームのタイムコードは、常にクラスターの開始を基準にします。MKV では、符号付きの 16 ビット値 (0 〜 32767) を使用してクラスター内のタイムコード (フラグメント) を示します。フレームタイムコードが指定されたタイムコードスケールで表現できることを確認します。タイムコードスケール値のデフォルトである 1 ミリ秒の場合、表現できるフレームの最大値は 32,767 ミリ秒 \$1= 32 秒です。これは、[Amazon Kinesis Video Streams サービスクォータ](limits.md) で指定されたフラグメント継続時間の最大値 (10 秒) を超えます。 | 1 |
| key\$1frame\$1fragmentation | bool | キーフレームでフラグメントを生成するかどうかを指定します。true の場合、SDK はキーフレームがあるたびにフラグメントの開始を生成します。false の場合、Kinesis Video Streams は少なくとも fragment\$1duration の期間待機してから、その後のキーフレームで新しいフラグメントを生成します。 | true |
| frame\$1timecodes | bool | フレームのタイムコードを使用するか、現在時刻のコールバックを使用してタイムスタンプを生成するかどうかを指定します。多くのエンコーダーでは、フレームでタイムスタンプを生成しません。したがって、このパラメータに false を指定すると、確実にフレームがタイムスタンプ付きで Kinesis Video Streams に配置されます。 | true |
| absolute\$1fragment\$1times | bool | Kinesis Video Streams では、基盤となるパッケージング機構として MKV を使用します。MKV の仕様では、クラスターの開始地点 (フラグメント) に相対するフレームのタイムコードは厳格です。ただし、クラスターのタイムコードはストリームの開始時刻に対して相対値の場合と絶対値の場合があります。タイムスタンプが相対値である場合、PutMedia サービスの API コールでは、オプションであるストリームの開始タイムスタンプを使用して、クラスターのタイムスタンプを調整します。このサービスで保存されるフラグメントには常に絶対値のタイムスタンプが使用されます。 | true |
| fragment\$1acks | bool | アプリケーションレベルのフラグメント ACKs (承認) を受け取るかどうか。 | true の場合、SDK は ACK を受け取り、相応に対応します。 |
| restart\$1on\$1error | bool | 特定のエラー発生時に再開するかどうかを指定します。 | true の場合、SDK はエラー発生時にストリーミングの再開を試行します。 |
| recalculate\$1metrics | bool | メトリクスを再計算するかどうかを指定します。メトリクスを取得するための呼び出しごとに、再計算によって最新の「実行中」の値が取得されます。これに伴って CPU に小さな影響が生じます。電力やフットプリントが極端に低いデバイスでは、これを false に設定して、CPU サイクルの消費を抑える必要があります。それ以外の場合は、この値falseに を使用することはお勧めしません。 | true |
| nal\$1adaptation\$1flags | uint32\$1t | Network Abstraction Layer unit (NALU) 適応フラグを指定します。ビットストリームが H.264 でエンコードされている場合、NALU で未加工またはパッケージとして処理できます。これは Annex-B 形式または AVCC 形式のいずれかになります。ほとんどの基本ストリームプロデューサーとコンシューマー (読み取りエンコーダーとデコーダー) は、エラー復旧などの利点があるため、Annex-B 形式を使用します。高レベルのシステムでは AVCC 形式を使用します。これは、MPEG、HLS、DASH などのデフォルト形式です。コンソールの再生では、ブラウザの MSE (Media Source Extensions) を使用して、AVCC 形式を使用するストリームをデコードして再生します。H.264 (および M-JPEG と H.265) の場合、SDK には適応機能が用意されています。 多くの基本ストリームは次の形式になります。この例では、`Ab` は Annex-B 開始コード (001 または 0001) です。 Ab(Sps)Ab(Pps)Ab(I-frame)Ab(P/B-frame) Ab(P/B-frame)…. Ab(Sps)Ab(Pps)Ab(I-frame)Ab(P/B-frame) Ab(P/B-frame)
H.264 の場合、コーデックプライベートデータ (CPD) は SPS (シーケンスパラメータセット) および PPS (ピクチャパラメータセット) パラメータにあり、AVCC 形式に適応できます。メディアパイプラインで個別に CPD を指定しない限り、アプリケーションはフレームから CPD を抽出します。これを行うには、最初の IDR フレーム (SPS と PPS を含む必要があります) を探し、2 つの NALUs ( ) を抽出`Ab(Sps)Ab(Pps)`して、 の CPD に設定します`StreamDefinition`。 詳細については、「[Network Abstraction Layer (NAL) 適応フラグを参照](producer-reference-nal.md)」を参照してください。 | デフォルトでは、フレームデータとコーデックプライベートデータの両方で Annex-B 形式を AVCC 形式に適応させます。 |
| frame\$1rate | uint32\$1t | 予想されるフレームレート。この値を使用してバッファリングニーズの計算を効率化できます。 | 25 |
| avg\$1bandwidth\$1bps | uint32\$1t | ストリームの予想される平均帯域幅。この値を使用してバッファリングニーズの計算を効率化できます。 | 4 \$1 1024 \$1 1024 |
| buffer\$1duration | duration | ストリームのバッファ期間 (秒単位)。SDK は、最大 のフレームをコンテンツストアに保持しbuffer\$1duration、その後、ウィンドウが進むにつれて前のフレームがドロップされます。ドロップされているフレームがバックエンドに送信されていない場合、ドロップされたフレームコールバックが呼び出されます。現在のバッファ期間が max\$1latency より大きい場合、ストリームのレイテンシープレッシャーコールバックが呼び出されます。フラグメントの永続化 ACK が受信されると、バッファはトリミングされて次のフラグメント開始地点に送られます。これは、コンテンツがクラウド内で永続的に保持されるため、コンテンツをローカルデバイスに保存する必要がなくなるためです。 | 120 |
| replay\$1duration | duration | 再起動が有効になっている場合に、エラー発生時に現在のリーダーをロールバックして再生する秒単位の期間。ロールバックはバッファの開始位置で停止します (ストリーミングを開始したばかりであるか、永続化 ACK が受信された場合)。ロールバックは、フラグメントの開始を示すキーフレームを確定しようとします。「再起動の原因」というエラーがデッドホストを示していない場合 (ホストがまだ存続していて、内部バッファにフレームデータが含まれている場合）、ロールバックは最後に受信した ACK フレームで停止します。その後、次のキーフレームまでロールフォワードします (フラグメント全体がすでにホストメモリに保存されているため)。 | 40 |
| connection\$1staleness | duration | SDK がバッファリング ACK を受信しない場合にストリームの古さコールバックが呼び出される秒単位の時間。これは、フレームがデバイスから送信されているが、バックエンドがフレームを承認していないことを示します。この状況は、中間ホップまたはロードバランサーで接続が切断されていることを示します。 | 30 |
| codec\$1id | string | MKV トラックのコーデック ID。 | V\$1MPEG4/ISO/AVC |
| track\$1name | string | MKV トラック名。 | kinesis\$1video |
| codecPrivateData | unsigned char\$1 | コーデックプライベートデータ (CPD) のバッファ。ストリームの開始前に CPD に関する情報がメディアパイプラインにある場合は、StreamDefinition.codecPrivateData で設定できます。ビットがコピーされ、バッファを再利用できます。または、ストリームを作成するための呼び出し後にバッファが解放されます。ただし、ストリームの作成時にデータを使用できない場合は、KinesisVideoStream.start(cpd)関数のオーバーロードのいずれかで設定できます。 | null |
| codecPrivateDataSize | uint32\$1t | コーデックプライベートデータのバッファサイズ。 | 0 |
## ClientMetrics
**ClientMetrics** オブジェクトを満たすには `getKinesisVideoMetrics` を呼び出します。
### メンバーフィールド
****
| フィールド | データ型 | 説明 |
| --- | --- | --- |
| version | UINT32 | 構造のバージョン。CLIENT\$1METRICS\$1CURRENT\$1VERSION マクロで定義します。 |
| contentStoreSize | UINT64 | コンテンツストア全体のサイズ (バイト単位)。これは、DeviceInfo.StorageInfo.storageSize での指定値です。 |
| contentStoreAvailableSize | UINT64 | 現在使用可能なストレージサイズはバイト単位です。 |
| contentStoreAllocatedSize | UINT64 | 現在割り当てられているサイズ。割り当て済みのサイズ \$1 使用可能なサイズは、内部のブックキーピングとコンテンツストアの実装のため、ストレージ全体のサイズよりわずかに小さくなります。 |
| totalContentViewsSize | UINT64 | すべてのストリームですべてのコンテンツビューに割り当てられているメモリのサイズ。これはストレージサイズにはカウントされません。このメモリは MEMALLOC マクロを使用して割り当てられます。これを上書きしてカスタムアロケータを指定できます。 |
| totalFrameRate | UINT64 | すべてのストリームで確認された合計フレームレート。 |
| totalTransferRate | UINT64 | すべてのストリームで確認された合計ストリームレート (バイト/秒)。 |
## StreamMetrics
**StreamMetrics** オブジェクトを満たすには `getKinesisVideoMetrics` を呼び出します。
### メンバーフィールド
****
| フィールド | データ型 | 説明 |
| --- | --- | --- |
| version | UINT32 | 構造のバージョン。STREAM\$1METRICS\$1CURRENT\$1VERSION マクロで定義します。 |
| currentViewDuration | UINT64 | 蓄積されたフレームの時間。高速ネットワーキングの場合、この期間は 0 またはフレーム期間 (フレームの送信中) のいずれかです。期間が でmax\$1latency指定された期間よりも長くなるとStreamDefinition、ストリームレイテンシーコールバックが指定されている場合、そのコールバックが呼び出されます。時間は 100ns 単位で指定します。これは PIC レイヤーのデフォルトの時間単位です。 |
| overallViewDuration | UINT64 | 全体の表示時間。ストリームに ACK や永続化が設定されていない場合、この値は Kinesis のビデオストリームに挿入されるフレームが増えるに従って増加し、StreamDefinition に指定された buffer\$1duration と等しくなります。ACKs が有効で、永続 ACK が受信されると、バッファは次のキーフレームにトリミングされます。これは、ACK タイムスタンプがフラグメント全体の先頭を示すためです。時間は 100 ns 単位で指定します。これは PIC レイヤーのデフォルトの時間単位です。 |
| currentViewSize | UINT64 | 現在のバッファのサイズ (バイト単位)。 |
| overallViewSize | UINT64 | 全体の表示サイズ (バイト単位)。 |
| currentFrameRate | UINT64 | 現在のストリームで確認されたフレームレート。 |
| currentTransferRate | UINT64 | すべてのストリームで確認された転送レート (バイト/秒)。 |