Method: spaces.connectActiveConference

Établir une connexion WebRTC à la conférence active d'un espace.

En cas de réussite, les clients doivent utiliser la réponse SDP (Session Description Protocol) obtenue pour établir une connexion WebRTC. Une fois la connexion établie, des fonctionnalités supplémentaires sont disponibles sur les canaux de données WebRTC.

Pour en savoir plus sur cette connexion, consultez la présentation de l'API Meet Media.

Requête HTTP

POST https://meet.googleapis.com/v2beta/{name=spaces/*}:connectActiveConference

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource de l'espace. Format : spaces/{spaceId}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "offer": string,
  "config": {
    object (ConnectionConfig)
  }
}
Champs
offer

string

Obligatoire. Offre SDP (Session Description Protocol) WebRTC du client.

Le format est défini par la RFC 8866, avec des clés obligatoires définies par la RFC 8829. Il s'agit du format SDP standard généré par les méthodes createOffer() et createAnswer() d'une connexion peer-to-peer.
config

object (ConnectionConfig)

Facultatif. Options de configuration supplémentaires pour une session Media API. Si elle n'est pas définie, des valeurs par défaut seront fournies pour la session.

Corps de la réponse

Réponse de la méthode spaces.connectActiveConference.

Une réponse positive n'indique pas que la réunion est entièrement rejointe. D'autres communications doivent avoir lieu via WebRTC.

Pour en savoir plus sur cette connexion, consultez la présentation de l'API Meet Media.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "answer": string,
  "traceId": string
}
Champs
answer

string

Réponse SDP WebRTC à l'offre.
traceId

string

ID de trace à des fins de débogage. Veuillez inclure cette valeur lorsque vous signalez des bugs.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/meetings.conference.media.readonly
  • https://www.googleapis.com/auth/meetings.conference.media.audio.readonly
  • https://www.googleapis.com/auth/meetings.conference.media.video.readonly

Pour en savoir plus, consultez le guide d'autorisation.

ConnectionConfig

Options de configuration supplémentaires pour les sessions Media API.

Représentation JSON 
{
  "confirmationTimeout": string
}
Champs
confirmationTimeout

string (Duration format)

Facultatif. Temps d'attente avant l'annulation d'une action de confirmation. Si elle n'est pas définie, une valeur par défaut sera utilisée. La durée ne peut pas dépasser cinq minutes. Des délais d'attente plus longs et des durées négatives entraîneront un échec du RPC.