Publisher Max Bitrate

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

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 VideoBitratePreset comprend des valeurs prédéfinies :

  • Default
  • BwSaver
  • ExtraBwSaver
  • Custom

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é, accédez à l'option Publisher.VideoBitratePreset propriété :

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

Pour définir une présélection, réglez la touche Publisher.VideoBitratePreset à une valeur de la propriétéVideoBitratePreset enum. N'utilisez pas l'enum Custom valeur.

Exemple :

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

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 actuel (en bits par seconde), accédez à l'option Publisher.MaxVideoBitrate propriété. Si aucune valeur personnalisée n'est définie, elle prend la valeur 0.

Exemple :

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

Pour définir un débit binaire maximum personnalisé (au lieu d'un préréglage), attribuez une valeur (entre 5 000 et 10 000 000) à la fonction MaxVideoBitrate propriété.

Exemple :

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

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;

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

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

La définition d'un débit binaire personnalisé entraîne l'utilisation de la fonction VideoBitratePreset pour qu'elle soit fixée à 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);

Les MaxVideoBitrate renvoie 0 lorsque l'éditeur utilise un préréglage :

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