Gérer l'attribution de vidéos dans l'API Meet Media

Une fois connecté à une conférence, tout audio requêté est immédiatement transmis et disponible. Toutefois, pour recevoir la vidéo, le client doit d'abord définir des canevas pour chaque flux vidéo.

Les canevas aident Meet à comprendre comment votre client consommera un flux vidéo, en spécifiant sa résolution en pixels (par exemple, 1 280 x 720), la fréquence d'images par seconde (FPS) et en sélectionnant un protocole d'attribution. Le protocole d'attribution spécifie comment Meet doit choisir les flux vidéo lorsqu'il y a plus de participants que de SSRC.

Demandes d'attribution de vidéos

Pour recevoir une vidéo, les clients envoient d'abord une requête d'attribution de vidéo sur le canal de données VideoAssignment, en définissant des canevas pour les flux vidéo négociés.

Envoyer une requête d'attribution de vidéo via le canal de données d'attribution de vidéo
Figure 1 : Envoyer une requête d'attribution de vidéo via le canal de données d'attribution de vidéo

Une fois que Meet a reçu la requête, il commence à sélectionner les vidéos des participants "pertinentes", en fonction de facteurs tels que:

  • Le participant parle-t-il ?
  • Le participant fait-il une présentation ?
  • Le participant partage-t-il son écran ?

Meet mappe ensuite les participants les plus pertinents aux SSRC vidéo disponibles et commence à transmettre la vidéo, en reproduisant les paramètres du canevas le plus fidèlement possible.

Si le nombre de participants à une conférence dépasse le nombre de SSRC, Meet remplacera les flux au fil du temps pour correspondre aux participants les plus pertinents.

Les serveurs Meet reçoivent les requêtes et attribuent les flux vidéo.
Figure 2. Les serveurs Meet reçoivent les requêtes et attribuent les flux vidéo.

Une fois que Meet a appliqué la requête d'attribution de vidéo, il envoie une mise à jour de ressource via le canal de données VideoAssignment. Cette mise à jour inclut la mise en correspondance SSRC-to-canvas. Grâce à ce mappage, les clients peuvent identifier la résolution et les FPS du flux vidéo pour chaque SSRC. À l'inverse, le client sait quel SSRC utiliser lorsqu'il recherche une résolution et un FPS spécifiques.

Envoyez la mise à jour de la ressource via le canal de données des devoirs vidéo.
Figure 3 Envoyez la mise à jour de la ressource via le canal de données des devoirs vidéo.

Remarques

  • Meet détermine l'association entre le SSRC et le canevas. Le client ne le spécifie pas dans la requête.

  • Meet n'attribue pas de manière déterministe les SSRC. Par exemple, ne partez pas du principe que le premier SSRC est le participant le plus pertinent.

  • Les clients ne doivent pas demander une résolution plus élevée que nécessaire. Par exemple, ne demandez pas de vidéo 1080p lorsque votre modèle n'utilise que 480p.

  • Il n'est pas toujours possible de trouver une résolution exacte.

  • Les clients ne doivent pas envoyer de demandes de devoirs vidéo excessives. Ils seront limités ou ignorés.