Method: spaces.connectActiveConference

التوسّط في اتصال WebRTC بالمكالمة النشطة في مساحة

في حال نجاح العملية، يجب أن يستخدم العملاء إجابة بروتوكول وصف الجلسة (SDP) الناتجة لإنشاء اتصال WebRTC. بعد الاتصال، تتوفّر وظائف إضافية في قنوات بيانات WebRTC.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
name

string

مطلوب. اسم المورد للمساحة التنسيق: spaces/{spaceId}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "offer": string
}
الحقول
offer

string

مطلوب. عرض WebRTC SDP (بروتوكول وصف الجلسة) من العميل

يتم تحديد التنسيق من خلال RFC 8866 باستخدام مفاتيح إلزامية محدّدة من خلال RFC 8829. هذا هو تنسيق SDP العادي الذي يتم إنشاؤه من خلال الطريقتَين createOffer() وcreateAnswer() لربط الأجهزة المشابهة.

نص الاستجابة

استجابة طريقة spaces.connectActiveConference

لا تشير استجابة النجاح إلى الانضمام الكامل إلى الاجتماع، بل يجب إجراء المزيد من الاتصالات عبر WebRTC.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "answer": string,
  "traceId": string
}
الحقول
answer

string

استجابة WebRTC SDP للعرض
traceId

string

معرّف التتبّع لأغراض تصحيح الأخطاء يُرجى تضمين هذه القيمة عند الإبلاغ عن الأخطاء.

نطاقات التفويض

يتطلب أحد نطاقات 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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.