Publisher Max Bitrate

Cette rubrique contient des informations détaillées sur l'utilisation de la fonction « Publisher Max Bitrate » dans le Client SDK du client Vonage Video pour iOS :

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

  • OTVideoBitratePresetDefault
  • OTVideoBitratePresetBwSaver
  • OTVideoBitratePresetExtraBwSaver
  • OTVideoBitratePresetCustom

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 binaire vidéo actuellement configuré pour un éditeur donné, définissez le paramètre OTPublisherKit.videoBitratePreset propriété :

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

Pour définir une présélection, assignez une valeur à la touche videoBitratePreset (propriété). Cette propriété accepte l'une des valeurs de la liste OTVideoBitratePreset à l'exception de l'enum OTVideoBitratePresetCustom.

Exemple :

publisher.videoBitratePreset = OTVideoBitratePresetBwSaver;

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 maximum actuellement défini pour un éditeur, vérifiez le paramètre OTPublisherKit.maxVideoBitrate propriété. Cette valeur correspond au débit maximal (en bits par seconde). Si aucune valeur personnalisée n'est définie, la propriété est fixée à 0.

Exemple :

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

Pour utiliser une valeur de débit maximale personnalisée (au lieu d'une valeur prédéfinie), réglez le paramètre OTPublisherKit.maxVideoBitrate propriété. Cette propriété accepte des valeurs comprises entre 5 000 et 10 000 000 (en bits par seconde).

Exemple :

publisher.maxVideoBitrate = 300000; // 300 kbps

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.

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

Après avoir défini un débit binaire personnalisé, la fonction videoBitratePreset est fixée à 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.");
}

Les publisher.maxVideoBitrate est fixée à 0 lorsque l'éditeur utilise un préréglage.

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