AddonSessionHandler

Kotlin |Java

@PublicApi
interface AddonSessionHandler

---

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

סיכום

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

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

תפקידים ציבוריים

onCollaborationStartingStateUpdate

fun onCollaborationStartingStateUpdate(
    collaborationStartingState: CollaborationStartingState!
): Unit

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

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

onParticipantPrivilegeChanged

fun onParticipantPrivilegeChanged(
    privileges: (Mutable)List<AddonSessionHandler.Privilege!>!,
    disabledPrivileges: (Mutable)List<AddonSessionHandler.Privilege!>!
): Unit

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

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

onSessionEnded

fun onSessionEnded(endReason: AddonSessionHandler.EndReason!): Unit

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

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;
}

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