ব্যবহারকারীদের কাছে একটি অ্যাড-অন প্রচার করুন

ডেভেলপাররা Meet-এর ইন-কল চ্যাট এবং স্ক্রিন শেয়ারিং ফিচারের মাধ্যমে তাদের অ্যাড-অনগুলোর প্রচার করে সেগুলোর সহজলভ্যতা বাড়াতে পারেন।

ইন-কল চ্যাট

যখন কোনো মেসেজে অ্যাড-অনের সাথে যুক্ত লিঙ্ক থাকে, তখন Google Meet অ্যাড-অনগুলি Meet-এর ইন-কল চ্যাটে ব্যবহারকারীদের কাছে স্বয়ংক্রিয়ভাবে প্রচার করা হয়। চ্যাটে অ্যাড-অন প্রচার করার জন্য ডেভেলপারের কোনো পদক্ষেপের প্রয়োজন হয় না। রিভিউ টিম সাইড প্যানেল URI এবং ডেপ্লয়মেন্ট ম্যানিফেস্টের মধ্যে সেট করা অ্যাড-অন অরিজিনের উপর ভিত্তি করে নির্ধারণ করে যে কোন লিঙ্ক(গুলি) একটি অ্যাড-অনের সাথে যুক্ত করা হবে।

যখন ব্যবহারকারীরা কোনো অ্যাড-অনের সাথে যুক্ত ইন-কল চ্যাটের মাধ্যমে বার্তা পাঠান, তখন দুটি ঘটনার মধ্যে একটি ঘটে:

  1. অ্যাড-অনটি ইনস্টল করা না থাকলে, একটি কার্ড ব্যবহারকারীকে অ্যাড-অনটি ইনস্টল করার জন্য অনুরোধ জানায়।
  2. অ্যাড-অনটি আগে থেকেই ইনস্টল করা থাকলে, একটি বাটন ব্যবহারকারীকে সেটি খোলার কথা মনে করিয়ে দেয়।

স্ক্রিন শেয়ারিং

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

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

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

AddonScreenshareInfo অবজেক্টটিতে পাঁচটি প্রোপার্টি রয়েছে যা ব্যবহারের ক্ষেত্র অনুযায়ী যোগ করা যেতে পারে:

  • additionalData : যে তথ্য অ্যাড-অনটি নিজেকে চালু করার জন্য ব্যবহার করতে পারে। এটি শুধুমাত্র তখনই সেট করা যাবে যখন startActivityOnOpen প্রপার্টিটি true হবে এবং ActivityStartingState ব্যবহার করে এটি অ্যাক্সেস করা যাবে। আরও তথ্যের জন্য, "অ্যাক্টিভিটির শুরুর অবস্থা জানুন" (Get the activity starting state ) দেখুন।

  • cloudProjectNumber : আবশ্যক। এটি আপনার গুগল ক্লাউড প্রজেক্টের প্রজেক্ট নম্বর।

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

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

  • startActivityOnOpen : আবশ্যক। ব্যবহারকারী যখন প্রেজেন্টেশন ব্যানার থেকে অ্যাড-অনটি চালু করবেন, তখন Meet-এ অ্যাক্টিভিটি অ্যাড-অন অভিজ্ঞতাটি অবিলম্বে শুরু হবে কিনা। mainStageUrl প্রপার্টি ব্যবহার করা হলে এটি অবশ্যই true হতে হবে।

SDK ইনস্টল এবং ইম্পোর্ট করুন

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

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

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

npm install @googleworkspace/meet-addons

এরপর, MeetAddonScreenshareExport ইন্টারফেসটি ইম্পোর্ট করার মাধ্যমে Meet অ্যাড-অন SDK-টি পাওয়া যাবে:

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

TypeScript ব্যবহারকারীদের জন্য, TypeScript ডেফিনিশনগুলো মডিউলের সাথেই প্যাকেজ করা থাকে। TypeScript ব্যবহারকারীদের প্রোজেক্টের tsconfig.json ফাইলে moduleResolution "bundler" এ সেট করতে হবে, যাতে package.json-এর "exports" স্পেকটি স্ক্রিন শেয়ারিং প্যাকেজের এক্সপোর্ট ইম্পোর্ট করা সক্ষম করে।

জিস্ট্যাটিক

গুগল মিট অ্যাড-অন এসডিকে (SDK) gstatic থেকে একটি জাভাস্ক্রিপ্ট বান্ডেল হিসেবে পাওয়া যায়, যা স্ট্যাটিক কন্টেন্ট পরিবেশনকারী একটি ডোমেইন।

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

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

Meet অ্যাড-অন SDK-টি MeetAddon ইন্টারফেসের মাধ্যমে window.meet.addon এ পাওয়া যায়।

উদাহরণ: কোনো অ্যাক্টিভিটি শুরু না করেই সাইড প্যানেলে লোড করুন।

নিম্নলিখিত কোড নমুনায়, একজন ব্যবহারকারী এমন একটি অ্যাড-অন সহ একটি পৃষ্ঠা স্ক্রিন শেয়ার করেন, যেটিকে অ্যাক্টিভিটি শুরু হওয়ার আগে রিসোর্স পারমিশন সামঞ্জস্য করতে হয়। এই প্রয়োজনীয়তার কারণে, অ্যাক্টিভিটিটি সকলের জন্য শুরু না করে, অ্যাড-অনটি সাইড প্যানেলে শুরু করা উচিত।

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

  • CLOUD_PROJECT_NUMBER : স্ট্রিং। আপনার ক্লাউড প্রজেক্টের প্রজেক্ট নম্বর।
  • SIDE_PANEL_URL : স্ট্রিং। সাইড প্যানেলের ইউআরএল।

যখন ব্যবহারকারী Meet কল স্ক্রিনে পেজটি শেয়ার করেন, তখন তিনি Meet-এ একটি প্রেজেন্টেশন ব্যানার দেখতে পান। ব্যানারের বাটনটিতে ক্লিক করলে সাইড প্যানেলে প্রদত্ত ক্লাউড প্রজেক্ট নম্বরের জন্য অ্যাড-অনটি খোলে। যেহেতু startActivityOnOpen প্রপার্টিটি false সেট করা ছিল, তাই ActivityStartingState সেট না করা পর্যন্ত স্টার্ট অ্যাক্টিভিটি বাটনটি নিষ্ক্রিয় থাকে। আরও তথ্যের জন্য, “Use the activity starting state” দেখুন।

কার্যক্রমটি শুরু হয়ে গেলে, কলে থাকা অন্যান্য ব্যবহারকারীদের অ্যাড-অনটি চালু বা ইনস্টল করার জন্য অনুরোধ জানানো হয়।

গিটহাবে থাকা "অ্যানিমেশন" স্যাম্পল অ্যাড-অনটিতে এই উদাহরণটি একটি সম্পূর্ণ অ্যাড-অনের অংশ হিসেবে অন্তর্ভুক্ত রয়েছে। যখন অ্যাড-অনটির সাথে যুক্ত ওয়েব অ্যাপের ইন্ডেক্স পেজটি প্রদর্শিত হয়, তখন উপস্থাপক ব্যবহারকারীকে অ্যাড-অনটি ইনস্টল বা সেট আপ করার জন্য অনুরোধ জানানো হয়।

উদাহরণ: মূল স্টেজে লোড করুন

নিম্নলিখিত কোড নমুনায়, Meet-এ কোনো ব্যবহারকারী যখন নিম্নলিখিত কোড সম্বলিত একটি ওয়েব পেজ স্ক্রিন শেয়ার করেন, তখন তাকে অ্যাড-অনটি চালু করার জন্য অনুরোধ করা হয়:

<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-এ একটি প্রেজেন্টেশন ব্যানার দেখতে পান। ব্যানারের বোতামে ক্লিক করলে মূল স্টেজে প্রদত্ত ক্লাউড প্রজেক্ট নম্বরের জন্য অ্যাড-অনটি খুলে যায়। 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 : স্ট্রিং। সাইড প্যানেলের ইউআরএল।

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

উৎস মিল

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

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

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