نظرة عامة

واجهة برمجة تطبيقات "الرسائل القريبة" هي واجهة برمجة تطبيقات تتيح الاشتراك في النشر تسمح لك بتمرير أحمال ثنائية صغيرة بين أجهزة Android وiOS المتصلة بالإنترنت. لا ينبغي أن تكون الأجهزة على نفس الشبكة، ولكن يجب أن تكون متصلة بالإنترنت.

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

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

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

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

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

  3. يربط التطبيق المشترك اشتراكه برمز مميّز ويستخدم Bluetooth Low Energy لإرسال رمزه المميّز إلى الناشر ورصد الرمز المميّز للناشر.

  4. وعندما يكتشف أحد الجانبين الرمز المميز للطرف الآخر، يُبلغ الخادم بذلك.

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

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

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

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