Publisher Max Bitrate

Cette rubrique contient des informations détaillées sur la configuration du débit binaire vidéo maximal à l'aide du Client SDK du client Android Vonage Video :

Pour obtenir une vue d'ensemble de l'API de débit binaire maximal de l'éditeur, consultez ce sujet.

Définition et récupération d'un préréglage

Les PublisherKit .VideoBitratePreset comprend des valeurs prédéfinies :

  • VideoBitratePresetDefault
  • VideoBitratePresetBwSaver
  • VideoBitratePresetExtraBwSaver
  • VideoBitratePresetCustom

Voir Préréglages du débit binaire vidéo pour plus de détails sur ces préréglages.

Pour récupérer le préréglage de débit vidéo actuellement configuré pour un éditeur donné, appelez la commande PublisherKit.getVideoBitratePreset() méthode :

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

Pour définir une présélection, appelez le PublisherKit.setVideoBitratePreset() méthode. Cette méthode comporte un paramètre : preset - une valeur de la liste VideoBitratePreset enum. Ne pas utiliser VideoBitratePresetCustom.

Exemple :

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

Définition et récupération d'une valeur de débit binaire brute

Si les préréglages prédéfinis ne conviennent pas, vous pouvez définir manuellement une valeur de débit binaire brut personnalisée.

Pour obtenir le débit vidéo maximal actuellement défini pour un éditeur, appelez la fonction PublisherKit.getMaxVideoBitrate() Cette méthode renvoie le débit binaire maximal actuellement défini (en bits par seconde). Cette méthode renvoie le débit binaire maximal actuellement défini (en bits par seconde). Si aucune valeur personnalisée n'est définie, la méthode renvoie 0.

Exemple :

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

Pour définir une valeur de débit maximale personnalisée (au lieu d'une valeur prédéfinie), utilisez la fonction PublisherKit.setMaxVideoBitrate() méthode. Cette méthode a un paramètre : maxVideoBitratele débit maximal souhaité (en bits par seconde). Le débit maxVideoBitrate doit être comprise entre 5 000 et 10 000 000.

Exemple :

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

Voir Définition des valeurs de débit binaire brut pour plus de détails.

Cas particuliers

Le fait de fixer la valeur du débit binaire brut à 0 supprime toute limitation du débit binaire précédemment fixée, ce qui revient au comportement par défaut.

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.");
}

Appeler le getVideoBitratePreset() après avoir défini un débit binaire personnalisé renvoie 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.");
}

Les PublisherKit.getMaxVideoBitrate() renvoie 0 lorsque l'éditeur utilise un préréglage.

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