उपयोगकर्ताओं के लिए ऐड-ऑन का प्रमोशन करना

डेवलपर, अपने ऐड-ऑन को ज़्यादा से ज़्यादा लोगों तक पहुंचा सकते हैं. इसके लिए, उन्हें Meet की इन-कॉल चैट और स्क्रीन शेयर करने की सुविधा का इस्तेमाल करके, ऐड-ऑन का प्रमोशन करना होगा.

कॉल के दौरान की गई चैट

जब किसी मैसेज में ऐड-ऑन से जुड़े लिंक होते हैं, तो Google Meet के कॉल के दौरान चैट में, लोगों को Google Meet के ऐड-ऑन का प्रमोशन अपने-आप दिखता है. चैट में ऐड-ऑन का प्रमोशन करने के लिए, डेवलपर को कोई कार्रवाई करने की ज़रूरत नहीं है. समीक्षा टीम यह तय करती है कि किसी ऐड-ऑन से कौनसे लिंक जोड़े जाएं. यह फ़ैसला, साइड पैनल यूआरआई और डिप्लॉयमेंट मेनिफ़ेस्ट में सेट किए गए ऐड-ऑन के ऑरिजिन के आधार पर लिया जाता है.

जब उपयोगकर्ता, कॉल के दौरान ऐड-ऑन से जुड़ी चैट के ज़रिए कोई मैसेज भेजते हैं, तो इनमें से कोई एक काम होता है:

1. अगर ऐड-ऑन इंस्टॉल नहीं है, तो एक कार्ड दिखेगा. इसमें उपयोगकर्ता को ऐड-ऑन इंस्टॉल करने के लिए कहा जाएगा.
2. अगर ऐड-ऑन पहले से इंस्टॉल है, तो एक बटन उपयोगकर्ता को ऐड-ऑन खोलने के लिए सूचना देता है.

स्क्रीन शेयर करना

इस पेज पर बताया गया है कि Google Meet में किसी टैब को स्क्रीन शेयर करते समय, उपयोगकर्ताओं के सामने ऐड-ऑन का प्रमोशन कैसे किया जाता है. इसके लिए, आपको किसी दूसरे वेब पेज पर थोड़ा सा कोड डालना होगा.

exposeToMeetWhenScreensharing() तरीके से, साइट Meet को जानकारी भेज सकती है. ऐसा तब होता है, जब साइट का टैब स्क्रीन शेयर किया जाता है. इस जानकारी का इस्तेमाल, Meet के साथ ऐड-ऑन का इस्तेमाल करने के दौरान किया जाता है. ऐसा तब होता है, जब उपयोगकर्ता ने ऐड-ऑन इंस्टॉल किया हो और वह प्रज़ेंटेशन बैनर पर "गतिविधि शुरू करें" पर क्लिक करे. अगर उपयोगकर्ता ने टैब शेयर करते समय ऐड-ऑन इंस्टॉल नहीं किया है, तो उसे ऐड-ऑन इंस्टॉल करने के लिए कहा जाता है.

AddonScreenshareInfo ऑब्जेक्ट में पांच प्रॉपर्टी होती हैं. इन्हें इस्तेमाल के उदाहरण के आधार पर जोड़ा जा सकता है:

• additionalData: ऐड-ऑन को शुरू करने के लिए, यह जानकारी इस्तेमाल की जा सकती है. इसे सिर्फ़ तब सेट किया जा सकता है, जब startActivityOnOpen प्रॉपर्टी की वैल्यू 'सही है' पर सेट हो. साथ ही, इसे ActivityStartingState का इस्तेमाल करके ऐक्सेस किया जा सकता है. ज़्यादा जानकारी के लिए, गतिविधि शुरू होने की स्थिति पाना लेख पढ़ें.

• cloudProjectNumber: ज़रूरी है. आपके Google Cloud प्रोजेक्ट का प्रोजेक्ट नंबर.

• mainStageUrl: यह वह यूआरएल है जिस पर ऐड-ऑन शुरू होने के बाद, मुख्य स्टेज खुलता है. जैसे, https://www.example.com. यूआरएल, उसी ऑरिजिन का होना चाहिए जिसका इस्तेमाल ऐड-ऑन के मेनिफ़ेस्ट में दिए गए यूआरएल के लिए किया गया है.

• sidePanelUrl: यह वह यूआरएल होता है जिस पर ऐड-ऑन शुरू होने के बाद साइड पैनल खुलता है. जैसे, https://www.example.com. यूआरएल, उसी ऑरिजिन का होना चाहिए जिसका इस्तेमाल ऐड-ऑन के मेनिफ़ेस्ट में दिए गए यूआरएल के लिए किया गया है.

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

एसडीके टूल इंस्टॉल और इंपोर्ट करना

npm या gstatic का इस्तेमाल करके, एसडीके को ऐक्सेस किया जा सकता है.

npm install @googleworkspace/meet-addons

import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';

<script src="https://www.gstatic.com/meetjs/addons/1.1.0/meet.addons.screenshare.js"></script>

उदाहरण: कोई गतिविधि शुरू किए बिना साइड पैनल में लोड करना

कोड के इस सैंपल में, उपयोगकर्ता की स्क्रीन पर एक ऐसा पेज शेयर किया गया है जिसमें एक ऐड-ऑन है. इस ऐड-ऑन को गतिविधि शुरू करने से पहले, संसाधन की अनुमतियों को अडजस्ट करना होगा. इस ज़रूरी शर्त की वजह से, ऐड-ऑन को साइड पैनल में शुरू किया जाना चाहिए. हालांकि, इसे सभी के लिए शुरू नहीं किया जाना चाहिए.

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

इनकी जगह ये डालें:

• CLOUD_PROJECT_NUMBER: स्ट्रिंग. आपके Cloud प्रोजेक्ट का प्रोजेक्ट नंबर.
• SIDE_PANEL_URL: स्ट्रिंग. साइड पैनल का यूआरएल.

मीटिंग में शामिल कोई व्यक्ति जब पेज शेयर करता है, तब उसे Meet में एक प्रज़ेंटेशन बैनर दिखता है. बैनर पर मौजूद बटन पर क्लिक करने से, साइड पैनल में दिए गए क्लाउड प्रोजेक्ट नंबर के लिए ऐड-ऑन खुल जाता है. startActivityOnOpen प्रॉपर्टी को false पर सेट किया गया था. इसलिए, ActivityStartingState को सेट किए जाने तक, गतिविधि शुरू करें बटन बंद रहेगा. ज़्यादा जानकारी के लिए, गतिविधि शुरू होने की स्थिति का इस्तेमाल करना लेख पढ़ें.

गतिविधि शुरू होने के बाद, कॉल में शामिल अन्य लोगों को ऐड-ऑन लॉन्च या इंस्टॉल करने के लिए कहा जाता है.

GitHub पर"ऐनिमेशन" सैंपल ऐड-ऑन में, इस उदाहरण को पूरे ऐड-ऑन के हिस्से के तौर पर शामिल किया गया है. जब ऐड-ऑन से जुड़ा वेब ऐप्लिकेशन का इंडेक्स पेज दिखता है, तब उपयोगकर्ता को ऐड-ऑन इंस्टॉल करने या सेट अप करने के लिए कहा जाता है.

उदाहरण: मुख्य स्टेज में लोड करें

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

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

इनकी जगह ये डालें:

• CLOUD_PROJECT_NUMBER: स्ट्रिंग. आपके Google Cloud प्रोजेक्ट का प्रोजेक्ट नंबर.
• MAIN_STAGE_URL: स्ट्रिंग. मुख्य स्टेज का यूआरएल.

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

उदाहरण: साइड पैनल में लोड करें

यहां दिए गए कोड के सैंपल में, उपयोगकर्ता एक ऐसे पेज को स्क्रीन शेयर करता है जिसमें एक ऐड-ऑन है. यह ऐड-ऑन, मुख्य स्टेज के बजाय साइड पैनल में शुरू होना चाहिए:

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

इनकी जगह ये डालें:

• CLOUD_PROJECT_NUMBER: स्ट्रिंग. आपके Cloud प्रोजेक्ट का प्रोजेक्ट नंबर.
• SIDE_PANEL_URL: स्ट्रिंग. साइड पैनल का यूआरएल.

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

ऑरिजिन मैचिंग

mainStageUrl प्रॉपर्टी और sidePanelUrl प्रॉपर्टी में दिए गए ऑरिजिन की तुलना, दिए गए क्लाउड प्रोजेक्ट नंबर के ऐड-ऑन मेनिफ़ेस्ट में मौजूद ऑरिजिन से की जाती है. अगर सभी चीज़ें मेल खाती हैं, तो उपयोगकर्ता को ऐड-ऑन लॉन्च करने की अनुमति दी जाती है.

इसके अलावा, स्क्रीन शेयर करने की सुविधा शुरू करने वाली साइट का ऑरिजिन, ऐड-ऑन मेनिफ़ेस्ट में मौजूद addOnOrigins फ़ील्ड में शामिल होना चाहिए.

ज़्यादा जानकारी के लिए, सुरक्षा से जुड़ा ऐड-ऑन लेख पढ़ें.

मिलते-जुलते विषय

• Meet के ऐड-ऑन का इस्तेमाल करके, लोगों के साथ मिलकर काम करना
• ऐड-ऑन सुरक्षा