ビデオ制約：希望解像度とフレームレートの設定

Vonage Video APIにより、パブリッシャはビデオの解像度とフレームレートに好みの制約を設定することで、ビデオストリームを最適化できます。これらの制約は、帯域幅の使用を管理し、デバイスの機能に対応し、加入者に合わせたユーザー体験を提供するのに役立ちます。

このガイドでは preferredResolution そして preferredFrameRate パブリッシャー向けのAPI。

注：これらのAPIは現在、JavaScript SDKでのみ利用可能です。他のSDKでのサポート予定は発表されていません。

概要

ビデオストリームを公開する際、帯域幅の節約、UI要件との整合、または特定の加入者ロール（サムネイルや低モーション画面など）のリソース消費の制限など、さまざまな理由でビデオ品質を動的に調整したい場合があります。VonageのパブリッシャーAPIは、ビデオトラックの好ましい解像度とフレームレートを調整するメソッドを公開しています。これらの制約は、最適な結果を得るために標準的な WebRTC API を使用してビデオ入力デバイスに強制されますが、最終的にはすべての加入者が受信するものに影響します。

ビデオ解像度とフレームレートの制御

出版社が指定できる：

望ましい解像度:ビデオストリームに必要な幅と高さ（ピクセル単位）。
希望フレームレート:ビデオストリームの希望フレーム数（fps）。

以下の方法で動的に制御できます。 その後 パブリッシャーが初期化されます：

// Set preferred resolution (width x height)
await publisher.setPreferredResolution({ width: 640, height: 360 });

// Set preferred frame rate
await publisher.setPreferredFrameRate(15);

これらの設定は、パブリッシャーから出力されるビデオトラックを直接制御し、すべての加入者の品質に影響を与えます。しかし、実際のネットワーク状況やデバイスの能力によって、これらの値が制限されたり、上書きされたりすることがあります。

優先解像度の設定

方法だ： publisher.setPreferredResolution(preferredResolution)

preferredResolution を持つオブジェクトである。 width そして height プロパティ（いずれもピクセル単位の正の整数）。
解像度は、最初に公開した解像度より大きくすることはできません。例えば、640×480で公開した場合、それ以上の解像度を設定することはできません。

典型的な用途：

publisher.setPreferredResolution({ width: 320, height: 240 });

検証：

ビデオをキャプチャしているパブリッシャー (publishVideo: true).
両方 width そして height は正の整数でなければならない。
解像度は、最初のパブリッシング解像度より大きくすることはできない。

エラー事例：

音声のみのパブリッシャーで呼ばれた場合、または入力値が無効な場合にスローされます。

優先フレームレートの設定

方法だ： publisher.setPreferredFrameRate(frameRate)

frameRate は1以上の整数でなければならない。