Partager:
){kind=small}
Michael est le bâtisseur chauve et barbu. Fort de ses 20 ans d'expérience dans le développement de logiciels et DevOps, ce développeur aux prises avec des difficultés folliculaires passe ses journées à aider les autres à réussir.
Intégrer des informations avancées pour contrôler la qualité des vidéos
Temps de lecture : 6 minutes
Santé. Éducation. Collaboration. Il y a fort à parier que vous communiquez de plus en plus souvent par vidéoconférence en ligne. Les minutes utilisées par les clients de l'API Video de Vonage ont augmenté de 232 % rien qu'entre février et mars. Dans le secteur des soins de santé, les minutes de vidéo ont augmenté de 727 %.
Avec cette augmentation de la charge, il est plus important que jamais de savoir quel type de qualité de service vous fournissez à vos clients. Les élèves de M. Pates peuvent-ils voir et entendre clairement leurs cours ? Le Dr Sanchez est-elle en mesure de fournir à ses patients la qualité de soins dont ils ont besoin ? S'ils rencontrent des problèmes, vous devez avoir des réponses.
C'est pourquoi Vonage a créé les API Insights et Advanced Insights API. Ces API GraphQL vous aident à élaborer des solutions évolutives et fiables pour vos utilisateurs finaux, mais il est important de savoir quelles données sont fournies, quand elles sont disponibles et pendant combien de temps elles sont accessibles.
L'API Insights vous permet d'explorer les métadonnées de vos sessions au niveau du projet. Ces métadonnées comprennent des mesures telles que :
Utilisation : Informations sur les minutes de flux publiées, les minutes de flux souscrites, l'utilisation des archives, l'utilisation de la diffusion et l'utilisation du protocole SIP.
Qualité : Informations sur la qualité de la Video
Erreurs : Taux d'échec de la connexion aux sessions, de la publication et de l'abonnement.
Example GraphQL code used with the Insights API
L'API vous permet de filtrer et de regrouper les données par type de SDK, version du SDK, pays, région, navigateur, version du navigateur et, en outre, de segmenter les données à intervalles quotidiens, hebdomadaires ou mensuels.
Les données Insights sont agrégées quotidiennement au niveau du projet. Pour cette raison, elles ne sont pas disponibles en temps réel. Les données de l'API Insights sont disponibles dans un délai de 36 à 48 heures.
Timeline displaying retention spans of the Insights API
Pendant 60 jours, les données Insights sont disponibles sous forme d'agrégats quotidiens. Au-delà, et jusqu'à 12 mois, elles sont disponibles sous forme d'agrégats mensuels. Après 12 mois, les données ne sont pas conservées par l'API Insights.
L'API Advanced Insights fournit des données au niveau de la session et du flux. Les sessions sont divisées en réunions et chaque session peut être composée de plusieurs réunions. Une nouvelle réunion est créée lorsque quelqu'un rejoint la session et qu'il n'y a pas eu de participants pendant les 10 minutes précédentes.
Les données de la session comprennent
Métadonnées : Mode média, minutes publiées et minutes souscrites
Réunions : Un tableau de toutes les réunions qui ont eu lieu pendant la période spécifiée pour cette session. Il comprend :
Connexions : Tableau de connexions définissant chaque client ayant rejoint la session pendant la réunion. Il comprend le SDK utilisé, le navigateur utilisé, des informations sur les éditeurs/abonnés, etc.
Métadonnées : Procès-verbaux publiés, procès-verbaux souscrits, date de création et de destruction de la réunion.
Éditeurs : Un tableau des éditeurs présents lors de la réunion. Il comprend des données sur leurs flux, leurs abonnés et leurs statistiques de flux.
Abonnés : Tableau des abonnés présents lors de la réunion. Il comprend des informations sur le flux et les statistiques du flux de l'abonné.
Example GraphQL query for the Advanced Insights API
La puissance d'Advanced Insights réside dans les statistiques en cours de diffusion. Ces données comprennent des instantanés de 30 secondes de la latence audio et vidéo, du débit, du taux de perte de paquets et des codecs. Elles comprennent également des informations sur la résolution vidéo et indiquent si un flux comprenait de l'audio et/ou de la vidéo au moment de l'instantané.
Grâce à ces informations, vous pouvez examiner l'ensemble de l'expérience de l'utilisateur en termes de qualité du flux et comparer ces données en fonction de paramètres tels que le SDK, le navigateur, l'heure de la journée et bien d'autres encore. Grâce à ce niveau de connaissance, vous pouvez optimiser vos Applications à travers les plateformes pour garantir à vos clients la meilleure expérience possible.
Les données d'Advanced Insights sont disponibles pendant 21 jours. La période de conservation est basée sur l'heure de création d'une réunion au sein d'une session. La latence de disponibilité des données est de 5 minutes à partir de la fin de la réunion.
Timeline displaying retention spans of the Advanced Insights API
Pendant les périodes de maintenance de notre base de données, il se peut que les données d'Advanced Insights ne soient pas accessibles. Toutes les données seront rétablies peu après la période de maintenance spécifiée.
| Day | Time | Data Available By | |
|---|---|---|---|
| Daily database maintenance | Monday - Sunday | 9pm - 11pm PT | 11:30pm PT |
| Weekly database maintenance | Sunday | 4am - 7am PT | 8am PT |
Dans de nombreux cas, vous souhaiterez conserver l'accès à vos données Insights et Advanced Insights plus longtemps que ne le prévoient nos politiques de conservation. Que vous utilisiez des fonctions sans serveur ou des tâches programmées, vous devrez interroger les points d'extrémité de l'API à intervalles réguliers pour récupérer et charger les données dans votre base de données. Le stockage à long terme de ces données dans la base de données de votre choix vous permet de fournir en toute transparence des informations à votre équipe et/ou à vos clients et de comparer les mesures sur des périodes plus longues.
N'oubliez pas que les données des deux API sont agrégées à l'heure du Pacifique. Veillez donc à prendre en compte tout décalage horaire lorsque vous déterminez l'heure à laquelle vous devez exécuter vos requêtes.
L'API Insights étant agrégée quotidiennement, vous ne devriez pas l'interroger plus d'une fois par jour. Il suffit d'interroger et de stocker ces données chaque jour, voire tous les deux jours.
Les données Advanced Insights relatives à une réunion sont disponibles 5 minutes après la fin de la réunion. Le moment approprié pour interroger ces données dépend de la nécessité pour vos Applications de disposer de données en temps quasi réel. Veillez à tenir compte des périodes de maintenance de la base de données Advanced Insights spécifiées ci-dessus.
Avec les données Insights et Advanced Insights à portée de main, vous serez en mesure d'identifier les tendances dans les plateformes des clients, les navigateurs et de permettre à votre équipe d'identifier les problèmes de perte de paquets, de débits binaires des utilisateurs et de latence en l'espace de quelques minutes. Pour en savoir plus sur les API Insights et Advanced Insights et sur la façon dont elles peuvent vous aider à prendre des décisions plus éclairées, consultez les liens ci-dessous :