יש לך 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 התראה על כך שהמשתמש השהה או ביטל את ההשהיה של הפעלת המדיה, כדי שהמערכת של 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` הוא null
`com.google.android.meet.addons.AddonException`	אם אירעה שגיאה בלתי צפויה
`java.lang.IllegalStateException`	ייקראו אחרי שסשן הצפייה המשותפת הסתיים

notifyEnded

abstract void notifyEnded(Duration mediaPlayoutPosition)

מודיע ל-Meet שנגן המדיה הגיע לסופה של המדיה הנוכחית.

הערה: אין צורך להפעיל את השיטה הזו (אבל היא לא מזיקה) אם ההודעה NotificationSwitchedToMedia מופעלת באמצעות מנגנון הפעלה אוטומטית ברגע שהמדיה מסתיימת.

פרמטרים
`Duration mediaPlayoutPosition`	המיקום הסופי של השחקן

קליעות
`java.lang.NullPointerException`	אם `mediaPlayoutPosition` הוא null
`com.google.android.meet.addons.AddonException`	אם אירעה שגיאה בלתי צפויה
`java.lang.IllegalStateException`	ייקראו אחרי שסשן הצפייה המשותפת הסתיים

notifyPauseState

abstract void notifyPauseState(boolean paused, Duration mediaPlayoutPosition)

אפשר לשלוח ל-Meet התראה על כך שהמשתמש השהה או ביטל את ההשהיה של הפעלת המדיה, כדי שהמערכת של Meet תוכל לשקף את הפעולה הזו אצל משתמשים אחרים.

פרמטרים
`boolean paused`	`true` אם מושהית או `false` אם ההפעלה נמשכת
`Duration mediaPlayoutPosition`	המיקום שבו המדיה הושהתה או בוטלה

קליעות
`java.lang.NullPointerException`	אם `mediaPlayoutPosition` הוא null
`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` הוא null
`com.google.android.meet.addons.AddonException`	אם אירעה שגיאה בלתי צפויה
`java.lang.IllegalStateException`	ייקראו אחרי שסשן הצפייה המשותפת הסתיים

notifyReady

abstract void notifyReady(Duration mediaPlayoutPosition)

מודיע ל-Meet שמאגר הנתונים הזמני הושלם ואפשר עכשיו להפעיל את המדיה, החל מחותמת הזמן שצוינה.

פרמטרים
`Duration mediaPlayoutPosition`	המיקום שבו המדיה בתהליך אגירת נתונים ומוכנה להפעלה.

קליעות
`java.lang.NullPointerException`	אם `mediaPlayoutPosition` הוא null
`com.google.android.meet.addons.AddonException`	אם אירעה שגיאה בלתי צפויה
`java.lang.IllegalStateException`	ייקראו אחרי שסשן הצפייה המשותפת הסתיים

notifySeekToTimestamp

abstract void notifySeekToTimestamp(Duration mediaPlayoutPosition)

שליחת התראה ל-Meet על כך שהמשתמש חיפש את נקודת ההפעלה של המדיה, כדי ש-Meet יוכל לשקף את הפעולה הזו אצל משתמשים אחרים.

פרמטרים
`Duration mediaPlayoutPosition`	חותמת הזמן שאליה המשתמש חיפש

קליעות
`java.lang.NullPointerException`	אם `mediaPlayoutPosition` הוא null
`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`	ייקראו אחרי שסשן הצפייה המשותפת הסתיים