Un diffuseur capture un flux audio-vidéo à partir des sources que vous spécifiez. En savoir plus...

Hérite de l'interface IDisposable.

Description détaillée

Un diffuseur capture un flux audio-vidéo à partir des sources que vous spécifiez.

Utiliser le Publisher.Builder classe pour créer un Éditeur par exemple. Vous pouvez ensuite publier le flux audio-vidéo vers une session de la Video API de Vonage en appelant la méthode Session.Publish(Publisher) méthode.

Les Éditeur La classe implémente l'interface System.IDisposable. Veillez à appeler la méthode Dispose() de la méthode Éditeur objet doit libérer ses ressources lorsque vous n'en avez plus besoin (par exemple, lorsque le Éditeur est supprimé ou lorsque l'application ou la fenêtre se ferme).

Documentation sur l'énumération des membres

VideoReason

Définit les valeurs pour le VideoEventArgs.Reason et VideoEventArgs.Reason propriétés.

Documentation sur les fonctions de membre

Dispose()

Traite de la Éditeur les ressources de l'objet.

Il convient de noter que le ÉditeurSes ressources sont les suivantes : pas traité lorsque vous appelez le Session.Publish(Publisher) méthode. Lorsque vous appelez Session.Publish(Publisher), les ressources de la Éditeur L'objet est conservé afin que vous puissiez le réutiliser (pour le publier à nouveau dans la session).

GetRtcStatsReport()

Récupère le rapport statistique RTC de l'éditeur. Il s'agit d'une opération asynchrone. Lorsque les statistiques sont disponibles, le RtcStatsReport est envoyé.

Voir aussi Mise à jour des statistiques audio, Statistiques vidéo - Mise à jouret Subscriber.GetRtcStatsReport().

Documentation relative aux biens immobiliers

Débit binaire vidéo maximal

Débit binaire maximal de la vidéo pour le flux vidéo de l'éditeur (en bits par seconde).

Cette propriété définit une limite supérieure explicite pour le débit binaire de la vidéo de l'éditeur. Si vous définissez cette propriété sur 0, toute limite manuelle est supprimée et le système revient au comportement par défaut de débit binaire adaptatif basé sur les préréglages, sans limite explicite.

La lecture de cette propriété renvoie le débit binaire maximal actuellement configuré, en bps. Si aucun débit binaire n'a été défini manuellement ou si un préréglage de débit binaire est actif, la valeur est 0.

Une valeur égale à 0 indique qu'aucune limite de débit binaire explicite n'est appliquée et que le flux fonctionne selon des règles de préréglage adaptatives afin d'optimiser la qualité.

Publier une vidéo

Mode d'évolutivité cible

Mode d’évolutivité cible (SVC – Scalable Video Coding) pour cet éditeur. Le mode d’évolutivité détermine le nombre de couches spatiales (résolution) et temporelles (fréquence d’images) encodées par WebRTC. Ce mode s’applique au chemin multimédia du Media Router.

Le « setter » peut être appelé à tout moment ; il n’est pas nécessaire que la négociation du chemin multimédia soit terminée. Le mode sera appliqué dès que le chemin multimédia du routeur multimédia sera établi.

Si un codec non SVC (VP8, H.264) est négocié sur le chemin multimédia du routeur multimédia, le mode applicable le plus proche est utilisé : les couches spatiales sont forcées à 1, tout en conservant la dimension temporelle (par exemple, L2T2 → L1T2 lorsque VP8 est négocié).

Le passeur effectue la passe OpenTokException si le mode demandé n'est pas un mode d'évolutivité valide (c'est-à-dire s'il ne s'agit pas de L1T1, L1T2, L1T3, L2T1, L2T2, L2T3, L3T1, L3T2 ou L3T3).

Le getter renvoie la dernière valeur transmise au setter, ou null si aucune valeur n'a été explicitement définie. Cela reflète l'intention de l'utilisateur, et non le mode réellement appliqué (qui peut différer en raison d'une solution de repli dépendante du codec).

Il s'agit d'une fonctionnalité en version bêta.

Préréglage du débit binaire vidéo

La stratégie de préréglage du débit binaire vidéo appliquée au flux vidéo de l'éditeur.

Cette propriété permet de configurer une stratégie de débit binaire prédéfinie afin d'équilibrer la qualité vidéo et l'utilisation de la bande passante. Les configurations prédéfinies et les réglages manuels du débit binaire s'excluent mutuellement. La définition de la propriété `MaxVideoBitrate` remplace tout préréglage et modifie automatiquement cette propriété pour qu'elle prenne la valeur VideoBitratePreset.Custom.

La lecture de cette propriété renvoie le préréglage actuellement actif. Si un débit binaire personnalisé a été défini manuellement, la valeur sera VideoBitratePreset.Custom.

La valeur par défaut est VideoBitratePreset.Default.

Note : Le VideoBitratePreset.Custom Cette valeur ne peut pas être définie directement.

Pour plus de détails, voir Publisher Max Bitrate.

Documentation relative à l'événement

Changement d'état du réseau

Se produit lorsque des changements dans l'état du réseau sont détectés du côté de l'éditeur.

Cet événement est déclenché lorsque des changements significatifs surviennent dans l'état du réseau ; il fournit des statistiques sur les liaisons de transmission ainsi que la raison de ce changement.

Vidéo désactivée

Appelée lorsque l'éditeur cesse de diffuser la vidéo.

Vérifier le reason propriété des arguments d'événement indiquant la raison pour laquelle la vidéo s'est arrêtée.

VideoDisableWarning

Cette méthode est appelée lorsque l'éditeur constate que le niveau de congestion du réseau s'est détérioré et que la vidéo sera désactivée si la congestion continue de s'aggraver.

Si la qualité du réseau continue de se dégrader, le Éditeur désactive la vidéo et envoie le message « AudioFallback ». Si la qualité du flux s'améliore, le Éditeur déclenche l'événement VideoDisableWarningLifted.

Cette méthode est principalement appelée lorsque la qualité de la connexion se détériore.

Avertissement concernant la désactivation de la vidéo levé

Cette méthode est appelée lorsque l'éditeur constate que le niveau de congestion du réseau s'est amélioré au point que la vidéo en cours de désactivation ne présente plus de risque immédiat.

Cette méthode est principalement appelée lorsque la qualité de la connexion s'améliore.

Vidéo activée

Appelée lorsque le flux vidéo de l'éditeur reprend (après une interruption de la vidéo).

Vérifier le reason propriété des arguments d'événement indiquant la raison pour laquelle la vidéo a été activée.

Changement de qualité vidéo

Se produit lorsqu'un changement intervient dans l'état de qualité du flux vidéo de l'éditeur.

Cet événement fournit des statistiques vidéo actualisées ainsi qu'un code de motif indiquant la raison pour laquelle ce changement de qualité s'est produit.

Les VideoReason Cette valeur indique la cause de l'événement et respecte l'ordre de priorité suivant : dégradation de la bande passante, dégradation des performances du processeur, autres causes de dégradation de la qualité, changements de codec et changements de résolution ou de couche.

Cet événement diffère de celui de Vidéo désactivée et Vidéo activée événements, dans la mesure où il signale des changements liés à la qualité plutôt que de simples changements d'état (activé/désactivé). Le Vidéo désactivée et Vidéo activée Ces événements indiquent quand la piste vidéo de l'éditeur est désactivée ou activée (par exemple, en raison d'un basculement audio ou de mises à jour des propriétés du flux). En revanche, Changement de qualité vidéo fournit des informations de diagnostic sur les causes de la dégradation de la qualité — telles que les limitations du processeur ou de la bande passante — et peut être générée même lorsque la vidéo reste activée.

Les applications peuvent utiliser cet événement pour surveiller la qualité vidéo et réagir en conséquence, par exemple en mettant à jour les indicateurs de l'interface utilisateur ou en signalant aux utilisateurs les problèmes de performances.