অ্যাডনক্লায়েন্ট

কোটলিন | জাভা

@PublicApi
public interface AddonClient

---

---

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

একটি অ্যাড-অন সেশন শুরু এবং বন্ধ করার জন্য প্রাথমিক ইন্টারফেস।

দ্রষ্টব্য: একবারে শুধুমাত্র একটি অধিবেশন সক্রিয় হতে পারে, অন্যথায় begin ফিরে আসা ListenableFuture একটি এর সাথে সমাধান করবে। একটি সেশন নিজে থেকেই শেষ হতে পারে (যেমন ব্যবহারকারী মিটিং ছেড়ে চলে গেছে) এবং onSessionEnded কল করতে পারে, অথবা endSession কল করে সেশনটি বন্ধ করা হতে পারে।

নমুনা ব্যবহার:

class AwesomeAddonSessionHandler implements AddonSessionHandler {}

class AwesomeCoWatchingHandler implements CoWatchingHandler {}

public void registerStatusListener() {
  AddonClient meetClient = AddonClientFactory.getClient();
  meetClient.registerMeetingStatusListener(
      appContext,
      meetingStatus -> {
        switch (meetingStatus.status()) {
          case NO_MEETING:
            // User is not in a meeting currently.
            break;
          case MEETING:
            // User is in a meeting, check if they want to start an add-on session.
            showStartAddonSessionDialog();
            break;
          case ADDON_SESSION:
            // User is in a meeting that already hosts an add-on session, check if they want
            // to join the ongoing session.
            showJoinAddonSessionDialog();
            break;
        }
      },
      Optional.empty());
}

public ListenableFuture<AddonClient> initialSetup() {
  AddonClient meetClient = AddonClientFactory.getClient();
  return meetClient
      .newSessionBuilder(appContext, new AwesomeAddonSessionHandler())
      .withCoWatching(new AwesomeCoWatchingHandler())
      .begin();
}

সারসংক্ষেপ

নেস্টেড প্রকার
@ PublicApi public enum AddonClient.AddonFailureEventType একটি অ্যাড-অন সেশনের আগে, চলাকালীন বা পরে ঘটে যাওয়া ব্যর্থতার ইভেন্টের প্রতিনিধিত্ব করে।

পাবলিক পদ্ধতি
abstract AddonSession.Builder	newSessionBuilder ( AddonSessionHandler handler) একটি নতুন অ্যাড-অন সেশনের জন্য একজন নির্মাতাকে ফেরত দেয়।
abstract void	notifyAddonFailureEvent ( Context appContext, AddonClient.AddonFailureEventType failureEventType ) একটি অ্যাড-অন ব্যর্থতার ইভেন্টের Meet সূচিত করে।
abstract void	registerMeetingStatusListener ( Context appContext, MeetingStatusListener listener, Optional < Handler > handler ) মিটিং এবং অ্যাড-অন সেশনের অবস্থার পরিবর্তন সম্পর্কে অবহিত হওয়ার জন্য একজন শ্রোতাকে নিবন্ধন করে।
abstract void	unregisterMeetingStatusListener ( Context appContext) MeetingStatus পরিবর্তনের জন্য একজন সক্রিয় শ্রোতাকে নিবন্ধনমুক্ত করে।

পাবলিক পদ্ধতি

newSessionBuilder

abstract AddonSession.Builder newSessionBuilder(AddonSessionHandler handler)

একটি নতুন অ্যাড-অন সেশনের জন্য একজন নির্মাতাকে ফেরত দেয়। সেশন শুরু হবে শুধুমাত্র একবার begin ডাকা হয়.

একটি সেশন শুরু করতে, প্রথমে withCoWatching withCoDoing বা উভয়ই এই নির্মাতার সাথে চেইন করুন।

নমুনা ব্যবহার:

ListenableFuture<AddonSession> session = meetClient
    .newSessionBuilder(appContext, new AwesomeAddonSessionHandler())
    .withCoWatching(new AwesomeCoWatchingHandler())
    .withCoDoing(new AwesomeCoDoingHandler())
    .begin();

অংশগ্রহণকারীর মেটাডেটা কার্যকারিতা লাভ করতে, প্রাথমিক অবস্থা নির্দিষ্ট করতে এবং অন্যান্য অংশগ্রহণকারীদের জন্য একজন শ্রোতা নিবন্ধন করতে বিল্ডার চেইনে অংশগ্রহণকারী মেটাডেটার সাথে কল করুন। উদাহরণ স্বরূপ:

ListenableFuture<AddonSession> session = meetClient
    .newSessionBuilder(new AwesomeAddonSessionHandler())
    .withCoWatching(new AwesomeCoWatchingHandler())
    .withParticipantMetadata(new AwesomeMetadataHandler(), myMetadataBytes)
    .begin(appContext);

কিভাবে একটি সেশন শুরু হয় তার আরো বিস্তারিত জানার জন্য begin দেখুন।

পরামিতি
AddonSessionHandler handler	সমস্ত অ্যাড-অন সেশনে প্রযোজ্য কলব্যাক

রিটার্নস
AddonSession.Builder	একটি নতুন AddonSession উদাহরণের জন্য একজন নির্মাতা

নিক্ষেপ করে
java.lang.NullPointerException	যদি প্রদত্ত আর্গুমেন্ট শূন্য হয়

বিজ্ঞপ্তি অ্যাডনফেইল্যুর ইভেন্ট

abstract void notifyAddonFailureEvent(
    Context appContext,
    AddonClient.AddonFailureEventType failureEventType
)

একটি অ্যাড-অন ব্যর্থতার ইভেন্টের Meet সূচিত করে।

পরামিতি
Context appContext	অ্যাপ্লিকেশনটির getApplicationContext মান যেটি Meet অ্যাড-অনের SDK ব্যবহার করছে
AddonClient.AddonFailureEventType failureEventType	লাইভ শেয়ারিং সেশনের আগে, চলাকালীন বা পরে ব্যর্থতার ইভেন্টের ধরন

নিক্ষেপ করে
java.lang.NullPointerException	যদি প্রদত্ত আর্গুমেন্ট শূন্য হয়

registerMeeting Status Listener

abstract void registerMeetingStatusListener(
    Context appContext,
    MeetingStatusListener listener,
    Optional<Handler> handler
)

মিটিং এবং অ্যাড-অন সেশনের অবস্থার পরিবর্তন সম্পর্কে অবহিত হওয়ার জন্য একজন শ্রোতাকে নিবন্ধন করে।

নিম্নলিখিত স্থিতিগুলির একটির কারণে নিবন্ধিত শ্রোতাকে অবহিত করা হবে:

• MEETING - Meet অ্যাপে একটি সক্রিয় মিটিং আছে
• ADDON_SESSION - একটি সক্রিয় অ্যাড-অন সেশন আছে৷ এটি তখনই সম্ভব যদি একটি সক্রিয় মিটিং থাকে।
• NO_MEETING - কোন মিটিং বা অ্যাড-অন সেশন নেই

পরামিতি
Context appContext	অ্যাপ্লিকেশনটির getApplicationContext মান যেটি Meet অ্যাড-অনের SDK ব্যবহার করছে
MeetingStatusListener listener	MeetingStatusListener স্থিতি পরিবর্তন সম্পর্কে অবহিত করা হবে
Optional < Handler > handler	অ্যাসিঙ্ক্রোনাস এক্সিকিউশনের জন্য Handler একটি Optional । যদি একটি সরবরাহ করা না হয়, ফলস্বরূপ যুক্তি UI থ্রেডে চলতে পারে।

নিক্ষেপ করে
java.lang.IllegalStateException	যদি এই পদ্ধতিটি আগে থেকেই নিবন্ধিত শ্রোতার জন্য unregisterMeetingStatusListener কল করার আগে কল করা হয়

unregisterMeeting Status Listener

abstract void unregisterMeetingStatusListener(Context appContext)

MeetingStatus পরিবর্তনের জন্য একজন সক্রিয় শ্রোতাকে নিবন্ধনমুক্ত করে।

পরামিতি
Context appContext	অ্যাপ্লিকেশনটির getApplicationContext মান যেটি Meet অ্যাড-অনের SDK ব্যবহার করছে

নিক্ষেপ করে
java.lang.IllegalStateException	যদি এই পদ্ধতিটি কল করার আগে কল করা হয় registerMeetingStatusListener .