סקירה כללית

‫Nearby Messages API הוא API לפרסום ולהרשמה שמאפשר להעביר נתונים בינאריים קטנים בין מכשירי Android ומכשירי iOS שמחוברים לאינטרנט. המכשירים לא חייבים להיות באותה רשת, אבל הם חייבים להיות מחוברים לאינטרנט.

התכונה "שיתוף עם מכשירים בקרבת מקום" משתמשת ב-Bluetooth עם צריכת אנרגיה נמוכה (BLE) כדי להעביר קוד התאמה ייחודי בין מכשירים. השרת מאפשר להעביר הודעות בין מכשירים שמזהים את אותו קוד התאמה. כשהמכשיר מזהה קוד התאמה ממכשיר קרוב, הוא שולח את קוד ההתאמה לשרת של "הודעות בקרבת מקום" כדי לאמת אותו ולבדוק אם יש הודעות שצריך לשלוח לאפליקציה בהתאם למינויים הנוכחיים.

התכונה "הודעות בקרבת מקום" לא מאומתת ולא דורשת חשבון Google.

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

  1. אפליקציה שמפרסמת שולחת בקשה לשייך מטען ייעודי (payload) בינארי (ההודעה) לקוד התאמה ייחודי בזמן (אסימון). השרת יוצר שיוך זמני בין המטען הייעודי (payload) של ההודעה לבין האסימון.

  2. המכשיר המפרסם משתמש ב-Bluetooth עם צריכת אנרגיה נמוכה (BLE) כדי שהאסימון יהיה ניתן לזיהוי על ידי מכשירים קרובים. המכשיר המפרסם משתמש גם ב-Bluetooth עם צריכת אנרגיה נמוכה (BLE) כדי לסרוק טוקנים ממכשירים אחרים.

  3. אפליקציה שמנויה משייכת את המינוי שלה לטוקן ומשתמשת ב-Bluetooth עם צריכת אנרגיה נמוכה (BLE) כדי לשלוח את הטוקן שלה לאפליקציה שמפרסמת, ולזהות את הטוקן של האפליקציה שמפרסמת.

  4. כשאחד מהצדדים מזהה את הטוקן של הצד השני, הוא מדווח על כך לשרת.

  5. השרת מאפשר החלפת הודעות בין שני מכשירים כששניהם משויכים לאסימון משותף, ומפתחות ה-API שבהם משתמשות האפליקציות שמבצעות את הקריאה משויכים לאותו פרויקט ב-Google Developers Console.

כשמשתמשים ב-Nearby SDK של Google Play Services, נאספים נתוני ניתוח שימוש כדי לשפר את חוויית השימוש.

  • מדדי ביצועים: משך הזמן של הפרסומים והמינויים ומספר ההודעות שהתקבלו נאספים כשמשתמשים ב-Nearby SDK.
  • פרטי המכשיר: דגם המכשיר, המדינה, גרסת ה-build ושם החבילה של האפליקציה נאספים ומשויכים למדדי הביצועים כדי לזהות פלחים אזוריים וספציפיים למכשיר.
  • פרסום הודעות ב-"בקרבת מקום": נתונים שפורסמו באמצעות "הודעות בקרבת מקום" נשמרים על ידי Google עד שההודעה לא מתפרסמת יותר. הנתונים האלה משותפים עם מנויים שנמצאים בקרבת המכשיר.

משתמשי הקצה יכולים לאשר או לדחות את האיסוף הזה דרך "הגדרות" > Google > "דפוסי שימוש וביצועים".