هل يمكنك تخصيص 5 دقائق؟ ساعِدنا على تحسين مستندات المطوِّرين على Google Meet من خلال المشاركة في استطلاع سريع.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

CoWatchingClient

Kotlin |Java

@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 بأنّ المستخدم قد أوقف تشغيل الوسائط مؤقتًا أو ألغى الإيقاف المؤقت حتى يتمكّن المستخدمون الآخرون من النسخ المطابق لهذا الإجراء.
`abstract void`	`notifyPlayoutRate(double rate, Duration mediaPlayoutPosition)` تُعلِم Meet بأنّ المستخدم قد عدَّل معدّل تشغيل الوسائط (مثل
`abstract void`	`notifyQueueUpdate(CoWatchingQueue queue)` عليك إبلاغ Meet بأنّه تم تغيير قائمة المحتوى التالي كي تتم مطابقته مع المستخدمين الآخرين.
`abstract void`	`notifyReady(Duration mediaPlayoutPosition)` يتم إعلام Meet باكتمال التخزين المؤقت وأنّ الوسائط جاهزة الآن للتشغيل، بدءًا من الطابع الزمني المقدَّم.
`abstract void`	`notifySeekToTimestamp(Duration mediaPlayoutPosition)` عليك إعلام Meet بأنّ المستخدم قد بحث عن نقطة تشغيل الوسائط، كي يتمكّن تطبيق Meet من النسخ المطابق لهذا الإجراء لدى مستخدمين آخرين.
`abstract void`	`notifySwitchedToMedia( String mediaTitle, String mediaId, Duration mediaPlayoutPosition )` عليك إعلام 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 بأنّ مشغّل الوسائط قد وصل إلى نهاية الوسائط الحالية.

ملاحظة: ليس من المطلوب استدعاء هذه الطريقة (ولكنّها ليست ضارة) في حال استدعاء notificationsSwitchedToMedia باستخدام آلية التشغيل التلقائي فور انتهاء الوسائط.

المَعلمات
`Duration mediaPlayoutPosition`	الموضع النهائي للّاعب

الرميات
`java.lang.NullPointerException`	إذا كان `mediaPlayoutPosition` فارغًا
`com.google.android.meet.addons.AddonException`	إذا حدث خطأ غير متوقع
`java.lang.IllegalStateException`	إذا تم الاتصال بعد انتهاء جلسة المشاهدة مع الآخرين

notifyPauseState

abstract void notifyPauseState(boolean paused, Duration mediaPlayoutPosition)

يمكنك إبلاغ 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 بأنّه تم تغيير قائمة المحتوى التالي كي تتم مطابقته مع المستخدمين الآخرين.

المَعلمات
`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 بأنّ المستخدم قد بدَّل الوسائط، ليتمكّن من تمرير ذلك إلى مستخدمين آخرين.

المَعلمات
`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`	إذا تم الاتصال بعد انتهاء جلسة المشاهدة مع الآخرين