অ্যাডঅনসেশন

কোটলিন | জাভা

@PublicApi
interface AddonSession

---

একটি অ্যাড-অন সেশন।

সমস্ত অ্যাড-অন সেশনে সাধারণ পদ্ধতিগুলি রয়েছে৷ সহ-দেখা এবং সহ-করণ অ্যাক্সেসের জন্য, যথাক্রমে getCoWatching এবং getCoDoing কল করুন।

সারসংক্ষেপ

নেস্টেড প্রকার
@ PublicApi interface AddonSession.Builder AddonSession এর জন্য একজন নির্মাতা।

পাবলিক ফাংশন
ListenableFuture < Void !>!	endSession () অ্যাড-অন সেশন শেষ করে এবং Meet অ্যাপ থেকে সংযোগ বিচ্ছিন্ন করে।
Unit	endSuspension () স্থগিত অবস্থা থেকে প্রস্থান করুন.
CoDoingClient !	getCoDoing () CoDoingClient উদাহরণ প্রদান করে।
CoWatchingClient !	getCoWatching () CoWatchingClient উদাহরণ প্রদান করে।
AddonMeetingInfo !	getMeetingInfo () সংযুক্ত মিটিং সম্পর্কে তথ্য প্রদান করে, যেমন মিটিং URL।
Boolean	isSessionEnded () সেশন শেষ হলে true ফেরত দেয়।
Boolean	isSuspended () অধিবেশন স্থগিত কিনা নির্দেশ করে।
Unit	resetCollaborationStartingState () অ্যাড-অনের শুরুর অবস্থা রিসেট করে।
Unit	suspend () অ্যাড-অন সেশন স্থগিত করে।
Unit	updateCollaborationStartingState ( startingState: CollaborationStartingState ! ) অ্যাড-অনের শুরুর অবস্থা আপডেট করে।
Unit	updateParticipantMetadata (metadata: ByteArray !) এই অংশগ্রহণকারীর জন্য মেটাডেটা আপডেট করে।

পাবলিক ফাংশন

শেষ অধিবেশন

fun endSession(): ListenableFuture<Void!>!

অ্যাড-অন সেশন শেষ করে এবং Meet অ্যাপ থেকে সংযোগ বিচ্ছিন্ন করে। এটি Meet-কে মিটিং শেষ করতে বাধ্য করে না বা এটি ব্যবহারকারীকে মিটিং ছেড়ে যেতে বাধ্য করে না।

যদি অধিবেশন ইতিমধ্যেই শেষ হয়ে যায়, এটি একটি নো-অপ; এটি একটি ব্যতিক্রম নিক্ষেপ করবে না.

রিটার্নস
ListenableFuture < Void !>!	একটি ListenableFuture যা সাফল্যের মূল্যায়ন করে বা একটি AddonException যদি কোনো অপ্রত্যাশিত ত্রুটি থাকে

শেষ সাসপেনশন

fun endSuspension(): Unit

স্থগিত অবস্থা থেকে প্রস্থান করুন. অ্যাড-অন অ্যাপটি আবার আপডেট পাঠাতে এবং গ্রহণ করতে সক্ষম।

যদি এটি স্থগিত অবস্থায় না থাকে তবে এটি একটি নো-অপ।

নিক্ষেপ করে
java.lang.IllegalStateException	যদি অধিবেশন শেষ হয়। এটি হয় endSession জন্য একটি সুস্পষ্ট কল হতে পারে বা এটি একটি বাহ্যিক কারণে হতে পারে যা onSessionEnded এর মাধ্যমে প্রকাশ করা হবে।

getCoDoing

fun getCoDoing(): CoDoingClient!

CoDoingClient উদাহরণ প্রদান করে।

নিক্ষেপ করে
java.lang.IllegalStateException	যদি সেশনটি withCoDoing কল না করে তৈরি করা হয় বা সেশনটি শেষ হয়ে যায়

getCoWatching

fun getCoWatching(): CoWatchingClient!

CoWatchingClient উদাহরণ প্রদান করে।

নিক্ষেপ করে
java.lang.IllegalStateException	যদি সেশনটি withCoWatching কল না করে তৈরি করা হয় বা সেশনটি শেষ হয়ে যায়

মিটিং ইনফো

fun getMeetingInfo(): AddonMeetingInfo!

সংযুক্ত মিটিং সম্পর্কে তথ্য প্রদান করে, যেমন মিটিং URL।

নিক্ষেপ করে
java.lang.IllegalStateException	যদি অধিবেশন শেষ হয়। এটি হয় endSession জন্য একটি সুস্পষ্ট কল হতে পারে বা এটি একটি বাহ্যিক কারণে হতে পারে যা onSessionEnded এর মাধ্যমে প্রকাশ করা হবে।

isSessionEnded

fun isSessionEnded(): Boolean

সেশন শেষ হলে true ফেরত দেয়। এটি হয় endSession একটি স্পষ্ট কল থেকে হতে পারে বা এটি একটি বাহ্যিক কারণে হতে পারে যা onSessionEnded এর মাধ্যমে প্রকাশ করা হবে।

নিক্ষেপ করে
java.lang.IllegalStateException	যদি অধিবেশন শেষ হয়। এটি হয় endSession জন্য একটি সুস্পষ্ট কল হতে পারে বা এটি একটি বাহ্যিক কারণে হতে পারে যা onSessionEnded এর মাধ্যমে প্রকাশ করা হবে

স্থগিত

fun isSuspended(): Boolean

অধিবেশন স্থগিত কিনা নির্দেশ করে। suspend এবং endSuspension দেখুন।

নিক্ষেপ করে
java.lang.IllegalStateException	যদি অধিবেশন শেষ হয়। এটি হয় endSession জন্য একটি সুস্পষ্ট কল হতে পারে বা এটি একটি বাহ্যিক কারণে হতে পারে যা onSessionEnded এর মাধ্যমে প্রকাশ করা হবে।

resetCollaborationStartingState

fun resetCollaborationStartingState(): Unit

অ্যাড-অনের শুরুর অবস্থা রিসেট করে। এটি অন্যান্য অংশগ্রহণকারীদের দ্বারা পূর্বে প্রাপ্ত প্রারম্ভিক অবস্থা সাফ করবে। প্রারম্ভিক অবস্থা শুধুমাত্র সূচনাকারী দ্বারা পুনরায় সেট করা যেতে পারে।

স্থগিত করা

fun suspend(): Unit

অ্যাড-অন সেশন স্থগিত করে। এটি Meet অ্যাপ থেকে সংযোগ বিচ্ছিন্ন করে না। এর ফলে SDK আপনার CoDoingHandler এবং CoWatchingHandler এ আপডেট পাঠানো এড়াতে পারে, এবং SDK-কে কলগুলিকে অবহিত করার জন্য কলগুলিকে উপেক্ষা করে এবং গ্লোবাল স্টেট আপডেট করার জন্য কলগুলিকে উপেক্ষা করে৷

যদি সেশনটি ইতিমধ্যেই স্থগিত করা হয় তবে এটি একটি নো-অপ।

উদাহরণস্বরূপ, যখন একজন ব্যবহারকারী, কিন্তু প্রত্যেক ব্যবহারকারীর প্লেব্যাক কোনো বিজ্ঞাপন দেখার জন্য বাধাপ্রাপ্ত হয়, যখন কোনো ব্যবহারকারী অ্যাপ্লিকেশন ব্যাকগ্রাউন্ড করে, ইত্যাদির সময় আপনি কল suspend বেছে নিতে পারেন।

নিক্ষেপ করে
java.lang.IllegalStateException	যদি অধিবেশন শেষ হয়। এটি হয় endSession জন্য একটি সুস্পষ্ট কল হতে পারে বা এটি একটি বাহ্যিক কারণে হতে পারে যা onSessionEnded এর মাধ্যমে প্রকাশ করা হবে।

updateCollaborationStartingState

fun updateCollaborationStartingState(
    startingState: CollaborationStartingState!
): Unit

অ্যাড-অনের শুরুর অবস্থা আপডেট করে। অন্যান্য অংশগ্রহণকারীরা যখন সহযোগিতা করার আমন্ত্রণ গ্রহণ করে তখন এটি তারা গ্রহণ করে। প্রারম্ভিক অবস্থা শুধুমাত্র সূচনাকারী দ্বারা আপডেট করা যেতে পারে।

পরামিতি
startingState: CollaborationStartingState !	অ্যাড-অনের শুরুর অবস্থা

অংশগ্রহণকারী মেটাডেটা আপডেট করুন

fun updateParticipantMetadata(metadata: ByteArray!): Unit

এই অংশগ্রহণকারীর জন্য মেটাডেটা আপডেট করে।

অন্যান্য অংশগ্রহণকারীদের থেকে মেটাডেটা পেতে, একজন হ্যান্ডলারকে অবশ্যই AddonSession তৈরি করার সময় ParticipantMetadata-এর সাথে কল করে নিবন্ধিত হতে হবে।

এনকোড করা মেটাডেটা প্রতি অংশগ্রহণকারী MAX_INDIVIDUAL_PARTICIPANT_METADATA_SIZE_BYTES বাইটে সীমাবদ্ধ।

পরামিতি
metadata: ByteArray !	মেটাডেটার একটি এনকোডেড ব্লব যা স্থানীয় অংশগ্রহণকারীর জন্য প্রাসঙ্গিক মেটাডেটা বর্ণনা করে

নিক্ষেপ করে
java.lang.IllegalArgumentException	যদি প্রদত্ত মেটাডেটা MAX_INDIVIDUAL_PARTICIPANT_METADATA_SIZE_BYTES বাইট অতিক্রম করে
java.lang.IllegalStateException	যদি অধিবেশন শেষ হয়। এটি হয় endSession জন্য একটি সুস্পষ্ট কল হতে পারে বা এটি একটি বাহ্যিক কারণে হতে পারে যা onSessionEnded এর মাধ্যমে প্রকাশ করা হবে।