

# Amazon IVS のマルチトラックビデオ: セットアップガイド
<a name="multitrack-video-setup"></a>

このドキュメントは、Amazon IVS API および SDK をアプリケーションに統合するお客様を対象としています。

## マルチトラックビデオストリーミングの採用
<a name="multitrack-video-setup-adopting"></a>

マルチトラックビデオを採用するには、2 つの必須の[チャネル](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_Channel.html)設定および推奨される[サムネイル設定](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_ThumbnailConfiguration.html)があります。

### 必須: チャネルの設定 (ContainerFormat を使用)
<a name="multitrack-video-setup-adopting-required-required-channel-containerformat"></a>

マルチトラックビデオでは、MPEG2 トランスポートストリーム (TS) ファイルと互換性のない高度なコーデック (HEVC など) を使用するようにブロードキャストソフトウェアを設定できます。マルチトラックビデオを使用する前に、`Channel.ContainerFormat` を `FRAGMENTED_MP4` に設定する必要があります。

`ContainerFormat` の値を変更すると、ライブ配信と S3 へ録画 (有効になっている場合) の両方のメディアファイルの形式が変更されます。メディアコンテナ形式に依存するサードパーティーのプレイヤーアプリケーションまたはダウンストリームワークフローを更新する必要がある場合があります。

### 必須: チャネルの設定 (MultitrackInputConfiguration を使用)
<a name="multitrack-video-setup-adopting-required-required-channel-multitrackinputconfiguration"></a>

GetClientConfiguration API オペレーションを介して自動ストリーム設定を実装するには、IVS のマルチトラックビデオをサポートする配信ソフトウェアツールが必要です。ブロードキャストソフトウェアの統合について詳しくは、「[Multitrack Video Broadcast Software Integration Guide](multitrack-video-sw-integration.md)」を参照してください。

マルチトラック入力に対応するチャネルには、クリエーターの設定、ネットワーク環境、IVS コントロールプレーン用に最適化された、より動的な ABR ラダー (チャネルごとおよびストリーミングセッションごと) があります。コンテンツクリエーターがソフトウェア (OBS Studio など) でストリーミングを開始すると、クライアントが次の情報を収集して GetClientConfiguration に送信します。
+ ディスプレイ/キャンバス解像度、最大集計ビットレート、予約済みのエンコーダセッション/帯域幅、フレームレートなどを含むクリエーターの設定。
+ GPU モデル、GPU メモリ、GPU ドライバーのバージョン、OS バージョン、CPU モデル、システムメモリなど、クリエーターのハードウェア/OS メタデータ。

サーバー側のアルゴリズムにより、設定がスコアリングおよびランク付けされ、次の設定が提供されます。
+ ビューワーエクスペリエンス (最高解像度、フレームレート、ビットレート、レンディションの数) の最適化。
+ ストリーマーのセットアップによる安全サポート。
+ `MultitrackInputConfiguration` チャネルプロパティにより設定される制限の遵守。

最後に、ブロードキャストソフトウェアにより設定が適用され、[拡張 RTMP](https://veovera.org/docs/enhanced/enhanced-rtmp-v2) プロトコルを使用して複数のビデオトラックの送信が開始されます。

マルチトラックビデオを採用するには、[MultitrackInputConfiguration](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_MultitrackInputConfiguration.html) で指定された `Channel.MultitrackInputConfiguration` およびサブプロパティを設定する必要があります。
+ コストと品質のバランスをとるには、チャネルごとの最大入力解像度を設定する `Channel.MultitrackInputConfiguration.MaximumResolution` の適切な値を決定してください。ブロードキャストクライアントが GetClientConfiguration を呼び出すと、このフィールドによって、最大可能な入力トラックの解像度が決定されます。いずれかのクライアントが異なる数のトラックを送信した場合、またはトラックごとの解像度、フレームレート、コーデック、またはビットレートが GetClientConfiguration のレスポンスと一致しない場合、そのクライアントは切断されます。
+ ブロードキャスターの導入を柔軟にするために、`Channel.MultitrackInputConfiguration.Policy` を設定して、マルチトラック入力でブロードキャストクライアントが接続することを`allow`または`require`します。クライアントが RTMP を使用して接続する場合、このフィールドによりブロードキャスターでマルチトラックビデオの送信が許可されるか、または要求されるかが決定されます。ブロードキャスターでマルチトラックビデオの柔軟性を段階的に導入できるようにするか (`allow`）、またはブロードキャスターでマルチトラッククライアントを使用するよう要求して (`require`)、より低コストで最適化できるようにするかを選択できます。

### 推奨: ThumbnailConfiguration の確認と更新
<a name="multitrack-video-setup-adopting-recommended-thumbnailconfiguration"></a>

マルチトラック対応チャネルでサムネイルを有効にし、マルチトラッククライアントが接続されていて `resolution` を指定していない場合、すべての入力トラックのサムネイルが記録されます。コストを抑えるために、特定のレンディションを指定することもできます。

最も高品質なデータのパスは、マルチトラック入力とシングルトラック入力のストリームにおいて、相対的なパス構造が同じです。追加トラックのサムネイルは、`additional_thumbnails` サブキーに記録されます。適切なサムネイルパスを特定するため、S3 に書き込まれたメタデータ JSON ファイルを使用することをお勧めします。

## ブロードキャスターのシステムと環境要件
<a name="multitrack-video-setup-broadcaster-system"></a>

IVS マルチトラックビデオをサポートする配信クライアントは、配信ストリーム設定を自動的に設定するため、GetClientConfiguration API オペレーションを実装する必要があります。実運用環境では、制限として、古い 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 ベンダーとドライバーのバージョンに応じて、さまざまなビデオエンコード設定 (コーデックのプロファイル、エンコーダのプリセット、ルックアヘッドウィンドウ、心理視覚 AQ、B フレーム数など) を調整する。

次の表に、ハードウェア、ソフトウェア、環境設定に関する推奨事項を示します。


|  ユースケース  |  FULL\$1HD ストリーミング  | 
| --- | --- | 
|  GPU およびドライバーのバージョン  |  NVIDIA GeForce 900 シリーズ以降、NVIDIA ドライバー 545.92 以降 AMD Radeon RX 6000/7000 シリーズ以降、AMD Adrenalin 24.4.1 以降  | 
|  [Display] (表示)  |  60fps で 1920x1080  | 
|  持続的なアップストリーム帯域幅  |  12 Mbps  | 
|  オペレーティングシステム  |  Windows 10 または Windows 11  | 
|  ブロードキャストソフトウェア  |  OBS Studio v30.2 (またはそれ以降)  | 