CoWatchingClient

کاتلین | جاوا

@PublicApi
public interface CoWatchingClient

---

---

برنامه دسترسی زودهنگام: این ویژگی فقط در پیش نمایش محدود، از طریق یک برنامه دسترسی زودهنگام در دسترس بود. این برنامه اکنون برای ثبت نام های جدید بسته شده است.

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

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

خلاصه

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

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

ثابت ها

MAX_PLAYOUT_RATE

default static final double MAX_PLAYOUT_RATE = 2.0

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

MAX_SEEKS_PER_SECOND

default static final double MAX_SEEKS_PER_SECOND = 0.9

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

روش های عمومی

notifyBuffering

abstract void notifyBuffering(Duration mediaPlayoutPosition)

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

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

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

notifyEnded

abstract void notifyEnded(Duration mediaPlayoutPosition)

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

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

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

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

اطلاع PauseState

abstract void notifyPauseState(boolean paused, Duration mediaPlayoutPosition)

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

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

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

notifyPlayoutRate

abstract void notifyPlayoutRate(double rate, Duration mediaPlayoutPosition)

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

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

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

notifyQueueUpdate

abstract void notifyQueueUpdate(CoWatchingQueue queue)

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

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

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

notifyReady

abstract void notifyReady(Duration mediaPlayoutPosition)

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

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

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

notifySeekToTimestamp

abstract void notifySeekToTimestamp(Duration mediaPlayoutPosition)

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

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

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

notifySwitchedToMedia

abstract void notifySwitchedToMedia(
    String mediaTitle,
    String mediaId,
    Duration mediaPlayoutPosition
)

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

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

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

notifySwitchedToMedia

abstract void notifySwitchedToMedia(
    String mediaTitle,
    String mediaId,
    Duration mediaPlayoutPosition,
    CoWatchingQueue queue
)

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

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

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