# Amazon IVS マルチトラックビデオ: ブロードキャストソフトウェア統合ガイド
<a name="multitrack-video-sw-integration"></a>

## 序章
<a name="multitrack-video-sw-integration-intro"></a>

サードパーティーのブロードキャスターソフトウェアツールまたはサービスが IVS マルチトラックビデオをサポートしていると主張するには、このガイドに従い、[自動ストリーム設定](#multitrack-video-sw-integration-auto-stream)と[ブロードキャストパフォーマンスメトリクス](#multitrack-video-sw-integration-broadcast-perf-metrics)の 2 つの必須機能を実装する必要があります。[推奨機能](#multitrack-video-sw-integration-recommended-features)も実装することを強くお勧めします。

次の図は、ブロードキャストソフトウェアと Amazon IVS 間の大まかなやり取りを示しています。

![\[ブロードキャストソフトウェアと Amazon IVS 間の大まかなやり取り。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/images/Workflow.png)


### 対象者
<a name="multitrack-video-sw-integration-intro-audience"></a>

このドキュメントは、マルチトラックビデオのクライアントサポートを実装するソフトウェアデベロッパーを対象としています。
+ Amazon IVS または Amazon IVS マルチトラックビデオ機能に対応したサービスにストリーミングするように設計された *クリエーター向けのブロードキャスターソフトウェア*。
+ Amazon IVS または Amazon IVS マルチトラックビデオを使用するサービスにストリーミングするユーザーに対して、サーバー側のサイマルキャストまたはトランスコードを提供する*サードパーティーのストリーミングプラットフォーム*。

### 用語
<a name="multitrack-video-sw-integration-intro-terminology"></a>

このドキュメントでは、いくつかの用語が同じ意味で使用されています。
+ **ユーザー、クリエーター、ブロードキャスター** — ブロードキャストソフトウェアを使用して元のコンテンツを作成およびストリーミングするエンドユーザー。
+ **サービス、プラットフォーム** — Amazon IVS のようなビデオプラットフォームまたはサービス。
+ **お客様** — Amazon IVS などのサービスを利用して動画サイトを運営している、または運営を検討している企業。

## 必要な機能: 自動ストリーム設定
<a name="multitrack-video-sw-integration-auto-stream"></a>

自動ストリーム設定により、ユーザーはすばやくストリームを開始でき、品質を時間とともに自動的に向上できます。ユーザーが一度設定してほとんど変更しない設定 (ビットレート、解像度、フレームレートなど) を手動で選択するのではなく、自動ストリーム設定は、ユーザーが新しいストリームを開始するたびに、現在のソフトウェア設定、ハードウェア構成、およびプラットフォームのサポートを考慮します。例えば、ユーザーがセットアップをアップグレードするとき (新しい GPU の追加など）、新しい GPU ドライバーをインストールするとき、または配信先が新しいコーデック (H.265/HEVC など) のサポートを開始すると、自動ストリーム設定が反応し、それに応じてユーザーの次のストリームの品質を向上させます。

### ライブ配信開始
<a name="multitrack-video-sw-integration-auto-stream-going-live"></a>

ユーザーがストリーミングを開始すると、ソフトウェアはユーザーのハードウェアとソフトウェアのセットアップに関する情報をクエリし、GetClientConfiguration を呼び出し、ビデオスケーラー/エンコーダーを設定し、[拡張 RTMP](https://veovera.org/docs/enhanced/enhanced-rtmp-v2) (E-RTMP) 接続を開く必要があります。これらのステップについては、以下で詳しく説明します。

### GetClientConfiguration を使用する
<a name="multitrack-video-sw-integration-auto-stream-use-getclientconfig"></a>

[GetClientConfiguration](https://docs.aws.amazon.com//ivs/latest//BroadcastSWIntegAPIReference/actions-GetClientConfiguration.html) には、ユーザーのハードウェアとソフトウェアのセットアップに関する情報が必要です。

このアルゴリズムは、次のような多くの要素を考慮して設定を決定します。
+ 最高の視聴体験を実現する – 最高解像度、最高フレームレート、最高ビットレート、最大トラック数、最新/最高コーデック、最適なビデオエンコーダー設定。
+ ストリーマーのセットアップおよびブロードキャストソフトウェア、ユーザーが設定した制限、および配信先サービスによって安全にサポートされます。

実運用環境では、制限として、古い GPU、帯域の不足のファーストマイルネットワーク、特定のユーザー設定、GPU リソースの競合、限られたプラットフォームコーデックサポートなどがあります。これらの制限が発生した場合、自動ストリーム設定は適切な方法で段階的にフォールバックする必要があります。例:
+ ストリーミングに必要な帯域幅を、10.2 Mbps (5 レンディション) から 1.5 Mbps (2 レンディション) の間で変化させる。
+ 最高品質のトラックの最大解像度を、1080p (4 つまたは 5 つのレンディション) から 480p (2 つのレンディション) の間で変化させる。
+ レンディションの数を、5 つ (1080p、720p、480p、360p、160p) から 2 つ (480p、360p) の間で変化させる。
+ サポートされる幅広い解像度 (1080p、720p、540p、480p、360p、240p、160p) において、レンディションの選択を多様化させる。
+ 個々のレンディションのビットレートを、6 Mbps (1080p60 AVC など) から 200 Kbps (160p AVC など) まで変化させる。
+ フレームレートを、高フレームレート (60、50、または 48 fps) から標準フレームレート (30、25、または 24 fps) の間で変化させる。
+ 安全/視聴者のサポートとコーデックの効率 (H.264/AVC や H.265/HEVC など) のバランスを取るため、ビデオコーデックを変化させる。
+ GPU リソースのバランスをとるため、スケーリングアルゴリズム (Lanczos、Bicubic、Bilinear など) を変更する。
+ GPU ベンダーとドライバーのバージョン (例えば、NVIDIA GeForce RTX 4080 の場合は P6、NVIDIA GeForce GTX 950 の場合は P4 など) に応じて、さまざまなビデオエンコーディング設定 (コーデックプロファイル、エンコーダプリセット、ルックアヘッドウィンドウ、心理視覚 AQ、B フレーム数など) を調整する。

#### ユーザーに設定を公開する
<a name="multitrack-video-sw-integration-auto-stream-use-getclientconfig-preferences"></a>

ユーザーが次の設定を行えるようにする必要があります。
+ 出力解像度
+ 出力フレームレート
+ 最大ビデオトラック
+ 最大ストリーミングビットレート

#### オプション: ブロードキャストソフトウェアでの制限の設定
<a name="multitrack-video-sw-integration-auto-stream-use-getclientconfig-limits-in-software"></a>

お客様のソフトウェアまたはサービスでは、デフォルト設定が用意されているか、ユーザーによる設定変更が制限されている場合があります。例えば、ソフトウェアまたはサービスで GPU リソースを保持する必要があり、マルチトラックビデオで使用されるビデオエンコーダーセッションの数を制限する場合は、ユーザーの**最大ビデオトラック数**を 3 に制限し、**自動**が「最大 3」を意味することをユーザーに明確に示すこともできます。

#### 配信先にごとに設定される制限
<a name="multitrack-video-sw-integration-auto-stream-use-getclientconfig-limits-by-destination"></a>

GetClientConfiguration リクエストのストリームキーは、サービスがチャネルを識別し、チャネルごとの制約があるかどうかを判断するために必要です。例えば、Amazon IVS は `STANDARD` チャネルに対して `multitrackInputConfiguration.maximumResolution` プロパティを提供します。これは、個々のトラックの解像度を制限するために使用できるため、お客様は特定のクリエーターに特別な品質 (720p60 または 1080p60 ストリーミングなど) を提供したり、利用料金を抑えたりできます。

#### 警告とエラーの処理
<a name="multitrack-video-sw-integration-auto-stream-use-getclientconfig-errors"></a>

GetClientConfiguration はさまざまな状況で警告とエラーを返すため、警告とエラーの両方を処理するには、ユーザー向けサポートを実装する必要があります。

*警告*は情報です。ユーザーは、ストリーミングを継続するか、キャンセルするかを選択する必要があります。警告の例を次に示します。
+ ユーザーのマシンにインストールされた NVIDIA ドライバーのバージョンは、DD/MM/YYYY にサポートが終了します。

*エラー*は致命的と見なされます。ユーザーはストリーミングを続行できません。エラーの例を次に示します。
+ チャネルは、マルチトラックビデオをサポートするように設定されていません。
+ 古い/サポートされていない GPU ドライバーのバージョン。
+ GPU はサポートされていません。
+ 指定されたストリームキーが無効です。
+ フレームレート 59.94 は Amazon IVS マルチトラックビデオではサポートされていません。[設定] > [動画]で、サポートされている値として 24、25、30、48、50、60 のいずれかを選択します。
+ 設定リクエストに必要なデータ (GPU ドライバーのバージョン、GPU モデルなど) がありません。

### ビデオスケーリングとエンコーディングを設定する
<a name="multitrack-video-sw-integration-auto-stream-configure-video"></a>

[GetClientConfiguration](https://docs.aws.amazon.com//ivs/latest//BroadcastSWIntegAPIReference/actions-GetClientConfiguration.html) は、アプリケーション (ゲーム/ブロードキャストソフトウェアなど) のパフォーマンスに影響を与えたり、ユーザーの設定を考慮することなく、ビューワーエクスペリエンスを最大限に最適化するスケーリング設定とエンコーディング設定を返します。GetClientConfiguration から返される正確なスケーリングとエンコーディングの設定を使用します。GetClientConfiguration は、時間の経過とともに変わるさまざまなベンダーや GPU アーキテクチャの特定のニーズを考慮します。

スケーリングとエンコーディングの設定 (プリセットなど) に加えて、以下を行う必要があります。
+ *すべてのエンコーダーを調整し、すべてのレンディションの IDR の PTS が一致するようにします。*これは、セグメント化された HLS を使用してビデオを配信して視聴するときに、複数のレンディションを合わせるためにサーバーサイドでのトランスコーディングを避けるために必要です。IDR がビデオトラック間で揃っていない場合、視聴者は ABR 再生でのレンディションの切り替え中に時間シフトとスタッタリングが発生します。(視覚化については、[ブロードキャストパフォーマンスメトリクス](#multitrack-video-sw-integration-broadcast-perf-metrics)の図を参照してください)。
+ *すべてのビデオトラックで SEI/OBU データ (キャプションなど) のクローンを作成します。*これは、ビデオプレーヤーが視聴中の画質に関係なく SEI/OBU データにアクセスできるようにするために必要です。

### 拡張 RTMP を使用して接続する
<a name="multitrack-video-sw-integration-auto-stream-enhanced-rtmp"></a>

拡張 RTMP によるマルチトラックストリーミングのドキュメントについては、「[Enhanced RTMP v2 の仕様](https://veovera.org/docs/enhanced/enhanced-rtmp-v2)」を参照してください。

拡張 RTMP で接続する場合、Amazon IVS マルチトラックビデオにはいくつかの要件があります。
+ プライマリの最高品質ビデオトラックは、拡張 RTMP 形式のシングルトラックビデオパケットとしてパッケージ化して送信する必要があります。例えば、`videoPacketType` として `CodedFrames`、`CodedFramesX`、`SequenceStart`、`SequenceEnd` などが考えられます。
+ 追加のビデオトラックはすべて、拡張 RTMP 形式のマルチトラックビデオパケットとしてパッケージ化して送信する必要があります (例: `videoPacketType` は `Multitrack`)。マルチトラックパケットタイプは 1 つのトラックに設定されています (例: `videoMultitrackType` は `OneTrack`)。
+ [GetClientConfiguration](https://docs.aws.amazon.com//ivs/latest//BroadcastSWIntegAPIReference/actions-GetClientConfiguration.html) から返される `authentication` フィールドのストリームキーを使用して RTMP サーバーに接続する必要があります。
+ [GetClientConfiguration](https://docs.aws.amazon.com//ivs/latest//BroadcastSWIntegAPIReference/actions-GetClientConfiguration.html) から返される `config_id` 値は、キー `clientConfigId` を持つ RTMP 接続文字列にクエリ引数として追加する必要があります。

以下はストリーム構成の例です。


|  videoPacketType  |  videoMultitrackType  |  trackId  |  解決方法  | 
| --- | --- | --- | --- | 
|  CodedFrames CodedFramesX SequenceStart SequenceEnd  |  NA – videoMultitrackType はシングルトラック拡張 RTMP では送信されません。  |  NA – trackId はシングルトラック拡張 RTMP では送信されません。  |  1920x1080  | 
|  マルチトラック  |  シングルトラック  |  1  |  1280x720  | 
|  マルチトラック  |  シングルトラック  |  2  |  852x480  | 
|  マルチトラック  |  シングルトラック  |  3  |  640x360  | 

ブロードキャストソフトウェアは、`ingest_endpoints` の [GetClientConfiguration](https://docs.aws.amazon.com//ivs/latest//BroadcastSWIntegAPIReference/actions-GetClientConfiguration.html) から返されたデータと、ユーザーが選択したプロトコル (RTMP または RTMPS) を使用して、接続先のエンドポイントを識別する必要があります。`url_template` および `authentication` で返されたストリームキーを使用して URL を作成し、`clientConfigId` クエリ引数として `config_id` を含めます。ユーザーに RTMP クエリ引数 (`?bandwidthtest=1` など) の指定を許可する場合は、`clientConfigId` の指定に加えてそれらを追加する必要があります。GetClientConfiguration からのレスポンスの例を次に示します。

```
{
   "ingest_endpoints": [
      {
         "protocol": "RTMP",
         "url_template": "rtmp://iad05.contribute.live-video.net/app/{stream_key}",
         "authentication": "v1_5f2e593731dad88b6bdb03a3517d306ef88a73e29619ee4b49012d557e881484_65c5dc81_7b2276223a302c2262223a393939392c2274223a5b7b2277223a3634302c2268223a3336302c2262223a3530302c226330223a312c226331223a302c226332223a307d2c7b2277223a313238302c2268223a3732302c2262223a313730302c226330223a312c226331223a302c226332223a307d2c7b2277223a313932302c2268223a313038302c2262223a363030302c226330223a312c226331223a302c226332223a307d5d7d_live_495665160_FC45sNuCYUwLnCVtCnXSjEWkusXzJI"
      },
      {
         "protocol": "RTMPS",
         "url_template": "rtmps://iad05.contribute.live-video.net/app/{stream_key}",
         "authentication": "v1_5f2e593731dad88b6bdb03a3517d306ef88a73e29619ee4b49012d557e881484_65c5dc81_7b2276223a302c2262223a393939392c2274223a5b7b2277223a3634302c2268223a3336302c2262223a3530302c226330223a312c226331223a302c226332223a307d2c7b2277223a313238302c2268223a3732302c2262223a313730302c226330223a312c226331223a302c226332223a307d2c7b2277223a313932302c2268223a313038302c2262223a363030302c226330223a312c226331223a302c226332223a307d5d7d_live_495665160_FC45sNuCYUwLnCVtCnXSjEWkusXzJI"
      }
   ],
   "meta": {
      "config_id": "d34c2f7e-ce3a-4be4-a6a0-f51960abbc4f",
      …
   }
   …
}
```

次に、ユーザーが RTMP を選択した場合は、以下の接続を開きます。

```
rtmp://iad05.contribute.live-video.net/app/v1_5f2e593731dad88b6bdb03a3517d306ef88a73e29619ee4b49012d557e881484_65c5dc81_7b2276223a302c2262223a393939392c2274223a5b7b2277223a3634302c2268223a3336302c2262223a3530302c226330223a312c226331223a302c226332223a307d2c7b2277223a313238302c2268223a3732302c2262223a313730302c226330223a312c226331223a302c226332223a307d2c7b2277223a313932302c2268223a313038302c2262223a363030302c226330223a312c226331223a302c226332223a307d5d7d_live_495665160_FC45sNuCYUwLnCVtCnXSjEWkusXzJI?clientConfigId=d34c2f7e-ce3a-4be4-a6a0-f51960abbc4f
```

#### ビデオ切断の処理
<a name="multitrack-video-sw-integration-auto-stream-enhanced-rtmp-disconnects"></a>

マルチトラックビデオシステムでは、いくつかの制限が適用されます。これらの制限は、主に以下の 3 つの理由によります。

1. システムの安全性 — IVS はスケーラビリティのために入力を制限する必要があります。例としては、入力処理に影響するチャネルごとのストリーミング帯域幅制限、出力容量/コストに影響するトラックまたは解像度ベースのビットレートエンタイトルメント、CDN レプリケーション/配信容量に影響するトラック数エンタイトルメントなどがあります。

1. システム機能 — サービスでは、機能の互換性のために入力を制限する必要があります (個々のコーデックのプラットフォーム サポート、高度なコーデックの配信コンテナ サポートなど）。

1. 視聴者エクスペリエンス — サービスでは、視聴者エクスペリエンスとブランド評判を維持するために、入力を制限する必要があります。例えば、このサービスでは、すべてのターゲットユーザーデバイス (デスクトップ、モバイル、テレビ/OTT など) とアプリ (ブラウザ、ネイティブなど) で QoE を駆動するプレイヤー ABR アルゴリズムを制御します。

ビデオシステムは、いくつかのシナリオでクライアントを切断します。
+ クライアントはマルチトラックビデオで RTMP サーバーに接続しようとしますが、[GetClientConfiguration](https://docs.aws.amazon.com//ivs/latest//BroadcastSWIntegAPIReference/actions-GetClientConfiguration.html) から返されるストリームキーを使用しません。
+ クライアントは、GetClientConfiguration から返された仕様と一致しないマルチトラックビデオを提供します。例：
  + トラック数が一致していません。
  + 個々のトラックのコーデックが一致しません。
  + 個々のトラックの解像度が一致しません。
  + 個々のトラックのフレームレートが一致しません。
  + 個々のトラックのビットレートが一致しません。
+ クライアントが提供するビデオの IDR が揃っていません。
+ ブロードキャストパフォーマンスメトリクスは、各トラックのすべての IDR の前に存在しているわけではありません。

接続が切れるのは、ストリームの開始時 (チャネルがライブ配信を開始しない) またはストリームの途中 (チャネルがライブ配信中にミスマッチが検出され、クライアントが切断される) のどちらかです。

#### 自動再接続
<a name="multitrack-video-sw-integration-auto-stream-enhanced-rtmp-auto-reconnecting"></a>

GetClientConfiguration から返されるストリームキーの有効性は 48 時間、または DeleteStreamKey を呼び出してストリームキーが無効になるまでです。IVS ストリームの最大期間は 48 時間です。その後、ストリームは終了し、ストリーミングセッションは切断されます。(自動または手動で) 正常に再接続すると、新しいストリームが開始されます。

ブロードキャストソフトウェアは自動再接続を実装する場合があります。自動再接続をサポートしている場合は、ユーザーに自動再接続の有効化/無効化を許可し、次のガイドラインに従う必要があります。
+ 接続の再試行にエクスポネンシャルバックオフ再試行遅延 (わずかなランダムなずれを含む) を実装します。
+ 最大 25 回の接続試行を実行します。例えば、OBS Studio は 25 回再試行し、試行間の待ち時間は最長 15 分まで指数関数的に増加します。実際には、最後の再試行は接続が切れてから約 3 時間後に実行されます。
+ 接続時に `publish` を送信した直後に切断される場合は、GetClientConfiguration を呼び出し、エンコーダの設定を再設定してから、再度接続してください。

#### ストリームの停止と切断
<a name="multitrack-video-sw-integration-auto-stream-enhanced-rtmp-stopping-and-reconnecting"></a>

ユーザーがストリーミングを停止し、TCP 接続がまだ開いている場合 (低レベル接続がリセットされなかった場合など) 、RTMP 接続を閉じる前に FCUnpublish ([OBS Studio での実装例](https://github.com/obsproject/obs-studio/blob/master/plugins/obs-outputs/librtmp/rtmp.c#L1973-L1999)) を送信する必要があります。これは、ユーザーのストリーム終了の意図を示す重要なシグナルで、後続の機能が適切に動作するために不可欠です。

## 必要な機能: Broadcast Performance Metrics (BPM)
<a name="multitrack-video-sw-integration-broadcast-perf-metrics"></a>

自動ストリーム構成の継続的な改善を可能にするには、ブロードキャストパフォーマンスメトリクス (BPM) を測定して送信し、可能な限り最高のストリーム設定を提供する必要があります。

メトリクスが収集され、SEI (AVC/HEVC の場合) メッセージを介して帯域内に送信されます。次の 2 つのクラスのデータが収集されます。
+ *タイムスタンプ*は、ブロードキャスターとビューワー間のエンドツーエンドのレイテンシーを測定するために収集されます。これらは、次の場合に便利です。
  + エンドツーエンドのレイテンシーの見積もりをブロードキャスターまたは視聴者に提供する。
  + システムのストレスや 1 マイルのネットワーク接続の低下を示す可能性のあるタイムスタンプのジッターを分析する。
  + 時系列カウンターデータを調整および集計するための実際のイベント時間を参照する。

  ブロードキャスターから送信されるタイムスタンプは、グローバル共通の基準クロック、通常は UTC\$10 タイムゾーンを使用する NTP 同期クロックに基づいています。RFC3339 は、「インターネット時間」のシナリオで広く利用されています。これは絶対的な基準を提供し、時間的な差分の計算を簡単に行えるようにします。
+ *フレームカウンター*は、ブロードキャストソフトウェアとビデオエンコーダーのパフォーマンスをフレームレベルで測定するために収集されます。これらは、次の場合に便利です。
  + ストリーミング設定の改善を支援するために、追加シグナルを含むパフォーマンスダッシュボードをブロードキャスターに提供する。
  + 新しくリリースされた GPU ドライバーや OS バージョン/パッチなどの環境の変化と相関する可能性のあるプロアクティブシグナルを提供する。
  + ビデオサービスが GetClientConfiguration の改善を安全に繰り返しリリースし、新しいハードウェアベンダー、新しい GPU モデル、新しいコーデック、新しいドライバー機能、さらなるビデオエンコーダー設定の調整、そして新しいユーザー制御プリセット (例：デュアル PC セットアップ、ゲーミング\$1ストリーミングセットアップ) に対応できるように、フィードバックを提供する。

### SEI/OBU メッセージを挿入する
<a name="multitrack-video-sw-integration-auto-stream-broadcast-perf-metrics-seiobu-messages"></a>

特定のメッセージのバイトストリーム定義については、「[BPM メッセージ定義](#multitrack-video-sw-integration-performance-metrics-definitions)」を参照してください。

すべてのビデオトラックにおいて、IDR の直前に BPM メトリクスを挿入する必要があります。3 つのメッセージ (BPM TS、BPM SM、および BPM ERM) は一緒に送信する必要がありますが、それぞれを個別の NUT (AVC/HEVC) として送信する必要があります。

最初のセグメントで送信する BPM SM と BPM ERM では、フレームカウンターを 0 に設定する必要があります。これは最初は直感的ではないように思えるかもしれませんが、レンディションごとにエンコードされたフレーム数などのカウンターには、エンコードが完了するまで意味のあるデータは含まれません。その結果、セグメント N のフレームカウンターはセグメント N-1 と一致します。BPM メトリクスは、ビデオビットストリーム内で IDR 間隔で配信される時間軸データと捉えることができます。必要に応じて、提供されたタイムスタンプを使用して、受信側でデータ系列を正確に再配置する必要があります。

以下の図は、3 つのレンディションによるマルチトラックストリームの一般的なシナリオを示しています。一般的なセグメントサイズは 2 秒であるため、各レンディションごとに 2 秒間隔でメトリクスが送信されます。

![\[3 つのレンディションによるマルチトラックストリームの一般的なシナリオ。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/images/BPM_-_Insert_SEI_OBU_Messages.png)


## 推奨機能
<a name="multitrack-video-sw-integration-recommended-features"></a>

### 自動サーバー選択を許可する
<a name="multitrack-video-sw-integration-recommended-features-auto-server-selection"></a>

サーバーの自動選択は、グローバルネットワークの状態の変化や PoP (Point of Presence) の可用性の変化に応じて、ユーザーがライブストリームの接続に最適な取り込みサーバーを選択するのに役立ちます。

ブロードキャストソフトウェアがサーバーの自動選択をサポートしている場合、ソフトウェアが GetClientConfiguration や FindIngest を実装しているかどうかに応じて、動作が異なることが予想されます。各シナリオを以下に示します。

ブロードキャストソフトウェアが GetClientConfiguration と FindIngest の両方を実装している場合：


|  ユーザー UI 選択  |  ... で指定された取り込みエンドポイントに接続します。 | 
| --- | --- | 
|  Auto  |  GetClientConfiguration  | 
|  FindIngest からの特定の取り込みエンドポイント  |  ユーザーの選択  | 
|  カスタムサーバーの指定  |  ユーザーの選択  | 

ブロードキャストソフトウェアが GetClientConfiguration を実装しているが、FindIngest を実装していない場合：


|  ユーザー UI 選択  |  ... で指定された取り込みエンドポイントに接続します。 | 
| --- | --- | 
|  Auto  |  GetClientConfiguration   | 
|  カスタムサーバーの指定  |  ユーザーの選択  | 

ブロードキャストソフトウェアが GetClientConfiguration を実装していないが FindIngest を実装している場合:


|  ユーザー UI 選択  |  ... で指定された取り込みエンドポイントに接続します。 | 
| --- | --- | 
|  Auto  |  FindIngest   | 
|  FindIngest からの特定の取り込みエンドポイント  |  ユーザーの選択  | 
|  カスタムサーバーの指定  |  ユーザーの選択  | 

ブロードキャストソフトウェアが GetClientConfiguration または FindIngest を実装していない場合:


|  ユーザー UI 選択  |  ... で指定された取り込みエンドポイントに接続します。 | 
| --- | --- | 
|  Auto  |  グローバル配信先の URL:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  | 
|  カスタムサーバーの指定  |  ユーザーの選択  | 

FindIngest で指定された取り込みエンドポイントの使用の詳細については、「[自動ストリーミングの配信先に FindIngest サーバーを使用する](#multitrack-video-sw-integration-recommended-features-using-findingest)」を参照してください。

### ストリーミング配信先の設定をユーザーに許可する
<a name="multitrack-video-sw-integration-recommended-features-streaming-destination"></a>

ユーザーがストリーミング配信先を設定するときは、[FindIngest](https://docs.aws.amazon.com//ivs/latest//BroadcastSWIntegAPIReference/actions-FindIngest.html) をクエリし、ユーザーに次の機能を提供する必要があります。
+ RTMP または RTMPS (Amazon IVS のデフォルト) を選択します。
+ サーバーの **[自動]** を選択します。
+ [FindIngest](https://docs.aws.amazon.com//ivs/latest//BroadcastSWIntegAPIReference/actions-FindIngest.html) から返されたリストから特定のサーバーを選択します。
+ カスタムサーバーを入力します。例えば、**[カスタムサーバーの指定]** を使用します。

ユーザーによって選択されたプロトコル (RTMP または RTMPS) やその他の考慮事項に基づいて、FindIngest から返されるリストをフィルタリングできます。

例として、OBS Studioに おける Amazon IVS の実装では、次のオプションが用意されたシンプルな **[サーバー]** ドロップダウンメニューによって、この機能が実現されています。
+ 自動 (RTMPS、推奨）
+ 自動 (RTMP)
+ 米国東部: アシュバーン、VA (5) (RTMPS)
+ 米国東部: ニューヨーク、NY (50) (RTMPS)
+ 米国東部: ニューヨーク、NY (RTMPS)
+ 米国東部: アシュバーン、VA (5) (RTMP)
+ 米国東部: ニューヨーク、NY (50) (RTMP)
+ 米国東部: ニューヨーク、NY (RTMP)
+ カスタムサーバーの指定

**[カスタムサーバーの指定]** を選択すると、ユーザーが RTMP URL を入力するためのテキストボックスが表示されます。

### 自動ストリーミングの配信先に FindIngest サーバーを使用する
<a name="multitrack-video-sw-integration-recommended-features-using-findingest"></a>

ストリーミング配信先に [自動] が指定されたときに FindIngest で指定された取り込みエンドポイントを使用する場合は、[FindIngest](https://docs.aws.amazon.com//ivs/latest//BroadcastSWIntegAPIReference/actions-FindIngest.html) から返される最小の `priority` 値のエントリを使用します。ストリームの本番稼働にかかる時間を短縮するために、FindIngest のレスポンスをキャッシュできます。レスポンスをキャッシュする場合は、キャッシュされた値を定期的に更新します。

ユーザーが RTMP を選択した場合は、`url_template` 文字列を RTMP ブロードキャストの配信先として使用します。ユーザーが RTMPS を選択した場合は、`url_template_secure` 文字列を RTMPS ブロードキャストの配信先として使用します。いずれの場合も、`{stream_key}` をユーザーのストリームキーに置き換えます。

## Broadcast Performance Metrics (BPM) メッセージ定義
<a name="multitrack-video-sw-integration-performance-metrics-definitions"></a>

BPM メッセージは [H.264 標準](https://www.itu.int/rec/T-REC-H.264) SEI 構文に基づいています。参考までに、H.264 仕様のユーザーデータ未登録 SEI 構文は次のとおりです。

![\[ユーザーデータの未登録 SEI メッセージ構文。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/images/BPM_Definitions.png)


BPM メッセージの場合、H.264 規格のすべての解析および表記ルールが適用されます。例えば、「u(128)」は符号なし 128 ビットの整数で、最上位ビットが先頭を表します。

BPM には 3 つの SEI メッセージが定義されています。
+ BPM TS SEI: [タイムスタンプメッセージ](#multitrack-video-sw-integration-performance-metrics-definitions-bpm-ts)
+ BPM SM SEI: [セッションメトリクスメッセージ](#multitrack-video-sw-integration-performance-metrics-definitions-bpm-sm)
+ BPM ERM SEI: [エンコードされたレンディションメトリクスメッセージ](#multitrack-video-sw-integration-performance-metrics-definitions-bpm-erm)

すべての BPM SEI メッセージは、`user_data_unregistered()` 構文に必要な 128 ビット UUID を送信し、その後にペイロードバイトのループを送信します。結果として得られるメッセージは、上位レベルのセマンティクス (NALU、RBSP、開始コード エミュレーション防止など) でカプセル化されます。

### BPM TS (タイムスタンプ) SEI
<a name="multitrack-video-sw-integration-performance-metrics-definitions-bpm-ts"></a>

BPM TS SEI メッセージは、1 つ以上の関連するタイムスタンプを伝達します。例えば、クライアントは、フレームコンポジション、エンコードの要求と完了、パケットのインターリーブといったイベントのタイムスタンプを 1 つの SEI メッセージにまとめて送信できます。さらに、これらのタイムスタンプを絶対時間 (RFC3339/ISO8601 形式) か相対時間 (差分やエポックからの経過時間) のどちらで送信するかは、クライアントによって決定されます。delta 型のタイムスタンプの基準となるタイムスタンプが 1 つ存在するべきです。これは構文上の制約ではなく、デプロイの仕様によって決まるべきです。


|  |  |  | 
| --- |--- |--- |
|  `user_data_unregistered_bpm_ts( payloadSize ) {`  |  **C**  |  **Descriptor**  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(128)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  b(4)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(4)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(8)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(8)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  st(v)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(64)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  i(64)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  `}`  |   |   | 

#### BPM TS SEI フィールドの説明テーブル
<a name="multitrack-video-sw-integration-performance-metrics-definitions-bpm-ts-fields"></a>


|  フィールド  |  説明  | 
| --- | --- | 
|  `uuid_iso_iec_11578`  |  `0aecffe752724e2fa62fd19cd61a93b5` を 16 進数に設定します。 未登録の SEI メッセージを使用する場合、このメッセージを他の未登録のメッセージと区別するには、UUID が必要になります。  | 
|  `ts_reserved_zero_4bits`  |  将来の利用のために予約されています。 を に設定します`b('0000')` 受信側はこれらのビットを無視します。  | 
|  `num_timestamps_minus1`  |  `num_timestamps=num_timestamps_minus1+1` `num_timestamps_minus1` は 0～15 の範囲で指定します。つまり、1～16 個までのタイムスタンプをシグナルできます。  | 
|  `timestamp_type`  |  「[timestamp\$1type テーブル](#multitrack-video-sw-integration-performance-metrics-definitions-bpm-ts-types)」を参照してください。  | 
|  `timestamp_event`  |  次のいずれかです: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html) `num_timestamps_minus1` が 0 より大きい場合 (つまり、複数のタイムスタンプがシグナルされる場合) に一意性を識別する構文上の識別子がないため、`timestamp_event` は SEI ループ内で一意である必要があります。同じ `timestamp_event` で複数のタイムスタンプを割り当てることは可能です。ただし、これらのタイムスタンプが何を意味するのかについては、このメッセージでは定義されていません。  | 

#### timestamp\$1type テーブル
<a name="multitrack-video-sw-integration-performance-metrics-definitions-bpm-ts-types"></a>

`timestamp_type` は、次のようなタイプを指定します。
+ カレンダーベースの日時がシグナルされる「ウォールクロック」形式。
+ エポックからの経過時間。
+ 2 つのイベントの時間差がシグナルされるデルタタイムスタンプ。
+ 今後必要になる可能性のある追加のタイムスタンプ形式。


|  timestamp\$1type  |  名前  |  説明  | 
| --- | --- | --- | 
|  0  |  未定義  |  未定義 – 使用しません。  | 
|  1  |  `rfc3339_ts`  |  [RFC3339](https://www.rfc-editor.org/rfc/rfc3339) は、インターネット使用のための [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) のプロファイルであり、ISO8601 のオプションの一部を制限します。 `timestamp_type==1` は RFC3339 ベースの時間表記を使用するものとします。RFC3339 はタイムゾーンをサポートしていないことに注意してください。すべてのタイムスタンプは UTC (別名「ズールー」タイム) を基準にしています。UTC のオフセットは 00:00 です。 r`fc3339_ts` は文字列です。 `st(v)` は [H.264 標準のセクション 7.2](https://www.itu.int/rec/T-REC-H.264) で定義されています。 うるう秒についての詳細は、この表の下の注釈をご覧ください。 例: `2024-03-25T15:10:34.489Z` (489はミリ秒を表します）  | 
|  2  |  `duration_since_epoch_ts`  |  1970-01-01T00:00:00Z000 をエポックとした場合の経過時間 (ミリ秒) うるう秒についての詳細は、この表の下の注釈をご覧ください。  | 
|  3  |  `delta_ts`  |  2 つのイベント間のナノ秒単位の時間差を表すデルタタイムスタンプ。符号付き整数を使用すると、正と負のデルタをシグナルできます。  | 
|  4-255  |  リザーブド  |  リザーブド。  | 

**うるう秒に関する注意点: ** うるう秒の使用は、2035 年までに段階的に廃止されることになりました。詳細については、[ウィキペディアのうるう秒の記事](https://en.wikipedia.org/wiki/Leap_second)を参照してください。うるう秒を含まないタイムスタンプを使用することを推奨します。これは、2035 年までに標準化される見込みで、時刻計算の誤りを防ぎます。

### BPM SM (セッションメトリクス) SEI
<a name="multitrack-video-sw-integration-performance-metrics-definitions-bpm-sm"></a>

BPM SM SEI メッセージは、送信セッション全体に関連する一連のメトリクスを伝達します。OBS Studio では、これは次のフレームカウンターを送信することを意味します。
+ レンダリングされたセッションフレーム
+ ドロップしたセッションフレーム
+ 遅延したセッションフレーム
+ 出力されたセッションフレーム

この SEI メッセージにはタイムスタンプも含まれます。これは BPM TS SEI と重複していますが、各 SEI メッセージに明示的なタイムスタンプを含めることで、データの最小単位として扱いやすくし、受信側の処理負荷を軽減します。また、BPM TS SEI をドロップまたは送信しない場合でも、使用する BPM SM SEI メッセージには明示的なタイムスタンプが残ります。


|  |  |  | 
| --- |--- |--- |
|  `user_data_unregistered_bpm_sm( payloadSize ) {`  |  **C**  |  **Descriptor**  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(128)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  b(4)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(4)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(8)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(8)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  st(v)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(64)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  i(64)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  b(4)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(4)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  b(8)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  b(32)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  `}`  |   |   | 

#### BPM SM SEI フィールドの説明テーブル
<a name="multitrack-video-sw-integration-performance-metrics-definitions-bpm-sm-fields"></a>

この SEI メッセージの多くのフィールドは、BPM TS SEI フィールドに似ています。主な違いは、UUID 値、期待されるタイムスタンプの数、および送信されるカウンターの数です。


|  フィールド  |  説明  | 
| --- | --- | 
|  `uuid_iso_iec_11578`  |  `ca60e71c-6a8b-4388-a377-151df7bf8ac2` を 16 進数に設定します。 未登録の SEI メッセージを使用する場合、このメッセージを他の未登録のメッセージと区別するには、UUID が必要になります。  | 
|  `ts_reserved_zero_4bits`  |  将来の利用のために予約されています。 を に設定します`b('0000')` 受信側はこれらのビットを無視します。  | 
|  `num_timestamps_minus1`  |  `num_timestamps=num_timestamps_minus1+1` `num_timestamps_minus1` は 0～15 の範囲で指定します。つまり、1～16 個までのタイムスタンプをシグナルできます。 現在、この値は 0 (単一のタイムスタンプを示す) である必要があります。  | 
|  `timestamp_type`  |  「[timestamp\$1type テーブル](#multitrack-video-sw-integration-performance-metrics-definitions-bpm-ts-types)」を参照してください。BPM SM SEI のタイムスタンプは、RFC3339 形式の文字列 (タイプ1) で表現されます。  | 
|  `timestamp_event`  |  次のいずれかです: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html) `num_timestamps_minus1` が 0 より大きい場合 (つまり、複数のタイムスタンプがシグナルされる場合) に一意性を識別する構文上の識別子がないため、`timestamp_event` は SEI ループ内で一意である必要があります。同じ `timestamp_event` で複数のタイムスタンプを割り当てることは可能です。ただし、これらのタイムスタンプが何を意味するのかについては、このメッセージでは定義されていません。 **注:** Amazon IVS では、BPM SM SEI の `timestamp_event` の値は 4 (`BPM_TS_EVENT_PIR`) に固定する必要があります。今後、他のタイムスタンプイベントにも対応する予定です。  | 
|  `num_counters_minus1`  |  `num_counters=num_counters_minus1+1` `num_counters_minus1` は 0～15 までの範囲で指定します。つまり、これは、1～16 個までのカウンターをシグナルできます。 BPM SM SEI では、これは 3 (つまり 4 カウンター) である必要があります。  | 
|  `counter_tag`  |  次のいずれかです: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  | 
|  `counter_value`  |  指定した `counter_tag` が、前回送信されたときからどれだけ変化したかを表す 32 ビットの差分値。例えば、60 fps のレンダリングでは、2秒ごとの `counter_value` は120 になります。  | 

#### BPM SM の例
<a name="multitrack-video-sw-integration-performance-metrics-definitions-bpm-sm-example"></a>

Amazon IVS に送信される BPM SM SEI の例を次に示します。
+ `uuid_iso_iec_11578` (16 バイト): ca60e71c-6a8b-4388-a377-151df7bf8ac2
+ `ts_reserved_zero_4bits` (4 ビット): 0x0
+ `num_timestamps_minus1` (4 ビット): 0x0 (1 つのタイムスタンプが送信されることを意味する）
+ `timestamp_type` (1 バイト): 0x01 (RFC3339 タイムスタンプ - 文字列形式）
+ `timestamp_event` (1 バイト): 0x04 (BPM\$1TS\$1EVENT\$1PIR)
+ `rfc3339_ts`：「2024-03-25T15:10:34.489Z」
+ `ts_reserved_zero_4bits` (4 ビット): 0x0
+ `num_counters_minus1` (4 ビット): 0x3 (4 つのカウンターが送信されていることを意味する）
+ `counter_tag` (1 バイト): 0x01 (前回のメッセージ以降にコンポジターによってレンダリングされたフレーム）
+ `counter_value` (4 バイト)
+ `counter_tag` (1 バイト): 0x02 (前回のメッセージ以降にコンポジターによって遅延したフレーム）
+ `counter_value` (4 バイト)
+ `counter_tag` (1 バイト): 0x03 (前回のメッセージ以降のネットワークの輻輳によりドロップしたフレーム）
+ `counter_value` (4 バイト)
+ `counter_tag` (1 バイト): 0x04 (合計フレーム出力 (前回のメッセージ送信以降、全てのビデオエンコーダレンディションシンクの総計))
+ `counter_value` (4 バイト)

### BPM ERM (エンコードされたレンディションメトリクス) SEI
<a name="multitrack-video-sw-integration-performance-metrics-definitions-bpm-erm"></a>

BPM ERM SEI メッセージは、エンコードされた各レンディションに関連する一連のメトリクスを伝えます。OBS Studio では、これは次のフレームカウンターを送信することを意味します。
+ レンディションフレーム入力
+ スキップされたレンディションフレーム
+ 出力されたレンディションフレーム

この SEI メッセージにはタイムスタンプも含まれます。これは BPM TS SEI と重複していますが、各 SEI メッセージに明示的なタイムスタンプを含めることで、データの最小単位として扱いやすくし、受信側の処理負荷を軽減します。また、BPM ERM SEI をドロップまたは送信しない場合でも、使用する BPM SM SEI メッセージには明示的なタイムスタンプが残ります。


|  |  |  | 
| --- |--- |--- |
|  `user_data_unregistered_bpm_erm( payloadSize ) {`  |  **C**  |  **Descriptor**  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(128)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  b(4)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(4)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(8)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(8)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  st(v)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(64)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  i(64)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  b(4)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  u(4)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  b(8)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |  5  |  b(32)  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  |   |   | 
|  `}`  |   |   | 

#### BPM ERM SEI フィールドの説明テーブル
<a name="multitrack-video-sw-integration-performance-metrics-definitions-bpm-erm-fields"></a>

この SEI メッセージの多くのフィールドは、BPM TS SEI フィールドと BPM SM SEI フィールドに似ています。主な違いは、UUID 値、期待されるタイムスタンプの数、および送信されるカウンターの数です。


|  フィールド  |  説明  | 
| --- | --- | 
|  `uuid_iso_iec_11578`  |  `f1fbc1d5-101e-4fb5-a61e-b8ce3c07b8c0` を 16 進数に設定します。 未登録の SEI メッセージを使用する場合、このメッセージを他の未登録のメッセージと区別するには、UUID が必要になります。  | 
|  `ts_reserved_zero_4bits`  |  将来の利用のために予約されています。 を に設定します`b('0000')` 受信側はこれらのビットを無視します。  | 
|  `num_timestamps_minus1`  |  `num_timestamps=num_timestamps_minus1+1` `num_timestamps_minus1` は 0～15 の範囲で指定します。つまり、1～16 個までのタイムスタンプをシグナルできます。 現在、この値は 0 (単一のタイムスタンプを示す) である必要があります。  | 
|  `timestamp_type`  |  「[timestamp\$1type テーブル](#multitrack-video-sw-integration-performance-metrics-definitions-bpm-ts-types)」を参照してください。 これは、RFC3339 形式の文字列 (タイプ1) である必要があります。  | 
|  `timestamp_event`  |  次のいずれかです: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html) `num_timestamps_minus1` が 0 より大きい場合 (つまり、複数のタイムスタンプがシグナルされる場合) に一意性を識別する構文上の識別子がないため、`timestamp_event` は SEI ループ内で一意である必要があります。同じ `timestamp_event` で複数のタイムスタンプを割り当てることは可能です。ただし、これらのタイムスタンプが何を意味するのかについては、このメッセージでは定義されていません。 **注:** Amazon IVS では、BPM ERM SEI の `timestamp_event` の値は 4 (`BPM_TS_EVENT_PIR`) に固定する必要があります。今後、他のタイムスタンプイベントにも対応する予定です。  | 
|  `num_counters_minus1`  |  `num_counters=num_counters_minus1+1` `num_counters_minus1` は 0～15 までの範囲で指定します。つまり、これは、1～16 個までのカウンターをシグナルできます。 BPM ERM SEI の場合、これは 2 (つまり 3 カウンター) である必要があります。  | 
|  `counter_tag`  |  次のいずれかです: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/LowLatencyUserGuide/multitrack-video-sw-integration.html)  | 
|  `counter_value`  |  指定した `counter_tag` が、前回送信されたときからどれだけ変化したかを表す 32 ビットの差分値。例えば、60 fps のレンダリングでは、2秒ごとの `counter_value` は120 になります。  | 

#### BPM ERM の例
<a name="multitrack-video-sw-integration-performance-metrics-definitions-bpm-erm-example"></a>

Amazon IVS に送信される BPM ERM SEI の例を次に示します。
+ `uuid_iso_iec_11578` (16 バイト): f1fbc1d5-101e-4fb5-a61e-b8ce3c07b8c0
+ `ts_reserved_zero_4bits` (4 ビット): 0x0
+ `num_timestamps_minus1` (4 ビット): 0x0 (1 つのタイムスタンプが送信されることを意味する）
+ `timestamp_type` (1 バイト): 0x01 (RFC3339 タイムスタンプ - 文字列形式）
+ `timestamp_event` (1 バイト): 0x04 (BPM\$1TS\$1EVENT\$1PIR)
+ `rfc3339_ts`：「2024-03-25T15:10:34.489Z」
+ `ts_reserved_zero_4bits` (4 ビット): 0x0
+ `num_counters_minus1` (4 ビット): 0x2 (3 つのカウンタが送信されることを意味する)
+ `counter_tag` (1 バイト): 0x01 (最後のメッセージ以降に入力されたエンコードされたレンディションフレーム）
+ `counter_value` (4 バイト)
+ `counter_tag` (1 バイト): 0x02 (最後のメッセージ以降にスキップされたエンコードされたレンディションフレーム）
+ `counter_value` (4 バイト)
+ `counter_tag` (1 バイト): 0x03 (最後のメッセージ以降に出力されたエンコードされたレンディションフレーム）
+ `counter_value` (4 バイト)