Permet de lire un flux audio-vidéo dans le cadre d'une session de la Video API. En savoir plus...

Hérite de l'interface IDisposable.

Description détaillée

Permet de lire un flux audio-vidéo dans le cadre d'une session de la Video API.

Utiliser le Subscriber.Builder classe pour créer un Abonné par exemple. Les abonnés peuvent se connecter pour recevoir des contenus multimédias lorsque vous appelez le Session.Subscribe(Subscriber) méthode.

Les Abonné La classe implémente l'interface System.IDisposable. Veillez à appeler la méthode Dispose() de la méthode Abonné objet doit libérer ses ressources lorsque vous n'en avez plus besoin (par exemple, lorsque le Abonné lorsque la lecture de la vidéo s'arrête 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

GetRtcStatsReport()

Récupère le rapport statistique RTC de l'abonné. 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 Publisher.GetRtcStatsReport().

Documentation relative aux biens immobiliers

Volume audio

Le volume sonore de l'abonné.

Le volume audio de l'abonné, compris entre 0 et 100. Lors de la définition de cette valeur, si celle-ci ne se situe pas dans cette plage, elle sera limitée à cette plage.

La valeur par défaut est 100.

LégendesTraductionLangue

Langue de traduction des sous-titres préférée par cet abonné.

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

Ce paramètre ne s'applique que lorsque les sous-titres sont activés. Définissez-le sur un code de langue BCP-47 pris en charge pour recevoir des sous-titres traduits, ou null pour désactiver la traduction. La valeur par défaut est null (aucune traduction configurée).

Les codes de langues pris en charge sont définis dans la spécification de l'API du serveur.

Fréquence d'images recommandée

La fréquence d'images souhaitée pour le flux de l'abonné.

Limitation de la fréquence d'images et de la résolution vidéo (Résolution souhaitée) réduit la charge réseau et l'utilisation du processeur sur le client abonné. Vous pouvez choisir d'utiliser une résolution inférieure en fonction des dimensions de la vidéo de l'abonné dans l'application. Vous pouvez également opter pour une fréquence d'images ou une résolution inférieure pour les abonnés à un flux moins important (et plus petit) que les autres flux.

Cette propriété ne s'applique que lors de l'abonnement à un flux utilisant la balise fonctionnalité vidéo adaptative. La vidéo adaptative est disponible :

• Uniquement dans les sessions qui utilisent le routeur multimédia de la Video API Vonage (sessions avec le mode média sur routé).
• Uniquement pour les flux publiés par des clients prenant en charge la vidéo évolutive (voir la documentation relative à la fonctionnalité vidéo adaptative).

Dans les flux qui n'utilisent pas la vidéo adaptative, la configuration de cette propriété n'a aucun effet.

Remarque : La fréquence d'images des flux vidéo adaptatifs s'ajuste automatiquement pour chaque abonné, en fonction des conditions du réseau et de l'utilisation du processeur, même si vous ne configurez pas cette propriété. Configurez cette propriété si vous souhaitez définir une fréquence d'images maximale pour cet abonné.

Les fréquences d'images disponibles dépendent de la fréquence d'images maximale disponible pour le flux. Lorsque vous définissez la fréquence d'images souhaitée pour l'abonné, le SDK Windows de la Video API sélectionne la meilleure fréquence d'images disponible qui se rapproche le plus de la fréquence souhaitée, en fonction de la bande passante du client et des contraintes liées au processeur.

Les fréquences d'images réelles disponibles dépendent, de manière dynamique, des ressources réseau et CPU dont dispose l'éditeur.

Résolution souhaitée

La résolution souhaitée pour le flux de l'abonné.

La résolution souhaitée pour le flux de l'abonné.

Limiter la résolution vidéo et la fréquence d'images (Fréquence d'images recommandée) réduit la charge réseau et l'utilisation du processeur sur le client abonné. Vous pouvez choisir d'utiliser une résolution inférieure en fonction des dimensions de la vidéo de l'abonné dans l'application. Vous pouvez également opter pour une fréquence d'images ou une résolution inférieure pour les abonnés à un flux moins important (et plus petit) que les autres flux.

Cette propriété ne s'applique que lors de l'abonnement à un flux utilisant la balise fonctionnalité vidéo adaptative. La vidéo adaptative est disponible :

• Uniquement dans les sessions qui utilisent le routeur multimédia de la Video API Vonage (sessions avec le mode média sur routé).
• Uniquement pour les flux publiés par des clients prenant en charge la vidéo évolutive (voir la documentation relative à la fonctionnalité vidéo adaptative).

Dans les flux qui n'utilisent pas la vidéo adaptative, la configuration de cette propriété n'a aucun effet.

Remarque : La résolution des flux vidéo adaptatifs s'ajuste automatiquement pour chaque abonné, en fonction des conditions du réseau et de l'utilisation du processeur, même si vous ne configurez pas cette propriété. Configurez cette propriété si vous souhaitez définir une résolution maximale pour cet abonné.

Toutes les résolutions ne sont pas disponibles pour un abonné. Lorsque vous définissez la résolution souhaitée, le SDK Windows de la Video API sélectionne la meilleure résolution disponible qui correspond à vos contraintes. Les résolutions disponibles dépendent de la largeur et de la hauteur maximales que Éditeur ensembles pour le flux, qui sont renvoyés par la fonction Stream.Width et Stream.Height les propriétés de la Flux objet. Chacune des résolutions disponibles pour un flux utilisera le même format d'image.

VideoRenderer

Le moteur de rendu vidéo utilisé par cet abonné.

Définissez le moteur de rendu vidéo en lui transmettant le VideoRenderer lors de l'appel du constructeur Subscriber(Context, Stream, IVideoRenderer).

Documentation relative à l'événement

Changement d'état du réseau

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

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.

Connexion interrompue

Appelée lorsque le flux de l'abonné a été interrompu.

Lorsque cette méthode est appelée, vous pouvez afficher une notification dans l'interface utilisateur afin d'informer l'utilisateur que le flux audio-vidéo est temporairement déconnecté et que l'application tente de se reconnecter au flux.

Si le client se reconnecte au flux, les abonnés envoient le Reconnexion au flux événement. Sinon, le Session L'objet envoie le Session.StreamDropped événement.

Reconnexion au flux

Envoyé lorsque le flux de l'abonné reprend (après une déconnexion temporaire).

Les Abonné déclenche cet événement après avoir envoyé le Connexion interrompue événement.

Vidéo désactivée

Appelée lorsque l'abonné ne reçoit plus de flux 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

Appelée lorsque le routeur multimédia de la Video API détecte une dégradation de la qualité du flux et que la vidéo sera désactivée si cette dégradation se poursuit.

Si la qualité continue de se dégrader, l'abonné désactive la vidéo et le Abonné envoie le message « VideoDisabled ». Si la qualité du flux s'améliore, le Abonné déclenche l'événement VideoDisableWarningLifted.

Cette fonctionnalité n'est disponible que dans les sessions utilisant le routeur multimédia de la Video API Vonage (sessions dont le mode multimédia est défini sur « routed »), et non dans celles dont le mode multimédia est défini sur « relayed ». (Voir Le routeur multimédia OpenTok et les modes multimédias).

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é

Appelée lorsque le routeur multimédia de la Video API Vonage constate que la qualité du flux s'est suffisamment améliorée pour que la désactivation de la vidéo ne présente plus de risque immédiat.

Cette fonctionnalité n'est disponible que dans les sessions utilisant le routeur multimédia de la Video API Vonage (sessions dont le mode multimédia est défini sur « routed »), et non dans celles dont le mode multimédia est défini sur « relayed ». (Voir Le routeur multimédia OpenTok et les modes multimédias).

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'abonné démarre (alors qu'il n'y avait auparavant pas de vidéo) ou 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 événement lié à la qualité est détecté du côté de l'abonné.

Cet événement est déclenché lorsque des changements significatifs de qualité surviennent dans le flux vidéo de l'abonné, tels qu'une interruption vidéo détectée (pause) ou un changement de codec.

Dans l'implémentation actuelle, cet événement n'est déclenché qu'en cas d'interruptions vidéo ou de changements de codec. Les blocages sont suivis en interne et pris en compte dans les statistiques, mais ne déclenchent pas cet événement individuellement en raison de leur courte durée et de leur fréquence élevée. Un rappel n'est déclenché que lorsqu'une pause (absence d'image affichée pendant plus de 5 secondes) est détectée, car elle représente une perturbation plus importante de la lecture.

Les VideoReason Cette valeur indique la cause de l'événement et respecte l'ordre de priorité suivant : VideoInterruption, CodecChange.

Cet événement diffère de Vidéo désactivée et Vidéo activée en ce sens qu’il signale des changements liés à la qualité plutôt que de simples transitions entre l’activation et la désactivation de la piste. Le Vidéo désactivée et Vidéo activée Les événements indiquent quand la piste vidéo de l'abonné a été désactivée ou réactivée (par exemple, en raison d'un basculement audio ou de mises à jour des propriétés du flux). En revanche, cet événement fournit des informations de diagnostic sur les causes de dégradation de la qualité, telles que les blocages, le nombre de pauses et les statistiques vidéo mises à jour.

Cet événement prend en compte toute interruption vidéo d'une durée de cinq secondes ou plus. Dans des cas tels que le basculement vers l'audio ou la désactivation de la vidéo, l'interruption est également enregistrée comme une pause dans les statistiques, et un événement correspondant à un changement de qualité peut être déclenché.

Les applications peuvent utiliser cet événement pour gérer les problèmes de qualité, par exemple en mettant à jour les indicateurs de l'interface utilisateur, en enregistrant des données de télémétrie ou en avertissant les utilisateurs.