ההנחיות הבאות יעזרו לכם לפתח אפליקציות באיכות גבוהה באמצעות Nearby Messages API ו-Nearby Connections API.
חשוב לכבד את פרטיות המשתמשים
עליך להסביר למשתמשים אילו נתונים האפליקציה שלך תחשוף למשתמשים שנמצאים בקרבת מקום.
אין לפרסם מידע רגיש כמו סיסמאות ומספרים של כרטיסי אשראי. במקום זאת, מעבירים אסימוני הרשאה או מזהי עסקאות.
דרישה לפעולה יזומה מפורשת של המשתמש כדי להפעיל את התכונה 'שיתוף בקרבת מקום'
אל תפתיעו את המשתמש. לדרוש מהמשתמש לבצע פעולה מפורשת (לחיצה על לחצן, מעבר לקטע באפליקציה, מתג מיוחד וכו') כדי להפעיל את התכונה 'שיתוף מהיר'.
ב-iOS וב-Android, כשמתקשרים למישהו ב-Nearby בפעם הראשונה, מוצגת תיבת דו-שיח של בקשת הרשאה מ-Nearby. המתנה לפעולה מפורשת של המשתמש לפני הפעלת Nearby תעזור למשתמש להבין את ההקשר של תיבת הדו-שיח ולשייך אותה לתכונה מבוססת-הקרבה של האפליקציה.
שימו לב לצריכת הסוללה
השימוש של Nearby ברדיו ובחיישנים יגרום לאפליקציה לצרוך סוללה בקצב שהוא פי 2.5 עד 3.5 מהקצב הרגיל. כדי להפחית את השימוש בסוללה, כדאי לפעול לפי ההמלצות הבאות.
ב-Android, כשמפרסמים או נרשמים כמנויים באמצעות מכשירים שאינם BLE, צריך להפעיל את Nearby Messages API רק מתוך Activity, ולהשאיר את ה-Activity הזה פעיל רק כשהמסך דולק והאפליקציה פועלת בחזית. כדי לעשות זאת, מעבירים את הפעילות כארגומנט לפרמטר
ContextשלNearby.getMessagesClient(). הפעלת Nearby משירות נתמכת רק כשנרשמים להודעות משואת Bluetooth עם צריכת אנרגיה נמוכה (BLE).ב-Android, בקריאה החוזרת (callback) של
Activity.onStop()האפליקציה, קוראים ל-Nearby.getMessagesClient(Activity).unpublish()ול-Nearby.getMessagesClient(Activity).unsubscribe()בכל פרסום או מינוי פעיל. ב-iOS, אין צורך לבצע פעולה כלשהי כי המערכת מטפלת בזה באופן אוטומטי.חשוב לאפשר למשתמש להפסיק בקלות את הפרסומים והמינויים הפעילים.
אסור לפרסם או להירשם ברקע ללא ידיעת המשתמש.