Method: spaces.connectActiveConference

<00x0A>

Pośredniczyć w nawiązywaniu połączenia WebRTC z aktywną konferencją w pokoju.

Po pomyślnym zakończeniu tego procesu klienty muszą użyć uzyskanej odpowiedzi SDP (Session Description Protocol) do nawiązania połączenia WebRTC. Po nawiązaniu połączenia dodatkowe funkcje są dostępne w kanałach danych WebRTC.

Więcej informacji o tym połączeniu znajdziesz w artykule Omówienie interfejsu Meet Media API.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa zasobu pokoju. Format: spaces/{spaceId}

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "offer": string,
  "config": {
    object (ConnectionConfig)
  }
}
Pola
offer

string

Wymagane. Oferta WebRTC SDP (Session Description Protocol) od klienta.

Format jest zdefiniowany w dokumencie RFC 8866, a klucze obowiązkowe w dokumencie RFC 8829. Jest to standardowy format SDP wygenerowany przez metody createOffer() i createAnswer() połączenia równorzędnego.
config

object (ConnectionConfig)

Opcjonalnie: Dodatkowe opcje konfiguracji sesji interfejsu Media API. Jeśli nie jest ustawiona, dla sesji zostaną podane wartości domyślne.

Treść odpowiedzi

Odpowiedź metody spaces.connectActiveConference.

Odpowiedź informująca o powodzeniu nie oznacza, że spotkanie zostało w pełni dołączone. Musi nastąpić dalsza komunikacja za pomocą WebRTC.

Więcej informacji o tym połączeniu znajdziesz w artykule Omówienie interfejsu Meet Media API.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "answer": string,
  "traceId": string
}
Pola
answer

string

Odpowiedź SDP WebRTC na ofertę.
traceId

string

Identyfikator śledzenia na potrzeby debugowania. Podaj tę wartość podczas zgłaszania błędów.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • 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

Więcej informacji znajdziesz w przewodniku po autoryzacji.

ConnectionConfig

Dodatkowe opcje konfiguracji sesji interfejsu Media API.

Zapis JSON 
{
  "confirmationTimeout": string
}
Pola
confirmationTimeout

string (Duration format)

Opcjonalnie: Czas oczekiwania przed anulowaniem działania potwierdzającego. Jeśli nie zostanie określona, zostanie użyta wartość domyślna. Czas trwania nie może przekraczać 5 minut. Dłuższe limity czasu i ujemne czasy trwania spowodują błąd RPC.