نظرة عامة

‫Nearby Messages API هي واجهة برمجة تطبيقات للنشر والاشتراك تتيح لك نقل حمولات ثنائية صغيرة بين أجهزة Android وiOS المتصلة بالإنترنت. ليس من الضروري أن يكون الجهازان متّصلَين بالشبكة نفسها، ولكن يجب أن يكونا متّصلَين بالإنترنت.

تستخدم ميزة "الأجهزة المجاورة" تقنية طاقة البلوتوث المنخفضة لإرسال رمز إقران فريد في الوقت المناسب بين الأجهزة. يسهّل الخادم تبادل الرسائل بين الأجهزة التي ترصد رمز الإقران نفسه. عندما يرصد أحد الأجهزة رمز إقران من جهاز مجاور، يُرسِل رمز الإقران إلى خادم "الرسائل المجاورة" للتحقّق منه، والتحقّق مما إذا كانت هناك أي رسائل لإرسالها إلى مجموعة الاشتراكات الحالية للتطبيق.

لا تتطلّب ميزة "الرسائل القريبة" مصادقة ولا تتطلّب حسابًا على Google.

قد تختلف الآلية الدقيقة لتبادل البيانات من إصدار إلى آخر. يعرض التسلسل التالي الأحداث التي تؤدّي إلى تبادل الرسائل:

  1. يقدّم تطبيق النشر طلبًا لربط الحمولة الثنائية (الرسالة) برمز إقران فريد في الوقت (الرمز المميّز). يُجري الخادم ربطًا مؤقتًا بين الحمولة البرمجية للرسالة والرمز المميّز.

  2. يستخدم جهاز النشر تقنية "طاقة بلوتوث منخفضة" لجعل الرمز المميّز قابلاً للاكتشاف من قِبل الأجهزة المجاورة. يستخدم جهاز النشر أيضًا تقنية Bluetooth Low Energy للبحث عن الرموز المميّزة من الأجهزة الأخرى.

  3. يربط التطبيق المشترِك اشتراكه برمز مميّز ويستخدم تقنية )"طاقة بلوتوث منخفضة" لإرسال رمزه المميّز إلى الناشر ورصد رمزه المميّز.

  4. عندما يرصد أي من الجانبَين رمز مميّز للجانب الآخر، يُبلغ الخادم بذلك.

  5. يسهّل الخادم تبادل الرسائل بين جهازَين عندما يكون كلاهما مرتبطًا برمز ترويجي شائع، وتكون مفاتيح واجهة برمجة التطبيقات المستخدَمة من قِبل التطبيقات التي تطلب البيانات مرتبطة بالمشروع نفسه في Google Developers Console.

عند استخدام حزمة تطوير البرامج (SDK) لميزة "المشاركة عن قرب" من "خدمات Google Play"، يتم جمع إحصاءات الاستخدام بهدف تحسين التجربة.

  • مقاييس الأداء: يتم جمع مدة عمليات النشر والاشتراكات و عدد الرسائل المستلَمة عند استخدام حزمة تطوير البرامج (SDK) لميزة "الاقتراب".
  • معلومات الجهاز: يتم جمع طراز الجهاز والبلد وإصدار الإصدار واسم حزمة التطبيق وربطها بمقاييس الأداء لتحديد الشرائح المتعلّقة بالمنطقة والجهاز.
  • نشر "رسائل الأجهزة المجاورة": تخزِّن Google البيانات المنشورة من خلال "رسائل الأجهزة المجاورة" إلى أن يتم إيقاف نشر الرسالة. تتم مشاركة هذه البيانات مع المشتركين الذين يكونون بالقرب من الجهاز.

يمكن للمستخدمين النهائيين السماح بهذه المجموعة أو رفضها من خلال الانتقال إلى الإعدادات > Google > الاستخدام وبيانات التشخيص.