কো-ওয়াচিং এপিআই আপনার অ্যাপে কন্টেন্ট দেখার বা শোনার জন্য একাধিক অংশগ্রহণকারীর মিটিং অভিজ্ঞতা পরিচালনা করে।
এই নির্দেশিকাটি ব্যাখ্যা করে কিভাবে কো-ওয়াচিং API বাস্তবায়ন করতে হয়।
শুরু করুন
Co-Watching API ব্যবহার করার জন্য, আপনাকে প্রথমে একটি Meet অ্যাড-অন স্থাপন করতে হবে। একবার আপনি এই ধাপগুলি সম্পন্ন করার পরে, আপনি আপনার নতুন অ্যাড-অনের মধ্যে থেকে Co-Watching API ব্যবহার শুরু করতে পারেন।
কো-ওয়াচিং এপিআই ব্যবহার করতে, একটি AddonSession অবজেক্ট ব্যবহার করে শুরু করুন, যা গুগল মিটের সহ-কার্যকলাপগুলির জন্য এন্ট্রি পয়েন্ট হিসেবে কাজ করে:
টাইপস্ক্রিপ্ট
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
আপনার Google Cloud প্রোজেক্টের প্রোজেক্ট নম্বর দিয়ে CLOUD_PROJECT_NUMBER পরিবর্তে লিখুন।
একটি সহ-পর্যবেক্ষক ক্লায়েন্ট তৈরি করুন
শুরু করতে, আপনার AddonSession থেকে একটি CoWatchingClient অবজেক্ট তৈরি করুন।
একটি CoWatchingCient তৈরি করতে, createCoWatchingClient() পদ্ধতিতে কল করুন এবং একটি CoWatchingDelegate অবজেক্ট প্রদান করুন।
CoWatchingDelegate হল Co-Watching API আপনার অ্যাপের নতুন অবস্থা উপলব্ধ হলেই তা আপডেট করে। আশা করা যায় যে, যখন onCoWatchingStateChanged() পদ্ধতিটি কল করা হয়, তখন আপনার অ্যাপটি তাৎক্ষণিকভাবে নতুন অবস্থা প্রয়োগ করে।
নিম্নলিখিত কোড নমুনাটি কো-ওয়াচিং API কীভাবে ব্যবহার করবেন তা দেখায়:
টাইপস্ক্রিপ্ট
const coWatchingClient = await addonSession.createCoWatchingClient({
activityTitle: "ACTIVITY_TITLE",
onCoWatchingStateQuery() {
// This function should return the current state of your CoWatching activity
return getMyApplicationCoWatchingState();
},
onCoWatchingStateChanged(coWatchingState: CoWatchingState) {
// This function should apply newState to your ongoing CoWatching activity
},
});
আপনার কার্যকলাপের মিডিয়া শিরোনাম দিয়ে ACTIVITY_TITLE প্রতিস্থাপন করুন।
বর্তমান অবস্থা পরিচালনা করুন
যখন ব্যবহারকারীরা আপনার অ্যাপ্লিকেশনে পদক্ষেপ নেয়, তখন আশা করা যায় যে আপনার অ্যাপ্লিকেশনটি তাৎক্ষণিকভাবে প্রদত্ত API পদ্ধতিগুলিকে কল করবে।
আপনার কেবলমাত্র উল্লেখযোগ্য ঘটনার প্রতিক্রিয়ায় এই পদ্ধতিগুলি কল করা উচিত। উদাহরণস্বরূপ, আপনার অ্যাপ যখনই কোনও প্লেয়িং ভিডিও এগিয়ে নিয়ে যায় তখন আপনাকে এগুলি কল করার প্রয়োজন হয় না। আপনার তৈরি করা CoWatchingDelegate এই পরিস্থিতিতে আপডেট হওয়া প্লেআউট পজিশনগুলি পেতে হ্যান্ডেল করে।
আপনি এই পদ্ধতিগুলি ব্যবহার করে সহ-পর্যবেক্ষণ অবস্থা নিয়ন্ত্রণ করতে পারেন:
notifyBuffering(): যখন কোনও ব্যবহারকারীর অ্যাপ পূর্ববর্তী মিডিয়া সুইচ, মিডিয়া সিক বা নেটওয়ার্ক কনজেশনের কারণে বাফারিং শুরু করে তখন কল করুন।notifyPauseState(): যখন কোনও ব্যবহারকারী প্লেয়িং মিডিয়া থামায় বা থামায় তখন কল করে।notifyPlayoutRate(): যখন কোনও ব্যবহারকারী প্লেব্যাকের গতি একটি নতুন মান (যেমন, 1.25x) এ আপডেট করে তখন কল করুন।notifyReady(): বাফারিং সম্পন্ন হলে এবং মিডিয়া চালানোর জন্য প্রস্তুত হলে কল করুন।notifySeekToTimestamp(): যখন কোনও ব্যবহারকারী স্পষ্টভাবে প্লে আউট পজিশন পরিবর্তন করে তখন কল করুন।notifySwitchToMedia(): সক্রিয়ভাবে চলমান মিডিয়া পরিবর্তন হলেই কল করুন। উদাহরণস্বরূপ, ব্যবহারকারী একটি নতুন ভিডিও নির্বাচন করেন, অথবা অটোপ্লে পরবর্তী ভিডিও শুরু করে।