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

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

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

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

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

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

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

गतिविधि शुरू करना

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

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

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

ऐड-ऑन, गतिविधि शुरू होने से पहले या उसके दौरान किसी भी समय setActivityStartingState() तरीके को कॉल करके, ActivityStartingState को सेट या अपडेट कर सकता है. अगर startActivity() में ActivityStartingState को खास तौर पर सेट किया गया है, तो 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 प्रॉपर्टी के वर्णों की संख्या, एसडीके के रेफ़रंस दस्तावेज़ों में बताई गई साइज़ की सीमाओं के मुताबिक होनी चाहिए.