Method: spaces.connectActiveConference

किसी स्पेस की चालू कॉन्फ़्रेंस से WebRTC कनेक्शन को ब्रोक करें.

कनेक्शन बन जाने के बाद, क्लाइंट को WebRTC कनेक्शन बनाने के लिए, एसडीपी (सेशन डिस्क्रिप्शन प्रोटोकॉल) के जवाब का इस्तेमाल करना होगा. कनेक्ट होने के बाद, WebRTC डेटा चैनलों पर अतिरिक्त सुविधाएं उपलब्ध होती हैं.

इस कनेक्शन के बारे में ज़्यादा जानने के लिए, Meet Media API की खास जानकारी देखें.

एचटीटीपी अनुरोध

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. स्पेस का संसाधन नाम. फ़ॉर्मैट: spaces/{spaceId}

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "offer": string,
  "config": {
    object (ConnectionConfig)
  }
}
फ़ील्ड
offer

string

ज़रूरी है. क्लाइंट से मिला WebRTC SDP (सेशन डिस्क्रिप्शन प्रोटोकॉल) ऑफ़र.

इस फ़ॉर्मैट को आरएफ़सी 8866 में तय किया गया है. साथ ही, ज़रूरी कुंजियों को आरएफ़सी 8829 में तय किया गया है. यह स्टैंडर्ड एसडीपी फ़ॉर्मैट है. इसे पीयर कनेक्शन के createOffer() और createAnswer() तरीकों से जनरेट किया जाता है.
config

object (ConnectionConfig)

ज़रूरी नहीं. Media API सेशन के लिए, कॉन्फ़िगरेशन के अतिरिक्त विकल्प. अगर यह नीति सेट नहीं है, तो सेशन के लिए डिफ़ॉल्ट वैल्यू दी जाएंगी.

जवाब का मुख्य भाग

spaces.connectActiveConference तरीके का जवाब.

सफलता का जवाब मिलने का मतलब यह नहीं है कि मीटिंग में पूरी तरह से शामिल हो गया गया है. WebRTC के ज़रिए आगे की बातचीत होनी चाहिए.

इस कनेक्शन के बारे में ज़्यादा जानने के लिए, Meet Media API की खास जानकारी देखें.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

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

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.

ConnectionConfig

Media API सेशन के लिए, कॉन्फ़िगरेशन के अतिरिक्त विकल्प.

JSON के काेड में दिखाना 
{
  "confirmationTimeout": string
}
फ़ील्ड
confirmationTimeout

string (Duration format)

ज़रूरी नहीं. पुष्टि करने की कार्रवाई रद्द होने से पहले इंतज़ार करने का समय. अगर यह नीति सेट नहीं की गई है, तो डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाएगा. अवधि पांच मिनट से ज़्यादा नहीं होनी चाहिए. टाइम आउट की अवधि ज़्यादा होने और अवधि की वैल्यू नेगेटिव होने पर, आरपीसी फ़ेल हो जाएगी.