स्क्रीन शेयर करने की सुविधा से, उपयोगकर्ताओं के लिए किसी ऐड-ऑन का प्रमोशन करें

स्क्रीन की मदद से ऐड-ऑन का प्रमोशन करना
शेयर करें.

इस पेज पर, लोगों के लिए ऐड-ऑन का प्रमोशन करने का तरीका बताया गया है एक छोटा सा कोड डालकर 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 प्रॉपर्टी का इस्तेमाल किया जाता है.

SDK टूल इंस्टॉल और इंपोर्ट करना

SDK टूल को npm या gstatic का इस्तेमाल करके ऐक्सेस किया जा सकता है.

अगर आपका प्रोजेक्ट npm का इस्तेमाल करता है, तो Meet के ऐड-ऑन के SDK टूल के npm पैकेज के लिए दिए गए निर्देशों का पालन करें.

सबसे पहले, npm पैकेज इंस्टॉल करें:

npm install @googleworkspace/meet-addons

इसके बाद, Meet के ऐड-ऑन SDK टूल को इस्तेमाल करने के लिए, MeetAddonScreenshareExport इंटरफ़ेस को इंपोर्ट करें:

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

TypeScript उपयोगकर्ताओं के लिए, TypeScript की परिभाषाओं को मॉड्यूल के साथ पैकेज किया जाता है.

जीस्टैटिक

Google Meet ऐड-ऑन SDK टूल, gstatic से JavaScript बंडल के तौर पर उपलब्ध है. यह एक ऐसा डोमेन है जो स्टैटिक कॉन्टेंट दिखाता है.

Meet ऐड-ऑन SDK टूल का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन में यह स्क्रिप्ट टैग जोड़ें:

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

Meet ऐड-ऑन SDK टूल, window.meet.addon में जाकर MeetAddon इंटरफ़ेस से उपलब्ध है.

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

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

<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 प्रॉपर्टी को 'गलत' पर सेट किया गया था. इसलिए, 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 फ़ील्ड में शामिल होना चाहिए.

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