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

स्क्रीन शेयरिंग के ज़रिए ऐड-ऑन का प्रचार करना.

इस पेज पर बताया गया है कि 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.1.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.1.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.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: स्ट्रिंग. आपका क्लाउड प्रोजेक्ट नंबर.
  • SIDE_PANEL_URL: स्ट्रिंग. साइड पैनल का यूआरएल.

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

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

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

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

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

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