WebRTC-Verbindung zur aktiven Konferenz eines Gruppenbereichs herstellen.
Bei Erfolg müssen Clients die resultierende SDP-Antwort (Session Description Protocol) verwenden, um eine WebRTC-Verbindung herzustellen. Nach der Verbindung sind zusätzliche Funktionen für WebRTC-Datenkanäle verfügbar.
HTTP-Anfrage
POST https://meet.googleapis.com/v2beta/{name=spaces/*}:connectActiveConference
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
name |
Erforderlich. Ressourcenname des Gruppenbereichs. Format: spaces/{spaceId} |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "offer": string } |
Felder | |
---|---|
offer |
Erforderlich. WebRTC-SDP-Angebot (Session Description Protocol) vom Client. Das Format ist in RFC 8866 definiert. Die Pflichtschlüssel sind in RFC 8829 definiert. Das ist das Standard-SDP-Format, das von den Methoden „createOffer()“ und „createAnswer()“ einer Peer-Verbindung generiert wird. |
Antworttext
Antwort der Methode „spaces.connectActiveConference“.
Eine erfolgreiche Antwort gibt nicht an, dass die Teilnahme am Meeting vollständig abgeschlossen ist. Die weitere Kommunikation muss über WebRTC erfolgen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "answer": string, "traceId": string } |
Felder | |
---|---|
answer |
WebRTC-SDP-Antwort auf das Angebot. |
trace |
Trace-ID für Debugging-Zwecke. Geben Sie diesen Wert an, wenn Sie Fehler melden. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Weitere Informationen finden Sie unter OAuth 2.0 Overview.