Meet ऐड-ऑन का इस्तेमाल करके, साथ मिलकर काम करना

मीटिंग में हिस्सा लेने वाले लोग, Google Meet ऐड-ऑन की किसी गतिविधि पर मिलकर काम कर सकते हैं. साथ मिलकर की जाने वाली कोई गतिविधि शुरू होने पर, मीटिंग में हिस्सा लेने वाले सभी लोगों को इसकी सूचना मिलती है.

यह सूचना, ऐड-ऑन की उपलब्धता और इंस्टॉल किए जाने की स्थिति के हिसाब से बदलती है:

  • अगर मीटिंग में हिस्सा लेने वाले व्यक्ति ने ऐड-ऑन इंस्टॉल किया है: वह गतिविधि में शामिल हो सकता है.

  • अगर मीटिंग में हिस्सा लेने वाले व्यक्ति ने ऐड-ऑन इंस्टॉल नहीं किया है: उसे ऐड-ऑन इंस्टॉल करने के लिए कहा जाता है.

  • अगर मीटिंग में हिस्सा लेने वाले व्यक्ति के प्लैटफ़ॉर्म के लिए ऐड-ऑन उपलब्ध नहीं है: उसे बताया जाता है कि वह अपने मौजूदा डिवाइस का इस्तेमाल करके, गतिविधि में शामिल नहीं हो सकता.

जब कोई उपयोगकर्ता गतिविधि में शामिल होता है, तो वह आपके ऐड-ऑन के कॉन्टेंट के साथ अपने iframe लोड करेगा. आपके पास यह तय करने का विकल्प होता है कि मीटिंग में शामिल होने वाले नए लोगों को, साथ मिलकर की जाने वाली गतिविधि मुख्य स्टेज में दिखे या साइड पैनल में.

गतिविधि शुरू करें

कोई गतिविधि शुरू करने के लिए, startActivity() तरीके को कॉल किया जाता है. यह तरीका, ActivityStartingState इंटरफ़ेस का इस्तेमाल करता है.

पहला चरण (ज़रूरी नहीं): ऐड-ऑन, गतिविधि की शुरुआती स्थिति सेट करता है

ActivityStartingState में, ऐड-ऑन की शुरुआती स्थिति के बारे में जानकारी होती है. इसका इस्तेमाल तब किया जाता है, जब मीटिंग में हिस्सा लेने वाला कोई व्यक्ति, गतिविधि में शामिल होने का न्योता स्वीकार करता है.

ऐड-ऑन, गतिविधि से पहले या उसके दौरान किसी भी समय setActivityStartingState() तरीके को कॉल करके, ActivityStartingState को सेट या अपडेट कर सकता है. अगर ActivityStartingState को खास तौर पर startActivity() को किए जाने वाले कॉल के लिए सेट किया गया है, तो setActivityStartingState() को किए जाने वाले कॉल को छोड़ा जा सकता है.

दूसरा चरण: ऐड-ऑन से गतिविधि शुरू करना

गतिविधि तब शुरू होती है, जब ऐड-ऑन MeetSidePanelClient पर startActivity() तरीके को कॉल करता है. startActivity() वाला तरीका, ActivityStartingState ऑब्जेक्ट को पैरामीटर के तौर पर लेता है. इसलिए, setActivityStartingState() को कॉल करने के बजाय, startActivity() को कॉल किया जा सकता है.

जब उपयोगकर्ता कॉन्टेंट चुन ले और गतिविधि शुरू करने के लिए तैयार हो, तो अपने ऐड-ऑन में startActivity() तरीके को इस तरह कॉल करें:

    sidePanelClient.startActivity({
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
            // State to send to participants.
        })
    });

startActivity() मेथड को कॉल करने पर, Meet ये कार्रवाइयां करता है:

  • मीटिंग में हिस्सा लेने वाले अन्य लोगों के लिए: Meet पर एक सूचना दिखती है कि गतिविधि जारी है.

  • ऐड-ऑन शुरू करने वाले व्यक्ति के लिए: अगर ActivityStartingState में मुख्य स्टेज का यूआरएल दिया गया है, तो Meet, ActivityStartingState में दिए गए यूआरएल का इस्तेमाल करके मुख्य स्टेज को खोलता है.

तीसरा चरण: गतिविधि शुरू होने की स्थिति के बारे में जानकारी पाना

जब कोई उपयोगकर्ता गतिविधि में शामिल होता है, तो वह ActivityStartingState के आधार पर, आपके ऐड-ऑन को मुख्य स्टेज या साइड पैनल में लोड करता है.

additionalData प्रॉपर्टी की मदद से, गतिविधि में शामिल होने वाले उपयोगकर्ताओं के साथ शुरुआती डेटा (इसे स्टेट भी कहा जाता है) शेयर किया जा सकता है. MainStageClient या SidePanelClient को शुरू करने के बाद, additionalData प्रॉपर्टी को वापस पाने के लिए, getActivityStartingState() तरीके को कॉल किया जा सकता है.

const startingState = client.getActivityStartingState();
const additionalData = JSON.parse(startingState.additionalData);

चौथा चरण (ज़रूरी नहीं): किसी गतिविधि में ऐड-ऑन की स्थिति शेयर करना

गतिविधि के दौरान, उपयोगकर्ताओं के बीच स्टेट भी शेयर किया जा सकता है. इसके लिए, आपको अपना सिंक्रनाइज़ेशन बैकएंड बनाना होगा.

उदाहरण: GitHub पर ऐनिमेशन ऐड-ऑन

GitHub पर मौजूद "ऐनिमेशन" सैंपल ऐड-ऑन में, ऐड-ऑन में साथ मिलकर काम करने की सुविधा शामिल है. इस गाइड का पहला चरण, सैंपल में शामिल नहीं है. इसके बजाय, जब ऐड-ऑन शुरू करने वाला व्यक्ति साइड पैनल में "ऐनिमेशन शुरू करें" बटन पर क्लिक करता है, तो startActivity() तरीके को कॉल किया जाता है (दूसरा चरण). इसके लिए, उपयोगकर्ता के चुने गए रंग से शुरुआती स्थिति को पॉप्युलेट किया जाता है. गतिविधि शुरू होने के बाद, मुख्य स्टेज getActivityStartingState() तरीके को कॉल करके शुरुआती स्थिति को वापस लाता है (तीसरा चरण). चौथा चरण छोड़ दिया गया है, क्योंकि इस सैंपल ऐड-ऑन में गतिविधि के दौरान, हिस्सा लेने वाले लोगों के बीच स्टेट (चुना गया रंग) शेयर नहीं किया जाता. हालांकि, उपयोगकर्ता कोई रंग चुनकर अपना स्टेटस बदल सकते हैं. यह रंग, साइड पैनल फ़्रेम से मुख्य स्टेज फ़्रेम पर भेजा जाता है. इसके लिए, फ़्रेम-टू-फ़्रेम मैसेजिंग का इस्तेमाल किया जाता है.

कंस्ट्रेंट

  • ActivityStartingState में दिए गए यूआरएल, उसी ऑरिजिन से जुड़े होने चाहिए जो ऐड-ऑन मेनिफ़ेस्ट में दिए गए हैं. ज़्यादा जानकारी के लिए, ऐड-ऑन की सुरक्षा लेख पढ़ें.
  • sidePanelUrl प्रॉपर्टी, mainStageUrl प्रॉपर्टी, और additionalData प्रॉपर्टी के वर्णों की लंबाई, उनके साइज़ की सीमाओं के मुताबिक होनी चाहिए. ये सीमाएं, एसडीके के रेफ़रंस दस्तावेज़ों में पब्लिश की जाती हैं.