ستساعدك الإرشادات التالية في إنشاء تطبيقات ذات جودة عالية باستخدام واجهة برمجة تطبيقات الرسائل القريبة وواجهة برمجة تطبيقات اتصالات الأجهزة المجاورة.
احترام خصوصية المستخدم
يمكنك مساعدة المستخدم على فهم البيانات التي سيعرضها تطبيقك للمستخدمين القريبين منه.
لا تنشر معلومات حساسة مثل كلمات المرور وأرقام بطاقات الائتمان. مرِّر بدلاً من ذلك الرموز المميزة للتفويض أو معرِّفات المعاملات.
يلزم اتخاذ إجراء صريح من بدء المستخدم لبدء "الأجهزة المجاورة"
لا تفاجئ المستخدم. مطالبة المستخدم بتنفيذ إجراء صريح (نقرة على زر، أو الانتقال إلى قسم في تطبيقك، أو مفتاح تحويل خاص، وما إلى ذلك) لتنشيط ميزة الأجهزة المجاورة.
على كل من نظامي التشغيل iOS وAndroid، سيؤدي الاتصال بالجوار للمرة الأولى إلى تشغيل مربع حوار أذونات من مكان قريب. إن انتظار إجراء صريح من المستخدم قبل استدعاء ميزة "الأجهزة المجاورة" سيساعد المستخدم في وضع سياق لمربع الحوار وربطه بميزة التطبيق المستند إلى القرب.
انتبه إلى استهلاك البطارية
سيؤدي استخدام الأجهزة المجاورة للراديو وأجهزة الاستشعار إلى استهلاك التطبيق للبطارية بمعدل يتراوح من 2.5 إلى 3.5 أضعاف المعدل العادي. لتقليل استخدام البطارية، اتبع التوصيات التالية.
على نظام التشغيل Android، عند النشر أو الاشتراك باستخدام أجهزة لا تعمل بتقنية البلوتوث منخفض الطاقة، لا تستدعي واجهة برمجة تطبيقات "رسائل الأجهزة المجاورة" إلا من خلال أحد الأنشطة، وحافِظ على استمرار هذا النشاط فقط عند تشغيل الشاشة وعندما يكون تطبيقك في المقدّمة. لإجراء ذلك، يمكنك تمرير النشاط كوسيطة إلى معلمة
ContextلـNearby.getMessagesClient(). لا يتم استدعاء ميزة "الأجهزة المجاورة" من الخدمة إلا عند الاشتراك في رسائل بلوتوث منخفض الطاقة (BLE).على نظام التشغيل Android، يمكنك معاودة الاتصال على
Nearby.getMessagesClient(Activity).unpublish()وNearby.getMessagesClient(Activity).unsubscribe()في أي عمليات نشر أو اشتراكات نشطة على هاتف Android. على نظام التشغيل iOS، لا يلزم اتخاذ أي إجراء؛ حيث يتم التعامل مع هذا الأمر تلقائيًا.سهِّل على المستخدم إيقاف عمليات النشر والاشتراكات النشطة.
لا تنشر أو تشترك في الخلفية دون علم المستخدم.
استخدام العلامة التجارية المناسبة
لقد وفرنا مجموعة من مواد العرض القياسية التي يمكنك استخدامها لتمثيل الأجهزة المجاورة في تطبيقك. استخدم الرموز المعتمدة التالية فقط عند الإشارة إلى الأجهزة المجاورة.