স্ক্রিন শেয়ারিংয়ের মাধ্যমে ব্যবহারকারীদের কাছে একটি অ্যাড-অন প্রচার করুন

স্ক্রিন শেয়ারিংয়ের মাধ্যমে একটি অ্যাড-অন প্রচার করা।

এই পৃষ্ঠাটি বর্ণনা করে যে কীভাবে ব্যবহারকারীদের কাছে একটি অ্যাড-অন প্রচার করা যায় যখন Google Meet-এর সাথে একটি ট্যাব শেয়ার করার সময় অন্য একটি ওয়েব পৃষ্ঠায় অল্প পরিমাণ কোড রেখে স্ক্রিন শেয়ার করা যায়।

exposeToMeetWhenScreensharing() পদ্ধতির সাহায্যে সাইটটির ট্যাব স্ক্রিন শেয়ার করা হলে Meet-এ তথ্য পাঠাতে পারে। এই তথ্যটি Meet-এর অ্যাড-অন অভিজ্ঞতায় ব্যবহার করা হয় যখন ব্যবহারকারীরা অ্যাড-অন ইনস্টল করা থাকলে প্রেজেন্টেশন ব্যানারে "অ্যাক্টিভিটি শুরু করুন" ক্লিক করেন। একটি ট্যাব শেয়ার করার সময় ব্যবহারকারীর কাছে অ্যাড-অন ইনস্টল না থাকলে, তাদের অ্যাড-অন ইনস্টল করতে বলা হয়।

AddonScreenshareInfo অবজেক্টে পাঁচটি বৈশিষ্ট্য রয়েছে যা ব্যবহারের ক্ষেত্রের ভিত্তিতে যোগ করা যেতে পারে:

  • additionalData : তথ্য অ্যাড-অন নিজেই শুরু করতে ব্যবহার করতে পারে। startActivityOnOpen প্রপার্টি সত্য হলেই সেট করা যাবে এবং ActivityStartingState ব্যবহার করে অ্যাক্সেস করা যাবে। আরও তথ্যের জন্য, ক্রিয়াকলাপ শুরুর অবস্থা পান দেখুন।

  • cloudProjectNumber : প্রয়োজনীয়। আপনার Google ক্লাউড প্রকল্পের প্রজেক্ট নম্বর।

  • mainStageUrl : যে ইউআরএলটি অ্যাড-অন শুরু হওয়ার পরে মূল পর্যায়টি খোলে, যেমন https://www.example.com । ইউআরএলটি অবশ্যই অ্যাড-অন ম্যানিফেস্টে উল্লেখ করা ইউআরএলগুলির মতো একই উৎসের হতে হবে।

  • sidePanelUrl : অ্যাড-অন শুরু হলে পাশের প্যানেলটি যে URLটি খোলে, যেমন https://www.example.com । ইউআরএলটি অবশ্যই অ্যাড-অন ম্যানিফেস্টে উল্লেখ করা ইউআরএলগুলির মতো একই উৎসের হতে হবে।

  • startActivityOnOpen : প্রয়োজনীয়। ব্যবহারকারী প্রেজেন্টেশন ব্যানার থেকে অ্যাড-অন শুরু করার সাথে সাথে Meet-এ অ্যাক্টিভিটি অ্যাড-অন অভিজ্ঞতা শুরু করবেন কিনা। mainStageUrl সম্পত্তি ব্যবহার করা হলে সত্য হতে হবে।

SDK ইনস্টল এবং আমদানি করুন

আপনি npm ব্যবহার করে বা gstatic ব্যবহার করে SDK অ্যাক্সেস করতে পারেন।

আপনার প্রোজেক্ট npm ব্যবহার করলে, আপনি Meet Add-ons SDK npm প্যাকেজের নির্দেশাবলী অনুসরণ করতে পারেন।

প্রথমে, npm প্যাকেজটি ইনস্টল করুন:

npm install @googleworkspace/meet-addons

তারপর, MeetAddonScreenshareExport ইন্টারফেস আমদানি করে Meet অ্যাড-অন SDK পাওয়া যায়:

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

TypeScript ব্যবহারকারীদের জন্য, TypeScript সংজ্ঞা মডিউল দিয়ে প্যাকেজ করা হয়।

gstatic

Google Meet অ্যাড-অন SDK gstatic থেকে জাভাস্ক্রিপ্ট বান্ডেল হিসাবে উপলব্ধ, একটি ডোমেন যা স্ট্যাটিক কন্টেন্ট পরিবেশন করে।

Meet অ্যাড-অন SDK ব্যবহার করতে, আপনার অ্যাপে নিম্নলিখিত স্ক্রিপ্ট ট্যাগ যোগ করুন:

<script src="https://www.gstatic.com/meetjs/addons/1.0.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 : স্ট্রিং। আপনার ক্লাউড প্রকল্পের প্রকল্প নম্বর।
  • SIDE_PANEL_URL : স্ট্রিং। পাশের প্যানেলের 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 ক্লাউড প্রকল্পের প্রজেক্ট নম্বর।
  • MAIN_STAGE_URL : স্ট্রিং। মূল পর্যায়ের 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 : স্ট্রিং। আপনার ক্লাউড প্রকল্পের প্রকল্প নম্বর।
  • SIDE_PANEL_URL : স্ট্রিং। পাশের প্যানেলের URL।

Meet কল স্ক্রিনে থাকা ব্যবহারকারী যখন পৃষ্ঠাটি শেয়ার করেন, তখন তারা Meet-এ একটি প্রেজেন্টেশন ব্যানার দেখতে পান। ব্যানারের বোতামে ক্লিক করলে পাশের প্যানেলে প্রদত্ত ক্লাউড প্রকল্প নম্বরের জন্য অ্যাড-অন খোলে। sidePanelUrl প্রপার্টি লোড করা হয় এবং additionalData প্রপার্টি অ্যাড-অনের অ্যাক্টিভিটি প্রারম্ভিক অবস্থা সেট করতে ব্যবহার করা হয়। কলে থাকা অন্যান্য ব্যবহারকারীদের অবিলম্বে অ্যাড-অন ইনস্টল বা চালু করার জন্য অনুরোধ করা হয়।

মূল মিল

mainStageUrl প্রপার্টি এবং sidePanelUrl প্রপার্টিতে প্রদত্ত অরিজিনগুলিকে প্রদত্ত ক্লাউড প্রোজেক্ট নম্বরের অ্যাড-অন ম্যানিফেস্টের উৎপত্তির সাথে তুলনা করা হয়। সবকিছু মিলে গেলে ব্যবহারকারীকে অ্যাড-অন চালু করার অনুমতি দেওয়া হয়।

অতিরিক্তভাবে, স্ক্রিন শেয়ার শুরু করা সাইটের উত্স অবশ্যই অ্যাড-অন ম্যানিফেস্টের addOnOrigins ক্ষেত্রে তালিকাভুক্ত করা উচিত।

আরও তথ্যের জন্য, অ্যাড-অন নিরাপত্তা দেখুন।