इस पेज पर, उन क्लाइंट ऑब्जेक्ट को मैनेज करने का तरीका बताया गया है जिनके ज़रिए ऐड-ऑन, Google Meet से कम्यूनिकेट करता है.
सबसे पहले, ऐड-ऑन को एक सेशन शुरू करना होगा:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
CLOUD_PROJECT_NUMBER की जगह, अपने Google Cloud प्रोजेक्ट का प्रोजेक्ट नंबर डालें.
सेशन से दो क्लाइंट ऑब्जेक्ट बनाए जा सकते हैं:
MeetMainStageClient
यह मुख्य स्टेज में चल रहे ऐड-ऑन के लिए होता है. इसेawait session.createMainStageClient()
का इस्तेमाल करके वापस पाया जा सकता है.MeetSidePanelClient
, साइड पैनल में चल रहे ऐड-ऑन के लिए है. इसेawait session.createSidePanelClient()
का इस्तेमाल करके वापस पाया जा सकता है.
मुख्य स्टेज या साइड पैनल के लिए, सही क्लाइंट ऑब्जेक्ट को वापस पाना ज़रूरी है. अगर गलत क्लाइंट को वापस लाया जाता है, तो Google Meet add-ons SDK टूल एक अपवाद दिखाता है. यह देखने के लिए कि ऐड-ऑन किस iframe (मुख्य स्टेज या साइड पैनल) में चल रहा है, getFrameType()
तरीके का इस्तेमाल करें.
यहां दिए गए कोड के सैंपल में, मुख्य स्टेज के क्लाइंट ऑब्जेक्ट को इंस्टैंशिएट करने का तरीका बताया गया है:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER"
});
const mainStageClient = await session.createMainStageClient();
CLOUD_PROJECT_NUMBER की जगह अपने Cloud प्रोजेक्ट का प्रोजेक्ट नंबर डालें.
शेयर की गई सुविधाएं
कुछ सुविधाएं, MeetMainStageClient
और MeetSidePanelClient
, दोनों ऑब्जेक्ट में उपलब्ध होती हैं. वहीं, कुछ सुविधाएं किसी खास क्लाइंट के लिए होती हैं.
उदाहरण के लिए, दोनों क्लाइंट में उपलब्ध कुछ सुविधाएं:
getActivityStartingState()
यह वह तरीका है जिससे ऐड-ऑन की शुरुआती स्थिति के बारे में जानकारी मिलती है. यह जानकारी तब मिलती है, जब गतिविधि में शामिल होने के लिए न्योता स्वीकार किया जाता है.getMeetingInfo()
यह तरीका, उस मीटिंग के बारे में जानकारी देता है जिसमें ऐड-ऑन चल रहा है.setActivityStartingState()
यह ऐसा तरीका है जो ऐड-ऑन की शुरुआती स्थिति सेट करता है. ऐसा तब होता है, जब मीटिंग में शामिल होने वाला कोई व्यक्ति, गतिविधि में शामिल होने का न्योता स्वीकार करता है.- दोनों क्लाइंट में मौजूद सुविधाओं की पूरी सूची देखने के लिए,
MeetAddonClient
ऑब्जेक्ट देखें.
क्लाइंट के हिसाब से सुविधाएं
सिर्फ़ MeetMainStageClient
ऑब्जेक्ट में उपलब्ध सुविधाएं:
notifySidePanel()
मेथड, साइड पैनल को मैसेज भेजता है. साइड पैनल मेंframeToFrameMessage
कॉल बैक को सब्सक्राइब करके, मैसेज पाया जा सकता है.loadSidePanel()
तरीके से, साइड-पैनल iframe खुलता है. iframe के सोर्स को मेनिफ़ेस्ट फ़ाइल से साइड-पैनल यूआरएल पर सेट किया जाता है.unloadSidePanel()
मेथड, साइड पैनल वाले iframe को बंद करता है. इस तरीके को कॉल करने पर, Meet में ऐड-ऑन की स्थिति सेव नहीं होती. इस तरीके को कॉल करने से पहले, ऐड-ऑन की किसी भी स्थिति को बनाए रखने की ज़िम्मेदारी ऐड-ऑन की होती है.
सिर्फ़ MeetSidePanelClient
ऑब्जेक्ट में उपलब्ध सुविधाएं:
notifyMainStage()
मेथड, mainStage को एक मैसेज भेजता है. इस मैसेज को पाने के लिए, आपको मुख्य स्टेज परframeToFrameMessage
कॉलबैक प्रॉपर्टी की सदस्यता लेनी होगी.