パブリッシャー最大ビットレート

このトピックでは、Vonage Video iOS Client SDKにおける「Publisher Max Bitrate」の使用方法について詳しく説明しています：

プリセットの設定と取得
生ビットレートの値の設定と取得
特例

パブリッシャーの最大ビットレート API の概要については、以下を参照してください。本題.

プリセットの設定と取得

について OTVideoBitratePreset enumはプリセット値を含む：

OTVideoBitratePresetDefault
OTVideoBitratePresetBwSaver
OTVideoBitratePresetExtraBwSaver
OTVideoBitratePresetCustom

指定されたパブリッシャーに対して現在設定されているビデオビットレートプリセットを取得するには、次のように設定します。 OTPublisherKit.videoBitratePreset 財産である：

OTVideoBitratePreset retrievedBitratePreset = publisher.videoBitratePreset;
NSLog(@"The video bitrate preset is: %ld", (long)retrievedBitratePreset);

プリセットを設定するには、値を videoBitratePreset プロパティを指定します。このプロパティは OTVideoBitratePreset を除く。 OTVideoBitratePresetCustom.

例

publisher.videoBitratePreset = OTVideoBitratePresetBwSaver;

生ビットレートの値の設定と取得

定義済みのプリセットが適切でない場合は、カスタムRAWビットレート値を手動で設定できます。

パブリッシャーに現在設定されている最大ビデオビットレートを取得するには OTPublisherKit.maxVideoBitrate プロパティを使用します。これは最大ビットレート（ビット毎秒）に設定されます。カスタム値が設定されていない場合、プロパティは 0 に設定されます。

例

int retrievedMaxVideoBitrate = publisher.maxVideoBitrate;
NSLog(@"The maximum video bitrate is: %d kbps", retrievedMaxVideoBitrate);

プリセットの代わりに）カスタムの最大ビットレート値を使用するには、次のように設定します。 OTPublisherKit.maxVideoBitrate プロパティを指定します。このプロパティは、5,000～10,000,000（ビット/秒）の値を受け付ける。

例

publisher.maxVideoBitrate = 300000; // 300 kbps

参照未加工ビットレート値の設定をご覧ください。

特例

未加工のビットレート値を0に設定すると、それまで設定されていたビットレートの制限が解除され、デフォルトの動作に戻ります。

publisher.maxVideoBitrate = 300000; // Set the maximum video bitrate to 300 kbps
NSLog(@"Max video bitrate set successfully to: %d", publisher.maxVideoBitrate);

publisher.maxVideoBitrate = 0; // Reset the maximum video bitrate to the default behavior
NSLog(@"Max video bitrate reset to default: %d", publisher.maxVideoBitrate);

カスタムビットレートを設定した後 videoBitratePreset プロパティが OTVideoBitratePresetCustom.

publisher.maxVideoBitrate = 1000000; // Set a custom bitrate to 1 Mbps
if (publisher.videoBitratePreset == OTVideoBitratePresetCustom) {
    NSLog(@"Video bitrate preset set to CUSTOM.");
}

publisher.maxVideoBitrate = 0; // Reset bitrate to default
if (publisher.videoBitratePreset == OTVideoBitratePresetDefault) {
    NSLog(@"Video bitrate preset reset to DEFAULT.");
}

について publisher.maxVideoBitrate プロパティは、パブリッシャーがプリセットを使用している場合、0に設定されます。

NSLog(@"Default bitrate: %d", publisher.maxVideoBitrate); // Default should be 0

publisher.videoBitratePreset = OTVideoBitratePresetBwSaver;
NSLog(@"Bitrate for BW_SAVER preset: %d", publisher.maxVideoBitrate); // Should be 0

publisher.videoBitratePreset = OTVideoBitratePresetExtraBwSaver;
NSLog(@"Bitrate for EXTRA_BW_SAVER preset: %d", publisher.maxVideoBitrate); // Should be 0

publisher.maxVideoBitrate = 200000; // Set a custom bitrate
NSLog(@"Custom bitrate: %d", publisher.maxVideoBitrate);

publisher.videoBitratePreset = OTVideoBitratePresetDefault; // Reset to default preset
NSLog(@"Bitrate after reset to DEFAULT preset: %d", publisher.maxVideoBitrate); // Should be 0