Google Meet Live Sharing Co-Watching API আপনার অ্যাপে কন্টেন্ট দেখা বা শোনা একাধিক অংশগ্রহণকারীর মিটিং অভিজ্ঞতা পরিচালনা করে।
এই নির্দেশিকাটি ব্যাখ্যা করে কিভাবে কো-ওয়াচিং এপিআই বাস্তবায়ন করতে হয়।
একটি CoWatchingClient
তৈরি করুন
শুরু করার জন্য, Get start এ আপনার তৈরি করা 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
: বাফারিং সম্পূর্ণ হলে কল করুন এবং মিডিয়া এখন চালানোর জন্য প্রস্তুত।