AddonSessionHandler

Kotlin |Java

@PublicApi
public interface AddonSessionHandler

---

---

תוכנית הגישה המוקדמת: התכונה הזו זמינה רק בתצוגה מקדימה מוגבלת, דרך תוכנית הגישה המוקדמת.

קריאות חוזרות (callback) שסופקו על ידי אפליקציית התוסף לסשן.

סיכום

סוגים מקוננים
@PublicApi public enum AddonSessionHandler.EndReason תיאור הסיבה שבגללה הופעלה הקריאה החוזרת (callback) מסוג onSessionEnded.
@PublicApi public enum AddonSessionHandler.Privilege מתאר הרשאה שהוקצתה או בוטלה למשתתף בסשן של תוסף.

שיטות ציבוריות
default void	onCollaborationStartingStateUpdate(     CollaborationStartingState collaborationStartingState ) מקבל את המצב העדכני של שיתוף הפעולה בתחילת סשן של תוסף.
default void	onParticipantPrivilegeChanged(     List<AddonSessionHandler.Privilege> privileges,     List<AddonSessionHandler.Privilege> disabledPrivileges ) מקבל את המצב העדכני של ההרשאות שמגדיר איך מותר למשתמש להשתתף בסשן של תוסף.
abstract void	onSessionEnded(AddonSessionHandler.EndReason endReason) משיב בסיום סשן של תוסף.

שיטות ציבוריות

onCollaborationStartingStateUpdate

default void onCollaborationStartingStateUpdate(
    CollaborationStartingState collaborationStartingState
)

מקבל את המצב העדכני של שיתוף הפעולה בתחילת סשן של תוסף.

נדרשת הטמעה קונקרטית כדי שהתוסף יתמוך במצב ההתחלה של שיתוף הפעולה.

onParticipantPrivilegeChanged

default void onParticipantPrivilegeChanged(
    List<AddonSessionHandler.Privilege> privileges,
    List<AddonSessionHandler.Privilege> disabledPrivileges
)

מקבל את המצב העדכני של ההרשאות שמגדיר איך מותר למשתמש להשתתף בסשן של תוסף.

כדי שהתוסף יתמוך באמצעי הבקרה למארחים, צריך להטמיע באופן קונקרטי.

onSessionEnded

abstract void onSessionEnded(AddonSessionHandler.EndReason endReason)

משיב בסיום סשן של תוסף.

1. ה-handler הזה לא יקבל קריאות נוספות, אלא אם השדה AddonSession החדש נוצר עם אותה מופע של ה-handler.
2. ערכת ה-SDK תנקה את עצמה. אין צורך בשיחה נוספת אל endSession.

דוגמה להטמעה:

if (EndReason.SESSION_ENDED_UNEXPECTEDLY.equals(endReason)) {
  log("Something happened unexpectedly");
  // Display UI to user in case they want to reconnect.
  return;
}

if (EndReason.MEETING_ENDED_BY_USER.equals(endReason)) {
  // The meeting is disconnected because the user left the meeting. Perform some
  // cleanup, then exit.
  this.onMeetingDisconnected();
  return;
}

if (EndReason.SESSION_ENDED_BY_USER.equals(endReason)) {
  // Disconnected because the user left the session from the Meet application. However, the
  // conference is still active in Meet. Perform some cleanup, then listen for a possible
  // rejoin event.
  this.onSessionDisconnected();
  return;
}

פרמטרים
AddonSessionHandler.EndReason endReason	הסיבה לסיום הסשן