סקירה כללית

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

התכונה 'בקרבת מקום' משתמשת ב-Bluetooth עם צריכת אנרגיה נמוכה כדי להעביר קוד התאמה ייחודי וזמני בין המכשירים. השרת מאפשר החלפת הודעות בין מכשירים שמזהים את אותו קוד התאמה. כשמכשיר מזהה קוד התאמה ממכשיר סמוך, הוא שולח את קוד ההתאמה לשרת של Nearby Messages כדי לאמת אותו, וכדי לבדוק אם יש הודעות לשליחה עבור קבוצת המינויים הנוכחית של האפליקציה.

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

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

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

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

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

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

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

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

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

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