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

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

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

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

• AddonScreenshareInfo.additionalData: ऐड-ऑन अपने-आप शुरू होने के लिए, इस जानकारी का इस्तेमाल कर सकता है. इसे सिर्फ़ तब सेट किया जा सकता है, जब AddonScreenshareInfo.startActivityOnOpen सही हो और CollaborationStartingState का इस्तेमाल करके इसे ऐक्सेस किया जा सकता हो. ज़्यादा जानकारी के लिए, 'साथ मिलकर काम करने की शुरुआती स्थिति' का इस्तेमाल करना देखें.

• AddonScreenshareInfo.cloudProjectNumber: ज़रूरी है. ऐड-ऑन के Google Cloud प्रोजेक्ट का नंबर.

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

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

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

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

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

<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

इन्हें बदलें:

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

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

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

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

<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

इन्हें बदलें:

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

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

उदाहरण: साथ मिलकर काम करने की सुविधा शुरू किए बिना, साइड पैनल में जानकारी लोड करें

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

<script src="https://www.gstatic.com/meetjs/addons/0.7.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: स्ट्रिंग. आपके क्लाउड प्रोजेक्ट का नंबर.
• SIDE_PANEL_URL: स्ट्रिंग. साइड पैनल का यूआरएल.

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

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

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

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

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

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

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

• साथ मिलकर काम करने की सुविधा शुरू करने की स्थिति का इस्तेमाल करना
• ऐड-ऑन सिक्योरिटी