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 टूल के रेफ़रंस दस्तावेज़ों में बताई गई सीमा के मुताबिक होनी चाहिए.