サーバーサイドコンポジションの概要

クライアント負荷の軽減 – サーバーサイドコンポジションを使用すると、音声と動画のソースを処理および結合する負担が、個々のクライアントデバイスからサーバー側に移転します。サーバーサイドコンポジションにより、ビューを合成してIVS に送信するクライアントデバイスは、CPU とネットワークリソースを使用しなくても良くなります。つまり、視聴者のデバイスでは、リソースを大量に消費するタスクを処理しなくてもブロードキャストの視聴が可能になり、より長いバッテリー寿命と、よりスムーズな視聴体験が実現されます。

一貫した品質 – サーバーサイドコンポジションでは、最終的なストリームの品質、解像度、ビットレートを正確に制御することができます。これにより、個々のデバイスの性能に関係なく、すべての視聴者に対し一貫した視聴体験が保証されます。

レジリエンス – コンポジションプロセスをサーバー上で一元化することで、ブロードキャストをより堅牢にできます。パブリッシャーのデバイスに技術的な制限がかかっていたり、変動が発生していたりしても、サーバーはそれに適応するので、すべての視聴者にスムーズなストリームを提供できます。

帯域幅の効率 – コンポジションの処理はサーバーで実行されるため、ステージパブリッシャーは、ビデオを IVS にブロードキャストする帯域幅を余分に消費する必要がありません。

EncoderConfiguration オブジェクトは、生成する動画の形式 (高さ、幅、ビットレート、その他のストリーミングパラメータ) をカスタマイズできるようにします。StartComposition オペレーションを呼び出すたびに、EncoderConfiguration を再利用できます。

コンポジションオペレーションはビデオコンポジションを追跡し、IVS チャネルに出力します。

StorageConfiguration は、コンポジションが記録されている S3 バケットを追跡します。

videoAspectRatio は、ビデオタイルのアスペクト比を制御するように参加者表示モードを設定します。

videoFillMode は、ビデオコンテンツが参加者タイルにどのように適合するかを定義します。

gridGap は、参加者タイル間の間隔をピクセル単位で指定します。

omitStoppedVideo では、停止したビデオストリームをコンポジションから除外できます。

featuredParticipantAttribute は、注目のスロットを識別します。これを設定すると、注目の参加者はメイン画面の大きなスロットに表示され、他の参加者はその下に表示されます。

participantOrderAttribute は、参加者トークンの属性値に基づきカスタム参加者の順序付けを有効にします。指定した場合、参加者は属性値で数値順に並べられ、属性がない参加者は到着時刻の順序にフォールバックします。これにより、決定論的な配置がオプションで実施でき、ロールベースのレイアウトが可能になります。

pipParticipantAttribute は PiP ウィンドウの参加者を指定します。

pipPosition は PiP ウィンドウのコーナー位置を決定します。

pipWidth および pipHeight は、PiP ウィンドウの幅と高さを設定します。

pipOffset は、PiP ウィンドウのオフセット位置を、最も近いエッジからのピクセル単位で設定します。

pipBehavior は、他のすべての参加者が退出したときの PiP 動作を定義します。