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);

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

गतिविधि के दौरान, उपयोगकर्ताओं के बीच स्टेटस भी शेयर किया जा सकता है. राज्य को दो तरीकों से शेयर किया जा सकता है:

  • सिंक करने के लिए, खुद का बैकएंड बनाएं और उसे मैनेज करें.
  • Co-Doing API का इस्तेमाल करें. यह उपयोगकर्ताओं के बीच डेटा शेयर करने का आसान और तेज़ तरीका है.

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

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

कंस्ट्रेंट

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