Method: spaces.connectActiveConference

Menengahi koneksi WebRTC ke konferensi aktif ruang.

Jika berhasil, klien harus menggunakan jawaban SDP (Session Description Protocol) yang dihasilkan untuk membuat koneksi WebRTC. Setelah terhubung, fungsi tambahan tersedia di seluruh saluran data WebRTC.

Lihat Ringkasan Meet Media API untuk mengetahui detail selengkapnya tentang koneksi ini.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama resource ruang. Format: spaces/{spaceId}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "offer": string,
  "config": {
    object (ConnectionConfig)
  }
}
Kolom
offer

string

Wajib. Penawaran SDP (Session Description Protocol) WebRTC dari klien.

Format ditentukan oleh RFC 8866 dengan kunci wajib yang ditentukan oleh RFC 8829. Ini adalah format SDP standar yang dihasilkan oleh metode createOffer() dan createAnswer() koneksi peer.

config

object (ConnectionConfig)

Opsional. Opsi konfigurasi tambahan untuk sesi Media API. Jika tidak disetel, nilai default akan diberikan untuk sesi.

Isi respons

Respons metode spaces.connectActiveConference.

Respons keberhasilan tidak menunjukkan bahwa rapat telah diikuti sepenuhnya; komunikasi lebih lanjut harus dilakukan melalui WebRTC.

Lihat Ringkasan Meet Media API untuk mengetahui detail selengkapnya tentang koneksi ini.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "answer": string,
  "traceId": string
}
Kolom
answer

string

Jawaban SDP WebRTC untuk penawaran.

traceId

string

ID rekaman aktivitas untuk tujuan pen-debug-an. Sertakan nilai ini saat melaporkan bug.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • 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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

ConnectionConfig

Opsi konfigurasi tambahan untuk sesi Media API.

Representasi JSON
{
  "confirmationTimeout": string
}
Kolom
confirmationTimeout

string (Duration format)

Opsional. Jumlah waktu yang harus ditunggu sebelum tindakan konfirmasi dibatalkan. Jika tidak disetel, nilai default akan digunakan. Durasi tidak boleh melebihi 5 menit. Waktu tunggu yang lebih besar dan durasi negatif akan menyebabkan kegagalan RPC.