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