Einstellen der maximalen Bitrate für einen Stream

Die Details zur Verwendung von Publisher Max Bitrate im Vonage Video macOS Client SDK sind dieselben wie im Linux Client SDK.

Die properties prop der OTPublisher-Komponente enthält eine videoBitratePreset Eigenschaft. Setzen Sie diese Eigenschaft auf einen der folgenden String-Werte, damit der Herausgeber eine voreingestellte Videobitrate verwendet: default, bw_saver, oder extra_bw_saver. Siehe Video-Bitrate-Voreinstellungen für Details zu diesen Voreinstellungen.

Beispiel:

<OTPublisher
  properties={{
    videoBitratePreset: 'bw_saver',
    // ... other properties
  }}
/>

Die videoBitratePreset wird ignoriert, wenn die Eigenschaft maxVideoBitrate Eigenschaft (im nächsten Abschnitt beschrieben) gesetzt ist. Wenn keine der beiden Eigenschaften gesetzt ist, verwendet der Verlag die Standardvorgabe.

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

Die properties prop der OTPublisher-Komponente enthält eine maxVideoBitrate Eigenschaft. Um den maximalen Bitratenwert (anstelle einer Voreinstellung) festzulegen, setzen Sie diese Eigenschaft auf einen Wert zwischen 5.000 und 10.000.000 (in Bits pro Sekunde).

Beispiel:

<OTPublisher
  properties={{
    maxVideoBitrate: 500000,
    // ... other properties
  }}
/>

Die maxVideoBitrate hat Vorrang vor der Eigenschaft videoBitratePreset Eigenschaft (beschrieben im vorherigen Abschnitt). Wenn beide eingestellt sind, wird nur die maxVideoBitrate Eigenschaft verwendet wird. Wenn keine der beiden Eigenschaften gesetzt ist, verwendet der Verlag die Standardvoreinstellung.

Das Publisher-Objekt umfasst setVideoBitratePreset() und getVideoBitratePreset() Methoden. Die Website setVideoBitratePreset() Methode akzeptiert String-Werte - 'DEFAULT', 'BW_SAVER', oder 'EXTRA_BW_SAVER' (oder ihre Gegenstücke in Kleinbuchstaben) - und die getVideoBitratePreset() Methode gibt diese Werte (oder 'CUSTOM') zurück. Siehe Video-Bitrate-Voreinstellungen für weitere Einzelheiten zu diesen Voreinstellungen.

Bitte beachten Sie die getVideoBitratePreset() Methode gibt zurück undefined wenn zuvor keine Voreinstellung oder Bitrate festgelegt wurde.

Die setVideoBitratePreset() Methode hat einen Parameter: presetdie gewünschte Voreinstellung.

Beispiel:

console.log(publisher.getVideoBitratePreset());  // undefined

await publisher.setVideoBitratePreset('BW_SAVER');  // or 'DEFAULT' or 'EXTRA_BW_SAVER'

console.log(publisher.getVideoBitratePreset());  // 'BW_SAVER'

Die setVideoBitratePreset() Methode kann einen Fehler auslösen, wenn die name des Fehlerobjekts auf den folgenden Wert gesetzt:

• OT_INVALID_PARAMETER - Ungültige Voreinstellung. Es muss 'DEFAULT', 'BW_SAVER' oder 'EXTRA_BW_SAVER' sein.

• OT_UNEXPECTED_ERROR_CODE - Es ist ein unerwarteter Fehler aufgetreten, und die Voreinstellung wurde nicht aktualisiert.

Umfassen Sie den Aufruf der setVideoBitratePreset() Methode in einem try/catch-Block, auch wenn der voreingestellte Name korrekt ist:

const invalidPreset = 'VERY_FAST';
try {
    await publisher.setVideoBitratePreset(invalidPreset);
} catch (err) {
    console.error(err.name);
    // 'OT_INVALID_PARAMETER'
}

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, rufen Sie die getMaxVideoBitrate() Methode eines Publisher-Objekts. Sie gibt die aktuell eingestellte maximale Bitrate (in Bits pro Sekunde) zurück. Wenn kein benutzerdefinierter Wert eingestellt ist, gibt die Funktion undefined.

Beispiel:

console.log(publisher.getMaxVideoBitrate());

Um einen benutzerdefinierten Wert für die maximale Bitrate (anstelle einer Voreinstellung) festzulegen, verwenden Sie die setMaxVideoBitrate() eines Publisher-Objekts zu verwenden. Diese Funktion hat einen einzigen Parameter: bitrateBpsdie gewünschte maximale Bitrate (in Bits pro Sekunde), zwischen 5.000 und 10.000.000.

Beispiel:

const new_bitrate = 300000; // 300 kbps
await publisher.setMaxVideoBitrate(new_bitrate);

Die setMaxVideoBitrate() Methode kann einen Fehler auslösen, wenn die name des Fehlerobjekts auf den folgenden Wert gesetzt:

• OT_INVALID_PARAMETER - Ungültige Bitrate. Der Wert muss 0 oder eine Zahl zwischen 5000 und 10000000 sein.
• OT_UNEXPECTED_ERROR_CODE - Es ist ein unerwarteter Fehler aufgetreten und die Bitrate wurde nicht aktualisiert.

Umfassen Sie den Aufruf der setVideoBitratePreset() Methode in einem try/catch-Block, auch wenn die übergebene Zahl gültig ist.

Siehe Einstellung von Rohbitratenwerten für weitere Einzelheiten.

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

const zero_bitrate = 0;  // no limitations
const int new_bitrate = 300000; // 300 kbps
publisher.setMaxVideoBitrate(new_bitrate);
// publisher.getMaxVideoBitrate() === 300000

publisher.setMaxVideoBitrate(zero_bitrate);
// publisher.getMaxVideoBitrate() === 0
natale-p marked this conversation as resolved.

Aufrufen der getVideoBitratePreset() Methode nach dem Einstellen einer anderen benutzerdefinierten Bitrate als 0 zurück CUSTOM.

const zero_bitrate = 0;  // no limitations
const new_bitrate = 1000000; // 1 mbps
publisher.setMaxVideoBitrate(new_bitrate);
// publisher.getVideoBitratePreset() === 'CUSTOM'

publisher.setMaxVideoBitrate(zero_bitrate);
// publisher.getVideoBitratePreset() === 'DEFAULT'

Der Getter für die Rohbitrate gibt 0 zurück, wenn der Herausgeber eine Voreinstellung verwendet.

let bitrateBps = publisher.getMaxVideoBitrate();
// bitrateBps === 0

publisher.setVideoBitratePreset('bw_saver);
bitrateBps = publisher.getMaxVideoBitrate();
// bitrateBps === 0
publisher.setVideoBitratePreset('extra_bw_saver');
bitrateBps = publisher.getMaxVideoBitrate();
// bitrateBps === 0
publisher.setMaxVideoBitrate(200000);
bitrateBps = publisher.getMaxVideoBitrate();
// bitrateBps === 200000
publisher.setVideoBitratePreset('default');
bitrateBps = publisher.getMaxVideoBitrate();
// bitrateBps === 0

Die PublisherKit .VideoBitratePreset enum enthält voreingestellte Werte:

• VideoBitratePresetDefault
• VideoBitratePresetBwSaver
• VideoBitratePresetExtraBwSaver
• VideoBitratePresetCustom

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

Um die aktuell konfigurierte Video-Bitratenvoreinstellung für einen bestimmten Publisher abzurufen, rufen Sie die Funktion PublisherKit.getVideoBitratePreset() Methode:

PublisherKit.VideoBitratePreset retrievedBitratePreset = publisherKit.getVideoBitratePreset();
System.out.println("The video bitrate preset is: " + retrievedBitratePreset);

Um eine Voreinstellung zu setzen, rufen Sie die Funktion PublisherKit.setVideoBitratePreset() Methode. Diese Methode enthält einen Parameter: preset - einen Wert aus der VideoBitratePreset enum. Verwenden Sie nicht VideoBitratePresetCustom.

Beispiel:

PublisherKit.VideoBitratePreset bitratePreset = PublisherKit.VideoBitratePreset.VideoBitratePresetBwSaver;
publisherKit.setVideoBitratePreset(bitratePreset);

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, rufen Sie die PublisherKit.getMaxVideoBitrate() Methode. Sie gibt die aktuell eingestellte maximale Bitrate (in Bits pro Sekunde) zurück. Wenn kein benutzerdefinierter Wert eingestellt ist, gibt die Methode 0 zurück.

Beispiel:

int retrievedMaxVideoBitrate = publisherKit.getMaxVideoBitrate();
System.out.println("The maximum video bitrate is: " + retrievedMaxVideoBitrate + " kbps");

Um einen benutzerdefinierten Wert für die maximale Bitrate (anstelle einer Voreinstellung) festzulegen, verwenden Sie die PublisherKit.setMaxVideoBitrate() Methode. Diese Methode hat einen Parameter: maxVideoBitratedie gewünschte maximale Bitrate (in Bits pro Sekunde). Die maxVideoBitrate Wert muss zwischen 5.000 und 10.000.000 liegen.

Beispiel:

int maxVideoBitrate = 300000; // 300 kbps
publisherKit.setMaxVideoBitrate(maxVideoBitrate);

Siehe Einstellung von Rohbitratenwerten für weitere Einzelheiten.

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

int zeroBitrate = 0; // No limitations
int newBitrate = 300000; // 300 kbps

// Set the maximum video bitrate
publisherKit.setMaxVideoBitrate(newBitrate);

// Validate that the bitrate was set correctly
if (publisherKit.getMaxVideoBitrate() == newBitrate) {
    System.out.println("Max video bitrate set successfully to: " + newBitrate);
}

// Reset the maximum video bitrate to the default behavior
publisherKit.setMaxVideoBitrate(zeroBitrate);

// Validate that the bitrate was reset to default
if (publisherKit.getMaxVideoBitrate() == zeroBitrate) {
    System.out.println("Max video bitrate reset to default.");
}

Aufrufen der getVideoBitratePreset() Methode nach der Einstellung einer benutzerdefinierten Bitrate zurück VideoBitratePresetCustom.

int newBitrate = 1000000; // 1 Mbps

// Set a custom bitrate
publisherKit.setMaxVideoBitrate(newBitrate);

// Validate that the preset is set to CUSTOM
if (publisherKit.getVideoBitratePreset() == PublisherKit.VideoBitratePreset.VideoBitratePresetCustom) {
    System.out.println("Video bitrate preset set to CUSTOM.");
}

// Reset bitrate to default
publisherKit.setMaxVideoBitrate(zeroBitrate);

// Validate that the preset is reset to DEFAULT
if (publisherKit.getVideoBitratePreset() == PublisherKit.VideoBitratePreset.VideoBitratePresetDefault) {
    System.out.println("Video bitrate preset reset to DEFAULT.");
}

Die PublisherKit.getMaxVideoBitrate() Methode gibt 0 zurück, wenn der Verleger eine Voreinstellung verwendet.

// Get the current raw bitrate (default should be 0)
int bitrateBps = publisherKit.getMaxVideoBitrate();
assert bitrateBps == 0;

// Set the preset to BW_SAVER
publisherKit.setVideoBitratePreset(PublisherKit.VideoBitratePreset.VideoBitratePresetBwSaver);
bitrateBps = publisherKit.getMaxVideoBitrate();
assert bitrateBps == 0;

// Set the preset to EXTRA_BW_SAVER
publisherKit.setVideoBitratePreset(PublisherKit.VideoBitratePreset.VideoBitratePresetExtraBwSaver);
bitrateBps = publisherKit.getMaxVideoBitrate();
assert bitrateBps == 0;

// Set a custom bitrate
publisherKit.setMaxVideoBitrate(200000);
bitrateBps = publisherKit.getMaxVideoBitrate();
assert bitrateBps == 200000;

// Reset the preset to DEFAULT
publisherKit.setVideoBitratePreset(PublisherKit.VideoBitratePreset.VideoBitratePresetDefault);
bitrateBps = publisherKit.getMaxVideoBitrate();
assert bitrateBps == 0;

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;

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.

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

Die VideoBitratePreset enum enthält voreingestellte Werte:

• Default
• BwSaver
• ExtraBwSaver
• Custom

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

Um die aktuell konfigurierte Video-Bitratenvoreinstellung für einen bestimmten Publisher abzurufen, rufen Sie die Publisher.VideoBitratePreset Eigentum:

var preset = publisher.VideoBitratePreset;
if (preset == VideoBitratePreset.BwSaver)
{
    Console.WriteLine("The publisher is using the BW_SAVER preset.");
}

Um eine Voreinstellung festzulegen, stellen Sie den Publisher.VideoBitratePreset Eigenschaft auf einen Wert aus derVideoBitratePreset enum. Verwenden Sie nicht die Custom Wert.

Beispiel:

publisher.VideoBitratePreset = VideoBitratePreset.BwSaver;
Console.WriteLine("Bitrate preset successfully set to BW_SAVER.");

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

Um die aktuelle maximale Videobitrate (in Bits pro Sekunde) abzurufen, rufen Sie den Befehl Publisher.MaxVideoBitrate Eigenschaft. Wenn kein benutzerdefinierter Wert festgelegt ist, wird er auf 0 gesetzt.

Beispiel:

int maxBitrate = publisher.MaxVideoBitrate;
Console.WriteLine($"Current max video bitrate: {maxBitrate} bps");

Um eine benutzerdefinierte maximale Bitrate (anstelle einer Voreinstellung) festzulegen, weisen Sie dem Feld Bitrate einen Wert (zwischen 5.000 und 10.000.000) zu. MaxVideoBitrate Eigentum.

Beispiel:

int newBitrate = 300000; // 300 kbps
publisher.MaxVideoBitrate = newBitrate;
Console.WriteLine($"Successfully set max video bitrate to {newBitrate} bps.");

Siehe Einstellung von Rohbitratenwerten für weitere Einzelheiten.

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

int zeroBitrate = 0;  // no limitations
int newBitrate = 300000;

publisher.MaxVideoBitrate = newBitrate;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == newBitrate);

publisher.MaxVideoBitrate = zeroBitrate;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == zeroBitrate);

Die Einstellung einer benutzerdefinierten Bitrate bewirkt, dass die VideoBitratePreset Eigenschaft zu setzen auf VideoBitratePreset.Custom:

publisher.MaxVideoBitrate = 1000000; // 1 Mbps
System.Diagnostics.Debug.Assert(publisher.VideoBitratePreset == VideoBitratePreset.Custom);

publisher.MaxVideoBitrate = 0;
System.Diagnostics.Debug.Assert(publisher.VideoBitratePreset == VideoBitratePreset.Default);

Die MaxVideoBitrate gibt 0 zurück, wenn der Verleger eine Voreinstellung verwendet:

publisher.VideoBitratePreset = VideoBitratePreset.BwSaver;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == 0);

publisher.VideoBitratePreset = VideoBitratePreset.ExtraBwSaver;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == 0);

publisher.MaxVideoBitrate = 200000;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == 200000);

publisher.VideoBitratePreset = VideoBitratePreset.Default;
System.Diagnostics.Debug.Assert(publisher.MaxVideoBitrate == 0);

Die otc_video_bitrate_preset enum, in der publisher.h Kopfzeile, enthält voreingestellte Werte:

• OTC_VIDEO_BITRATE_PRESET_DEFAULT
• OTC_VIDEO_BITRATE_PRESET_BW_SAVER
• OTC_VIDEO_BITRATE_PRESET_EXTRA_BW_SAVER
• OTC_VIDEO_BITRATE_PRESET_CUSTOM

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

Um die aktuell konfigurierte Video-Bitratenvoreinstellung für einen bestimmten Publisher abzurufen, rufen Sie die Funktion otc_publisher_get_video_bitrate_preset() Funktion:

enum otc_video_bitrate_preset preset = otc_publisher_get_video_bitrate_preset(publisher);
if (preset == OTC_VIDEO_BITRATE_PRESET_BW_SAVER) {
    printf("The publisher is using the BW_SAVER preset.\n");
}

Um eine Voreinstellung zu setzen, rufen Sie die Funktion otc_publisher_set_video_bitrate_preset() Funktion. Diese Funktion enthält zwei Parameter:

• publisher - Ein Zeiger auf die otc_publisher-Instanz.
• preset - Ein Wert von otc_video_bitrate_preset. Nicht verwenden OTC_VIDEO_BITRATE_PRESET_CUSTOM.

Die Funktion gibt einen dieser Werte zurück:

• OTC_SUCCESS - Die Voreinstellung wurde erfolgreich angewendet.
• OTC_ERROR_INVALID_PARAMETER - Der angegebene Verlag ist NULL oder die Voreinstellung ist ungültig.

Beispiel:

otc_status status = otc_publisher_set_video_bitrate_preset(publisher, OTC_VIDEO_BITRATE_PRESET_BW_SAVER);
if (status == OTC_SUCCESS) {
    printf("Bitrate preset successfully set to BW_SAVER.\n");
} else {
    printf("Failed to set bitrate preset.\n");
}

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, rufen Sie die otc_publisher_get_max_video_bitrate() Funktion. Sie gibt die aktuell eingestellte maximale Bitrate (in Bits pro Sekunde) zurück. Wenn kein benutzerdefinierter Wert eingestellt ist, gibt die Funktion 0 zurück.

Beispiel:

int max_bitrate = otc_publisher_get_max_video_bitrate(publisher);
printf("Current max video bitrate: %d bps\n", max_bitrate);

Um einen benutzerdefinierten Wert für die maximale Bitrate (anstelle einer Voreinstellung) festzulegen, verwenden Sie die otc_publisher_set_max_video_bitrate() Funktion. Diese Funktion hat die folgenden Parameter:

• publisher - Ein Zeiger auf eine vorhandene otc_publisher-Instanz.
• bitrate_bps - Die gewünschte maximale Bitrate (in Bits pro Sekunde). Sie muss zwischen 5.000 und 10.000.000 liegen. Die Funktion gibt einen der folgenden Werte zurück:
• OTC_SUCCESS - Die Bitrate wurde erfolgreich angewendet.
• OTC_ERROR_INVALID_PARAMETER - Der Zeiger des Herausgebers lautet NULL, oder bitrate_bps außerhalb des Bereichs liegt. Beispiel:

int new_bitrate = 300000; // 300 kbps
otc_status status = otc_publisher_set_max_video_bitrate(publisher, new_bitrate);
if (status == OTC_SUCCESS) {
    printf("Successfully set max video bitrate to %d bps.\n", new_bitrate);
} else {
    printf("Failed to set max video bitrate.\n");
}

Siehe Einstellung von Rohbitratenwerten für weitere Einzelheiten.

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

const int zero_bitrate = 0;  // no limitations
const int new_bitrate = 300000; // 300 kbps
otc_status status = otc_publisher_set_max_video_bitrate(publisher, new_bitrate);

if (status == OTC_SUCCESS) {
  assert(otc_publisher_get_max_video_bitrate(publisher) == new_bitrate);
}

status = otc_publisher_set_max_video_bitrate(publisher, zero_bitrate);
if (status == OTC_SUCCESS) {
  assert(otc_publisher_get_max_video_bitrate(publisher) == zero_bitrate);
}

Der Aufruf der (otc_publisher_get_video_bitrate_preset()) nach der Einstellung einer benutzerdefinierten Bitrate zurück OTC_VIDEO_BITRATE_PRESET_CUSTOM.

const int new_bitrate = 1000000; // 1 mbps
otc_status status = otc_publisher_set_max_video_bitrate(publisher, new_bitrate);

if (status == OTC_SUCCESS) {
  assert(otc_publisher_get_video_bitrate_preset(publisher) == OTC_VIDEO_BITRATE_PRESET_CUSTOM);
}

status = otc_publisher_set_max_video_bitrate(publisher, zero_bitrate);
if (status == OTC_SUCCESS) {
  assert(otc_publisher_get_video_bitrate_preset(publisher) == OTC_VIDEO_BITRATE_PRESET_DEFAULT);
}

Der Getter für die Rohbitrate gibt 0 zurück, wenn der Herausgeber eine Voreinstellung verwendet.

// Assume all the statuses are OTC_SUCCESS

int bitrate_bps = otc_publisher_get_max_video_bitrate(publisher);
assert(bitrate_bps == 0);

otc_publisher_set_video_bitrate_preset(publisher, OTC_VIDEO_BITRATE_PRESET_BW_SAVER);
bitrate_bps = otc_publisher_get_max_video_bitrate(publisher);
assert(bitrate_bps == 0);

otc_publisher_set_video_bitrate_preset(publisher, OTC_VIDEO_BITRATE_PRESET_EXTRA_BW_SAVER);
bitrate_bps = otc_publisher_get_max_video_bitrate(publisher);
assert(bitrate_bps == 0);

otc_publisher_set_max_video_bitrate(publisher, 200000);
bitrate_bps = otc_publisher_get_max_video_bitrate(publisher);
assert(bitrate_bps == 200000);

otc_publisher_set_video_bitrate_preset(publisher, OTC_VIDEO_BITRATE_PRESET_DEFAULT);
bitrate_bps = otc_publisher_get_max_video_bitrate(publisher);
assert(bitrate_bps == 0);