ডেভেলপাররা তাদের অ্যাড-অনগুলিকে Meet-এর ইন-কল চ্যাট এবং Meet-এর স্ক্রিন শেয়ারিং বৈশিষ্ট্যের মাধ্যমে প্রচার করে আবিষ্কারযোগ্যতা বাড়াতে পারেন।
ইন-কল চ্যাট
যখন কোনও বার্তায় কোনও অ্যাড-অনের সাথে সম্পর্কিত লিঙ্ক(গুলি) থাকে, তখন Google Meet অ্যাড-অনগুলি Meet-এর ইন-কল চ্যাটে ব্যবহারকারীদের কাছে স্বয়ংক্রিয়ভাবে প্রচারিত হয়। চ্যাটে অ্যাড-অন প্রচার করার জন্য ডেভেলপারের কোনও পদক্ষেপ নেওয়ার প্রয়োজন হয় না। পার্শ্ব প্যানেল URI এবং ডিপ্লয়মেন্ট ম্যানিফেস্টের মধ্যে সেট করা অ্যাড-অন অরিজিনের উপর ভিত্তি করে পর্যালোচনা দল নির্ধারণ করে যে কোন লিঙ্ক(গুলি) অ্যাড-অনের সাথে যুক্ত করা হবে।
যখন ব্যবহারকারীরা একটি অ্যাড-অনের সাথে সম্পর্কিত একটি ইন-কল চ্যাটের মাধ্যমে একটি বার্তা পাঠান, তখন দুটি জিনিসের মধ্যে একটি ঘটে:
- যদি অ্যাড-অনটি ইনস্টল না করা থাকে, তাহলে একটি কার্ড ব্যবহারকারীকে অ্যাড-অনটি ইনস্টল করার জন্য অনুরোধ করবে।
- যদি অ্যাড-অনটি ইতিমধ্যেই ইনস্টল করা থাকে, তাহলে একটি বোতাম ব্যবহারকারীকে অ্যাড-অনটি খোলার কথা মনে করিয়ে দেয়।
স্ক্রিন শেয়ারিং
এই পৃষ্ঠায় বর্ণনা করা হয়েছে যে কীভাবে Google Meet-এর সাথে ট্যাব স্ক্রিন শেয়ার করার সময় ব্যবহারকারীদের কাছে একটি অ্যাড-অন প্রচার করা যায়, অন্য একটি ওয়েব পৃষ্ঠায় অল্প পরিমাণে কোড রেখে।
exposeToMeetWhenScreensharing() পদ্ধতি সাইটটিকে Meet-এ তথ্য পাঠাতে সাহায্য করে যখন তার ট্যাবটি স্ক্রিন শেয়ার করা হয়। ব্যবহারকারী যদি অ্যাড-অন ইনস্টল করে থাকেন, তাহলে প্রেজেন্টেশন ব্যানারে "কার্যকলাপ শুরু করুন" এ ক্লিক করলে Meet-এর অ্যাড-অন অভিজ্ঞতায় এই তথ্য ব্যবহার করা হয়। যদি ব্যবহারকারী কোনও ট্যাব স্ক্রিন শেয়ার করার সময় অ্যাড-অন ইনস্টল না করে থাকেন, তাহলে তাদের অ্যাড-অন ইনস্টল করার জন্য অনুরোধ করা হয়।
AddonScreenshareInfo অবজেক্টে পাঁচটি বৈশিষ্ট্য রয়েছে যা ব্যবহারের ক্ষেত্রের উপর ভিত্তি করে যোগ করা যেতে পারে:
additionalData: অ্যাড-অনটি নিজেকে আরম্ভ করার জন্য তথ্য ব্যবহার করতে পারে।startActivityOnOpenপ্রোপার্টি সত্য হলেই কেবল সেট করা যাবে এবংActivityStartingStateব্যবহার করে অ্যাক্সেস করা যাবে। আরও তথ্যের জন্য, কার্যকলাপ শুরুর অবস্থা পান দেখুন।cloudProjectNumber: প্রয়োজনীয়। আপনার Google Cloud প্রকল্পের প্রকল্প নম্বর।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 (প্রস্তাবিত)
যদি আপনার প্রোজেক্ট npm ব্যবহার করে, তাহলে আপনি Meet অ্যাড-অন SDK npm প্যাকেজের নির্দেশাবলী অনুসরণ করতে পারেন।
প্রথমে, npm প্যাকেজটি ইনস্টল করুন:
npm install @googleworkspace/meet-addons
তারপর, MeetAddonScreenshareExport ইন্টারফেস আমদানি করে Meet অ্যাড-অন SDK পাওয়া যাবে:
import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';
টাইপস্ক্রিপ্ট ব্যবহারকারীদের জন্য, টাইপস্ক্রিপ্ট সংজ্ঞাগুলি মডিউলের সাথে প্যাকেজ করা হয়। টাইপস্ক্রিপ্ট ব্যবহারকারীদের প্রকল্পের tsconfig.json এর মধ্যে moduleResolution কে "bundler" এ সেট করা উচিত, যাতে package.json "exports" spec স্ক্রিন শেয়ারিং প্যাকেজ export আমদানি করতে সক্ষম করে।
জিস্ট্যাটিক
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 : স্ট্রিং। আপনার ক্লাউড প্রোজেক্টের প্রোজেক্ট নম্বর।
- SIDE_PANEL_URL : স্ট্রিং। সাইড প্যানেলের URL।
যখন Meet কল স্ক্রিনে থাকা ব্যবহারকারী পৃষ্ঠাটি শেয়ার করেন, তখন তারা Meet-এ একটি প্রেজেন্টেশন ব্যানার দেখতে পান। ব্যানারের বোতামে ক্লিক করলে পাশের প্যানেলে প্রদত্ত ক্লাউড প্রজেক্ট নম্বরের জন্য অ্যাড-অনটি খোলে। যেহেতু startActivityOnOpen প্রপার্টিটি false-এ সেট করা ছিল, তাই ActivityStartingState সেট না হওয়া পর্যন্ত start activity বোতামটি অক্ষম থাকে। আরও তথ্যের জন্য, "অ্যাক্টিভিটি শুরু করার অবস্থা ব্যবহার করুন" দেখুন।
একবার কার্যকলাপ শুরু হয়ে গেলে, কলে থাকা অন্যান্য ব্যবহারকারীদের অ্যাড-অনটি চালু বা ইনস্টল করার জন্য অনুরোধ করা হবে।
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 ক্ষেত্রে তালিকাভুক্ত করতে হবে।
আরও তথ্যের জন্য, অ্যাড-অন নিরাপত্তা দেখুন।