CoWatchingClient

کاتلین | جاوا

@PublicApi
interface CoWatchingClient

---

یک جلسه تماشای مشترک را نشان می دهد.

Meet را از اقدامات اخیر کاربر (مانند پخش/مکث/جستجو) و عوامل محیطی مانند تأخیرهای ناشی از رسانه بافر مطلع می‌کند.

خلاصه

ثابت ها
const Double	MAX_PLAYOUT_RATE = 2.0 حداکثر نرخ پخش مجاز.
const Double	MAX_SEEKS_PER_SECOND = 0.9 حداکثر تعداد جستجوهای مجاز در هر ثانیه.

توابع عمومی
Unit	notifyBuffering (mediaPlayoutPosition: Duration !) به Meet اطلاع می دهد که رسانه به دلیل بافر، به دلیل سوئیچ رسانه قبلی، جستجوی رسانه یا ازدحام معمولی شبکه آماده پخش نیست.
Unit	notifyEnded (mediaPlayoutPosition: Duration !) به Meet اطلاع می دهد که پخش کننده رسانه به پایان رسانه فعلی رسیده است.
Unit	notifyPauseState (paused: Boolean , mediaPlayoutPosition: Duration !) به Meet اطلاع دهید که کاربر پخش رسانه را متوقف یا لغو کرده است، بنابراین Meet می‌تواند آن عملکرد را برای کاربران دیگر منعکس کند.
Unit	notifyPlayoutRate (rate: Double , mediaPlayoutPosition: Duration !) به Meet اطلاع می دهد که کاربر نرخ پخش رسانه را به روز کرده است (مثلاً
Unit	notifyQueueUpdate (queue: CoWatchingQueue !) به Meet اطلاع دهید که صف تغییر کرده است، بنابراین Meet می‌تواند آن را برای کاربران دیگر منعکس کند.
Unit	notifyReady (mediaPlayoutPosition: Duration !) به Meet اطلاع می‌دهد که بافر کامل شده است و رسانه اکنون آماده پخش است و از مهر زمانی ارائه شده شروع می‌شود.
Unit	notifySeekToTimestamp (mediaPlayoutPosition: Duration !) به Meet اطلاع دهید که کاربر نقطه پخش رسانه را جستجو کرده است، بنابراین Meet بتواند آن عملکرد را برای کاربران دیگر منعکس کند.
Unit	notifySwitchedToMedia ( mediaTitle: String !, mediaId: String !, mediaPlayoutPosition: Duration ! ) به Meet اطلاع دهید که کاربر رسانه را تغییر داده است، بنابراین Meet بتواند آن را به سایر کاربران منتقل کند.
Unit	notifySwitchedToMedia ( mediaTitle: String !, mediaId: String !, mediaPlayoutPosition: Duration !, queue: CoWatchingQueue ! ) به Meet اطلاع دهید که کاربر رسانه را با یک به‌روزرسانی صف شبیه‌سازی تغییر داده است، بنابراین Meet می‌تواند آن را به سایر کاربران منتقل کند.

ثابت ها

MAX_PLAYOUT_RATE

const val MAX_PLAYOUT_RATE = 2.0: Double

حداکثر نرخ پخش مجاز.

MAX_SEEKS_PER_SECOND

const val MAX_SEEKS_PER_SECOND = 0.9: Double

حداکثر تعداد جستجوهای مجاز در هر ثانیه.

توابع عمومی

notifyBuffering

fun notifyBuffering(mediaPlayoutPosition: Duration!): Unit

به Meet اطلاع می دهد که رسانه به دلیل بافر، به دلیل سوئیچ رسانه قبلی، جستجوی رسانه یا ازدحام معمولی شبکه آماده پخش نیست.

مولفه های
mediaPlayoutPosition: Duration !	موقعیتی که رسانه در آن متوقف شده و منتظر تکمیل بافر است

پرتاب می کند
java.lang.NullPointerException	اگر mediaPlayoutPosition تهی باشد
com.google.android.meet.addons.AddonException	اگر یک خطای غیرمنتظره وجود داشته باشد
java.lang.IllegalStateException	اگر پس از پایان جلسه تماشای مشترک تماس گرفته شود

notifyEnded

fun notifyEnded(mediaPlayoutPosition: Duration!): Unit

به Meet اطلاع می دهد که پخش کننده رسانه به پایان رسانه فعلی رسیده است.

توجه: اگر به محض پایان یک رسانه، notifySwitchedToMedia از طریق مکانیسم پخش خودکار فراخوانی شود، فراخوانی این روش الزامی نیست (اگرچه مضر نیست).

مولفه های
mediaPlayoutPosition: Duration !	موقعیت نهایی بازیکن

پرتاب می کند
java.lang.NullPointerException	اگر mediaPlayoutPosition تهی باشد
com.google.android.meet.addons.AddonException	اگر یک خطای غیرمنتظره وجود داشته باشد
java.lang.IllegalStateException	اگر پس از پایان جلسه تماشای مشترک تماس گرفته شود

اطلاع PauseState

fun notifyPauseState(paused: Boolean, mediaPlayoutPosition: Duration!): Unit

به Meet اطلاع دهید که کاربر پخش رسانه را متوقف یا لغو کرده است، بنابراین Meet می‌تواند آن عملکرد را برای کاربران دیگر منعکس کند.

مولفه های
paused: Boolean	true در صورت توقف یا false در صورت از سرگیری پخش
mediaPlayoutPosition: Duration !	موقعیتی که رسانه در آن متوقف یا متوقف شد

پرتاب می کند
java.lang.NullPointerException	اگر mediaPlayoutPosition تهی باشد
com.google.android.meet.addons.AddonException	اگر یک خطای غیرمنتظره وجود داشته باشد
java.lang.IllegalStateException	اگر پس از پایان جلسه تماشای مشترک تماس گرفته شود

notifyPlayoutRate

fun notifyPlayoutRate(rate: Double, mediaPlayoutPosition: Duration!): Unit

به Meet اطلاع می دهد که کاربر نرخ پخش رسانه (مثلاً 1.25x) را به مقدار جدیدی به روز کرده است.

مولفه های
rate: Double	سرعتی که اکنون رسانه ها با آن پخش می شوند
mediaPlayoutPosition: Duration !	موقعیت فعلی بازیکن

پرتاب می کند
java.lang.IllegalStateException	اگر rate عدد مثبتی نباشد
java.lang.IllegalStateException	اگر rate بیشتر از MAX_PLAYOUT_RATE باشد
com.google.android.meet.addons.AddonException	اگر یک خطای غیرمنتظره وجود داشته باشد
java.lang.IllegalStateException	اگر پس از پایان جلسه تماشای مشترک تماس گرفته شود

notifyQueueUpdate

fun notifyQueueUpdate(queue: CoWatchingQueue!): Unit

به Meet اطلاع دهید که صف تغییر کرده است، بنابراین Meet می‌تواند آن را برای کاربران دیگر منعکس کند.

مولفه های
queue: CoWatchingQueue !	اطلاعاتی در مورد صف برنامه افزودنی

پرتاب می کند
java.lang.NullPointerException	اگر queue صفر باشد
com.google.android.meet.addons.AddonException	اگر یک خطای غیرمنتظره وجود داشته باشد
java.lang.IllegalStateException	اگر پس از پایان جلسه تماشای مشترک تماس گرفته شود

notifyReady

fun notifyReady(mediaPlayoutPosition: Duration!): Unit

به Meet اطلاع می‌دهد که بافر کامل شده است و رسانه اکنون آماده پخش است و از مهر زمانی ارائه شده شروع می‌شود.

مولفه های
mediaPlayoutPosition: Duration !	موقعیتی که رسانه در آن بافر شده و آماده پخش است

پرتاب می کند
java.lang.NullPointerException	اگر mediaPlayoutPosition تهی باشد
com.google.android.meet.addons.AddonException	اگر یک خطای غیرمنتظره وجود داشته باشد
java.lang.IllegalStateException	اگر پس از پایان جلسه تماشای مشترک تماس گرفته شود

notifySeekToTimestamp

fun notifySeekToTimestamp(mediaPlayoutPosition: Duration!): Unit

به Meet اطلاع دهید که کاربر نقطه پخش رسانه را جستجو کرده است، بنابراین Meet بتواند آن عملکرد را برای کاربران دیگر منعکس کند.

مولفه های
mediaPlayoutPosition: Duration !	مهر زمانی که کاربر به دنبال آن است

پرتاب می کند
java.lang.NullPointerException	اگر mediaPlayoutPosition تهی باشد
com.google.android.meet.addons.AddonException	اگر یک خطای غیرمنتظره وجود داشته باشد
java.lang.IllegalStateException	اگر پس از پایان جلسه تماشای مشترک تماس گرفته شود
java.lang.IllegalStateException	اگر تعداد جستجوها در ثانیه از MAX_SEEKS_PER_SECOND بیشتر باشد

notifySwitchedToMedia

fun notifySwitchedToMedia(
    mediaTitle: String!,
    mediaId: String!,
    mediaPlayoutPosition: Duration!
): Unit

به Meet اطلاع دهید که کاربر رسانه را تغییر داده است، بنابراین Meet بتواند آن را به سایر کاربران منتقل کند.

مولفه های
mediaTitle: String !	عنوان رسانه تغییر کرد. زمانی که سایر کاربران در نظر دارند به جلسه تماشای مشترک متصل شوند، این عنوان در رابط کاربری Meet منعکس خواهد شد.
mediaId: String !	URI رشته رسانه به
mediaPlayoutPosition: Duration !	موقعیتی که رسانه ها بازی را در آن آغاز کردند

پرتاب می کند
java.lang.NullPointerException	اگر mediaId یا mediaPlayoutPosition تهی باشد
com.google.android.meet.addons.AddonException	اگر یک خطای غیرمنتظره وجود داشته باشد
java.lang.IllegalStateException	اگر پس از پایان جلسه تماشای مشترک تماس گرفته شود

notifySwitchedToMedia

fun notifySwitchedToMedia(
    mediaTitle: String!,
    mediaId: String!,
    mediaPlayoutPosition: Duration!,
    queue: CoWatchingQueue!
): Unit

به Meet اطلاع دهید که کاربر رسانه را با یک به‌روزرسانی صف شبیه‌سازی تغییر داده است، بنابراین Meet می‌تواند آن را به سایر کاربران منتقل کند.

مولفه های
mediaTitle: String !	عنوان رسانه تغییر کرد. زمانی که سایر کاربران در نظر دارند به جلسه تماشای مشترک متصل شوند، این عنوان در رابط کاربری Meet منعکس خواهد شد.
mediaId: String !	URI رشته رسانه به
mediaPlayoutPosition: Duration !	موقعیتی که رسانه ها بازی را در آن آغاز کردند
queue: CoWatchingQueue !	اطلاعاتی در مورد صف برنامه افزودنی

پرتاب می کند
java.lang.NullPointerException	اگر mediaId ، mediaPlayoutPosition یا queue خالی باشد
com.google.android.meet.addons.AddonException	اگر یک خطای غیرمنتظره وجود داشته باشد
java.lang.IllegalStateException	اگر پس از پایان جلسه تماشای مشترک تماس گرفته شود