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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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