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), sa fréquence d'images (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 des vidéos, les clients envoient d'abord une requête 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 "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 respectant au mieux les paramètres du canevas.

Si le nombre de participants à une conférence dépasse le nombre de CSR, 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 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 de SSRCs de manière déterministe. Par exemple, ne partez pas du principe que le premier CSRS est le participant "le plus pertinent".

  • Les clients ne doivent pas demander une résolution supérieure à celle dont ils ont besoin. Par exemple, ne demandez pas de vidéo en 1080p si votre modèle n'utilise que du 480p.

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

  • Les clients ne doivent pas envoyer de demandes d'attribution de vidéo excessives. Ces demandes seront limitées ou ignorées.