Herausgeber Maximale Bitrate

Dieses Thema enthält Einzelheiten zur Verwendung der Publisher-Maximalbitrate im Vonage Video iOS-Client SDK:

Einen Überblick über die Publisher-API für die maximale Bitrate finden Sie unter dieses Thema.

Ein Voreinstellung festlegen und abrufen

Die OTVideoBitratePreset enum enthält voreingestellte Werte:

  • OTVideoBitratePresetDefault
  • OTVideoBitratePresetBwSaver
  • OTVideoBitratePresetExtraBwSaver
  • OTVideoBitratePresetCustom

Siehe Video-Bitrate-Voreinstellungen für Details zu diesen Voreinstellungen.

Um die aktuell konfigurierte Video-Bitratenvoreinstellung für einen bestimmten Herausgeber abzurufen, setzen Sie die OTPublisherKit.videoBitratePreset Eigentum:

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

Um eine Voreinstellung festzulegen, weisen Sie dem Feld videoBitratePreset Eigenschaft. Diese Eigenschaft akzeptiert einen der Werte aus der Tabelle OTVideoBitratePreset enum, außer für OTVideoBitratePresetCustom.

Beispiel:

publisher.videoBitratePreset = OTVideoBitratePresetBwSaver;

Festlegen und Abrufen eines Rohwerts für die Bitrate

Wenn die vordefinierten Voreinstellungen nicht geeignet sind, können Sie manuell einen benutzerdefinierten Rohbitratenwert festlegen.

Um die maximale Videobitrate zu erhalten, die derzeit für einen Publisher eingestellt ist, prüfen Sie die OTPublisherKit.maxVideoBitrate Eigenschaft. Diese wird auf die maximale Bitrate (in Bits pro Sekunde) festgelegt. Wenn kein benutzerdefinierter Wert festgelegt ist, wird die Eigenschaft auf 0 gesetzt.

Beispiel:

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

Um einen benutzerdefinierten Wert für die maximale Bitrate (anstelle einer Voreinstellung) zu verwenden, setzen Sie den OTPublisherKit.maxVideoBitrate Eigenschaft. Diese Eigenschaft akzeptiert Werte zwischen 5.000 und 10.000.000 (in Bits pro Sekunde).

Beispiel:

publisher.maxVideoBitrate = 300000; // 300 kbps

Siehe Einstellung von Rohbitratenwerten für weitere Einzelheiten.

Sonderfälle

Wenn Sie den Wert für die Rohbitrate auf 0 setzen, werden alle zuvor festgelegten Bitratenbeschränkungen aufgehoben und das Standardverhalten wird wiederhergestellt.

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);

Nachdem Sie eine benutzerdefinierte Bitrate eingestellt haben, wird die videoBitratePreset Eigenschaft wird auf 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.");
}

Die publisher.maxVideoBitrate ist auf 0 gesetzt, wenn der Verlag eine Voreinstellung verwendet.

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