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

Une fois connecté à une conférence, tout contenu audio demandé est immédiatement transmis et disponible. Toutefois, pour recevoir des vidéos, 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. Ils spécifient sa résolution en pixels (par exemple, 1280 x 720), les images par seconde (FPS) et sélectionnent 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 demande d'attribution vidéo  sur le canal de données VideoAssignment, en définissant des canevas pour les flux vidéo négociés.

Envoyez une demande d'attribution de vidéo via le canal de données d'attribution de vidéo.
Figure 1 : Envoyez une demande d'attribution de vidéo via le canal de données d'attribution de vidéo.

Une fois que Meet reçoit la demande, il commence à sélectionner les vidéos des participants "pertinents" en fonction de facteurs tels que :

  • Le participant parle-t-il ?
  • Le participant est-il en train de faire 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 respectant au mieux les paramètres du canevas.

Si le nombre de participants à une conférence dépasse le nombre de CSR, Meet remplacera progressivement les flux 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 demande d'attribution de vidéo, il envoie une mise à jour de ressource sur le canal de données VideoAssignment. Cette mise à jour inclut le mappage SSRC vers le canevas. Grâce à ce mappage, les clients peuvent identifier la résolution et la fréquence d'images du flux vidéo pour chaque SSRC. À l'inverse, le client sait quel SSRC utiliser lorsqu'il recherche une résolution et une fréquence d'images 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écide de l'association entre le SSRC et le canevas. Le client ne le spécifie pas dans la requête.

  • Meet n'attribue pas les SSRC de manière déterministe. 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 supérieure à leurs besoins. Par exemple, ne demandez pas une vidéo en 1080p si votre modèle n'utilise que le format 480p.

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

  • Les clients ne doivent pas envoyer un nombre excessif de demandes d'attribution de vidéos. Ces demandes seront limitées ou ignorées.