इस पेज पर बताया गया है कि साइड-पैनल iframe में चल रहे ऐड-ऑन से, क्लाइंट-साइड पर मैसेज कैसे भेजे जाते हैं. साथ ही, यह भी बताया गया है कि मुख्य स्टेज iframe में चल रहे ऐड-ऑन से क्लाइंट-साइड पर मैसेज कैसे भेजे जाते हैं. फ़्रेम-टू-फ़्रेम मैसेजिंग सिर्फ़ क्लाइंट साइड पर होती है. इसलिए, मैसेज तुरंत डिलीवर हो जाते हैं.
कोई मैसेज भेजने के लिए:
- साइड पैनल से मुख्य स्क्रीन पर ले जाने के लिए,
notifyMainStage()तरीके का इस्तेमाल करें.
await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
- मुख्य स्टेज से साइड पैनल पर ले जाने के लिए,
notifySidePanel()तरीके का इस्तेमाल करें.
await mainStageClient.notifySidePanel("YOUR_MESSAGE");
payload
की लंबाई, तय की गई साइज़ की सीमा के मुताबिक होनी चाहिए.
मैसेज पाने के लिए, ऐड-ऑन को frameToFrameMessage कॉलबैक की सदस्यता लेनी होगी. यहां दिए गए कोड सैंपल में, frameToFrameMessage कॉलबैक के लिए सदस्यता लेने का तरीका बताया गया है:
sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
// YOUR_CODE
});
GitHub पर मौजूद"ऐनिमेशन" सैंपल ऐड-ऑन में, फ़्रेम-टू-फ़्रेम मैसेजिंग का पूरा उदाहरण शामिल है. गतिविधि शुरू होने के बाद, जब भी उपयोगकर्ता कोई इनपुट बदलता है, तो साइड पैनल मुख्य स्टेज को सूचना देता है.
मुख्य स्टेज भी अपडेट की गई स्थिति पाने के लिए, frameToFrameMessage कॉलबैक की सदस्यता लेता है.
नोट
मीटिंग में शामिल किसी व्यक्ति के भेजे गए मैसेज, सिर्फ़ उसी व्यक्ति को दिखते हैं. मीटिंग में शामिल अन्य लोगों को मैसेज भेजने या उन्हें किसी ऐड-ऑन की स्थिति के बारे में बताने के लिए, ऐड-ऑन की स्थिति शेयर करने का तरीका जानें.
मैसेज को सिर्फ़ एक बार डिलीवर करने की कोशिश की जाती है. मैसेज पाने के लिए, मैसेज पाने वाले पैनल का खुला होना ज़रूरी है. साथ ही, मैसेज भेजे जाने से पहले, ऐप्लिकेशन को कॉलबैक के लिए सदस्यता लेनी होगी.