Co-Watching API প্রয়োগ করুন

প্রারম্ভিক অ্যাক্সেস প্রোগ্রাম: এই বৈশিষ্ট্যটি শুধুমাত্র সীমিত প্রাকদর্শনে উপলব্ধ ছিল, একটি প্রাথমিক অ্যাক্সেস প্রোগ্রামের মাধ্যমে। এই প্রোগ্রামটি এখন নতুন সাইনআপের জন্য বন্ধ।

Co-Watching API আপনার অ্যাপের বিষয়বস্তু দেখার বা শোনা একাধিক অংশগ্রহণকারীদের মিটিংয়ের অভিজ্ঞতা পরিচালনা করে।

এই নির্দেশিকাটি ব্যাখ্যা করে কিভাবে কো-ওয়াচিং এপিআই বাস্তবায়ন করতে হয়।

শুরু করুন

Co-Watching API ব্যবহার করতে, আপনাকে প্রথমে একটি Meet অ্যাড-অন স্থাপন করতে হবে। একবার আপনি এই পদক্ষেপগুলি সম্পন্ন করার পরে, আপনি আপনার নতুন অ্যাড-অনের মধ্যে থেকে কো-ওয়াচিং API ব্যবহার শুরু করতে পারেন।

Co-Watching API ব্যবহার করতে, একটি AddonSession অবজেক্ট পেয়ে শুরু করুন, যেটি Google Meet সহ-অ্যাক্টিভিটিগুলির জন্য এন্ট্রি পয়েন্ট হিসাবে কাজ করে:

টাইপস্ক্রিপ্ট

const session = await window.meet.addon.createAddonSession({
    cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});

আপনার Google ক্লাউড প্রকল্পের প্রকল্প নম্বর দিয়ে 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() : যখনই সক্রিয়ভাবে বাজানো মিডিয়া পরিবর্তন হয় তখন কল করুন। উদাহরণস্বরূপ, ব্যবহারকারী একটি নতুন ভিডিও নির্বাচন করে বা অটোপ্লে পরবর্তী ভিডিও শুরু করে।