نظرة عامة

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

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

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

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

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

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

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

  4. عندما يرصد أي من الطرفين الرمز المميز للطرف الآخر، يتم إبلاغ الخادم بذلك.

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

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

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

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