Co-Watching API আপনার অ্যাপের বিষয়বস্তু দেখার বা শোনা একাধিক অংশগ্রহণকারীদের মিটিংয়ের অভিজ্ঞতা পরিচালনা করে।
এই নির্দেশিকাটি ব্যাখ্যা করে কিভাবে কো-ওয়াচিং এপিআই বাস্তবায়ন করতে হয়।
শুরু করুন
Co-Watching API ব্যবহার করতে, আপনাকে প্রথমে একটি Meet অ্যাড-অন তৈরি করতে হবে। একবার আপনি এই পদক্ষেপগুলি সম্পন্ন করার পরে, আপনি আপনার নতুন অ্যাড-অনের মধ্যে থেকে কো-ওয়াচিং API ব্যবহার শুরু করতে পারেন।
Co-Watching API ব্যবহার করতে, একটি AddonSession
পাওয়ার মাধ্যমে শুরু করুন, যা সহ-ক্রিয়াকলাপগুলির জন্য এন্ট্রি পয়েন্ট হিসাবে কাজ করে:
টাইপস্ক্রিপ্ট
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
একটি CoWatchingClient
তৈরি করুন
শুরু করার জন্য, আপনার AddonSession
থেকে একটি createCoWatchingClient
তৈরি করুন।
একটি CoWatchingCient
তৈরি করতে, AddonSession.createCoWatchingClient
পদ্ধতিতে কল করুন এবং একটি CoWatchingDelegate
প্রদান করুন।
CoWatchingDelegate
হল কিভাবে Co-Watching API আপনার অ্যাপ্লিকেশন আপডেট করে যখনই এটি একটি নতুন অবস্থা উপলব্ধ থাকে। এটি প্রত্যাশিত যে, যখন CoWatchingDelegate.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
তৈরি করেছেন তা এই পরিস্থিতিতে আপডেট করা প্লেআউট পজিশন পেতে পরিচালনা করে।
আপনি এই পদ্ধতিগুলি ব্যবহার করে সহ-দেখার অবস্থা নিয়ন্ত্রণ করতে পারেন:
-
CoWatchingClient.notifySwitchToMedia
: যখনই সক্রিয়ভাবে বাজানো মিডিয়া পরিবর্তন হয় তখন কল করুন। উদাহরণস্বরূপ, ব্যবহারকারী একটি নতুন ভিডিও নির্বাচন করে বা অটোপ্লে পরবর্তী ভিডিও শুরু করে। -
CoWatchingClient.notifyPauseState
: যখন একজন ব্যবহারকারী প্লেয়িং মিডিয়াকে বিরতি দেয় বা আনপজ করে তখন কল করুন। -
CoWatchingClient.notifySeekToTimestamp
: যখন একজন ব্যবহারকারী স্পষ্টভাবে প্লে আউট অবস্থান পরিবর্তন করে তখন কল করুন। -
CoWatchingClient.notifyPlayoutRate
: যখন একজন ব্যবহারকারী প্লেব্যাকের গতি একটি নতুন মান (উদাহরণস্বরূপ, 1.25x) আপডেট করে তখন কল করুন। -
CoWatchingClient.notifyBuffering
: একটি পূর্ববর্তী মিডিয়া সুইচ, মিডিয়া অনুসন্ধান বা নেটওয়ার্ক কনজেশন থেকে বাফারিংয়ের কারণে ব্যবহারকারীর অ্যাপ বাফারিং শুরু হলে কল করুন। -
CoWatchingClient.notifyReady
: বাফারিং সম্পূর্ণ হলে কল করুন এবং মিডিয়া এখন চালানোর জন্য প্রস্তুত।