אני רוצה לנסות

אתם יכולים לשלב את Google Meet Live Share SDK באפליקציה ל-Android באמצעות Java.

במסמכי התיעוד הרשמיים של Android למפתחים אפשר למצוא מסמכי תיעוד ל-Android וספריות נוספות של Android כדי להרחיב את התכונות של האפליקציה.

שימוש ב-SDK

כדי להשתמש ב-SDK של שיתוף בזמן אמת ב-Meet, צריך להפעיל את השיטה AddonClientFactory.getClient. הפעולה הזו תחזיר את הסמל AddonClient שמשמש כנקודת הכניסה לפעילויות המשותפות.

Java

public ListenableFuture<AddonSession> initialSetup() {
  AddonClient meetClient = AddonClientFactory.getClient();
  return meetClient;
}

קבלו את הלקוחות לביצוע פעולה משותפת ולצפייה משותפת

כדי להשתמש בלקוח, קוראים ל-method newSessionBuilder מה-AddonClient כדי להחזיר builder עבור AddonSession חדש. כדי להתחיל סשן, מוסיפים ל-builder את ה-method withCoDoing, ה-method withCoWatching, או את שניהם.

במדריכים הבאים מוסבר איך להתחיל צפייה משותפת או פעילות משותפת:

ה-API לצפייה משותפת ו-Co-Doing API הם עצמאיים ואפשר להשתמש בהם במקביל. אפשר להתחיל סשן של תוסף בלי להשתמש בלקוח לביצוע פעולות משותפות או בלקוח לצפייה משותפת.

ניהול מצב ההתחלה של שיתוף הפעולה

כשפותחים תוסף, הוא טוען מצב שעשוי להיות שונה ממצב ההתחלה שבו התוסף רוצה להשתמש כשמשתמשים מצטרפים באמצעות ההזמנה לשיתוף פעולה. ה-AddonSession.Builder משתמש ב-method withCollaborationStartingState כדי לציין איזה CollaborationStartingState צריך להיטען כשהמשתמשים מצטרפים לפעילות של שיתוף הפעולה.

אפשר לאפס או לעדכן את השדה CollaborationStartingState באמצעות השיטות הבאות:

  • כדי לאפס את המצב ההתחלתי של התוסף, משתמשים ב-method AddonSession.resetCollaborationStartingState. הפעולה הזו תגרום לניקוי המצב ההתחלתי שהתקבל בעבר על ידי משתתפים אחרים. רק מפעיל ההפעלה יכול לאפס את המצב ההתחלתי.

  • משתמשים ב-method AddonSession.updateCollaborationStartingState כדי לעדכן את המצב ההתחלתי של התוסף. משתתפים אחרים מקבלים את ההזמנה כשהם מאשרים את ההזמנה לשתף פעולה. רק מי שיוזם את ההודעה יכול לעדכן את המצב ההתחלתי.

כדי לטפל בקריאות חוזרות מהתוסף של הסשן, מטמיעים את AddonSessionHandler. הקריאות החוזרות (callback) מאפשרות למפתחי התוספים להגיב לאירועים מאפליקציית Meet, כדי שהם יוכלו לראות מה הסטטוס העדכני ביותר של הסשן של התוסף CollaborationStartingState באמצעות השיטה onCollaborationStartingStateUpdate().