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

কোটলিন | জাভা

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

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

পাবলিক ফাংশন

newSessionBuilder

fun newSessionBuilder(handler: AddonSessionHandler!): AddonSession.Builder!

একটি নতুন অ্যাড-অন সেশনের জন্য একজন নির্মাতাকে ফেরত দেয়। সেশন শুরু হবে শুধুমাত্র একবার 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 দেখুন।

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

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

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

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

fun notifyAddonFailureEvent(
    appContext: Context!,
    failureEventType: AddonClient.AddonFailureEventType!
): Unit

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

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

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

registerMeeting Status Listener

fun registerMeetingStatusListener(
    appContext: Context!,
    listener: MeetingStatusListener!,
    handler: Optional<Handler!>!
): Unit

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

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

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

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

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

unregisterMeeting Status Listener

fun unregisterMeetingStatusListener(appContext: Context!): Unit

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

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

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