الحصول على رسائل المرشد

يمكن لتطبيقك الاشتراك في رسائل إشارات البلوتوث المنخفض الطاقة (BLE) باستخدام الآلية نفسها المستخدَمة للاشتراك في الرسائل التي تنشرها الأجهزة المجاورة الأخرى.

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

للاشتراك في إشارات البلوتوث، اضبط المَعلمة deviceTypesToDiscover على kGNSDeviceBLEBeacon في مَعلمات الاشتراك. يوضّح المقتطف التالي كيفية إجراء ذلك:

Objective-C

id<GNSSubscription> beaconSubscription = [messageManager
    subscriptionWithMessageFoundHandler:myMessageFoundHandler
                     messageLostHandler:myMessageLostHandler
                            paramsBlock:^(GNSSubscriptionParams *params) {
                              params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
                            }];

Swift

let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
    myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
    paramsBlock: { (params: GNSSubscriptionParams!) in
      params.deviceTypesToDiscover = .BLEBeacon
    })

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

Objective-C

id<GNSSubscription> beaconSubscription = [messageManager
    subscriptionWithMessageFoundHandler:myMessageFoundHandler
                     messageLostHandler:myMessageLostHandler
                            paramsBlock:^(GNSSubscriptionParams *params) {
                              params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
                              params.messageNamespace = @"com.mycompany.mybeaconservice";
                              params.type = @"mybeacontype";
                            }];

Swift

let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
    myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
    paramsBlock: { (params: GNSSubscriptionParams!) in
      params.deviceTypesToDiscover = .BLEBeacon
      params.messageNamespace = "com.mycompany.mybeaconservice"
      params.type = "mybeacontype"
    })

بشكل تلقائي، يبحث اشتراك المرشد عن كلا نوعَي أجهزة الإرشاد، Eddystone وiBeacon. عند تفعيل ميزة البحث عن أجهزة iBeacon، سيُطلب من المستخدمين منح الإذن للتطبيق باستخدام بيانات الموقع الجغرافي. يجب أن يتضمّن ملف Info.plist الخاص بتطبيقك مفتاح NSLocationWhenInUseUsageDescription مع شرح موجز لسبب استخدام الموقع الجغرافي. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Apple.

إذا أردت البحث عن إشارات Eddystone فقط، يمكنك إيقاف البحث عن إشارات iBeacon في GNSBeaconStrategy، ولن يطلب نظام iOS من المستخدم الإذن باستخدام الموقع الجغرافي. يوضّح المقتطف التالي كيفية إيقاف فحص iBeacon للاشتراك الأصلي أعلاه:

Objective-C

id<GNSSubscription> beaconSubscription = [messageManager
    subscriptionWithMessageFoundHandler:myMessageFoundHandler
                     messageLostHandler:myMessageLostHandler
                            paramsBlock:^(GNSSubscriptionParams *params) {
                              params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
                              params.beaconStrategy =
                                  [GNSBeaconStrategy strategyWithParamsBlock:^(GNSBeaconStrategyParams *params) {
                                    params.includeIBeacons = NO;
                                  };
                            }];

Swift

let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
    myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
    paramsBlock: { (params: GNSSubscriptionParams!) in
      params.deviceTypesToDiscover = .BLEBeacon
      params.beaconStrategy =
          GNSBeaconStrategy(paramsBlock: { (params: GNSBeaconStrategyParams!) in
            params.includeIBeacons = false
          })
    })

يتم تفعيل ميزة البحث المنخفض الطاقة تلقائيًا، ما قد يؤدي في بعض الأحيان إلى حدوث تأخيرات كبيرة عند العثور على إشارات Eddystone. عند إيقاف وضع توفير الطاقة، يتم استخدام ميزة البحث عن iBeacon للمساعدة في العثور على إشارات Eddystone، ما قد يقلل من فترات التأخير هذه. ومع ذلك، يؤدي ذلك إلى زيادة استخدام البطارية، وسيطلب نظام التشغيل iOS من المستخدم الإذن لاستخدام الموقع الجغرافي.

يوضّح المقتطف التالي كيفية إيقاف وضع توفير الطاقة عند البحث عن أجهزة إرشاد Eddystone.

Objective-C

id<GNSSubscription> beaconSubscription = [messageManager
    subscriptionWithMessageFoundHandler:myMessageFoundHandler
                     messageLostHandler:myMessageLostHandler
                            paramsBlock:^(GNSSubscriptionParams *params) {
                              params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
                              params.beaconStrategy =
                                  [GNSBeaconStrategy strategyWithParamsBlock:^(GNSBeaconStrategyParams *params) {
                                    params.includeIBeacons = NO;
                                    params.lowPowerPreferred = NO;
                                  };
                            }];

Swift

let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
    myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
    paramsBlock: { (params: GNSSubscriptionParams!) in
      params.deviceTypesToDiscover = .BLEBeacon
      params.beaconStrategy =
          GNSBeaconStrategy(paramsBlock: { (params: GNSBeaconStrategyParams!) in
            params.includeIBeacons = false
            params.lowPowerPreferred = false
          })
    })

عند البحث عن أجهزة iBeacons، يسبق مربّع حوار إذن تحديد الموقع الجغرافي في iOS مربّع حوار إذن "الأجهزة المجاورة". إذا أردت إلغاء مربّع الحوار هذا (على سبيل المثال، لتقديم مربّع حوار "تمهيدي" يوضّح سبب الحاجة إلى إذن تحديد الموقع الجغرافي)، اضبط permissionRequestHandler على مجموعة مخصّصة في مَعلمات الاشتراك. يوضّح المقتطف التالي كيفية إجراء ذلك:

Objective-C

id<GNSSubscription> beaconSubscription = [messageManager
    subscriptionWithMessageFoundHandler:myMessageFoundHandler
                     messageLostHandler:myMessageLostHandler
                            paramsBlock:^(GNSSubscriptionParams *params) {
                              params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
                              params.permissionRequestHandler = ^(GNSPermissionHandler permissionHandler) {
                                // Show your custom dialog here, and don't forget to call permissionHandler after it is dismissed
                                permissionHandler(userGavePermission);
                              };
                            }];

Swift

let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
    myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
    paramsBlock: { (params: GNSSubscriptionParams!) in
      params.deviceTypesToDiscover = .BLEBeacon
      params.permissionRequestHandler = { (permissionHandler: GNSPermissionHandler!) in
        // Show your custom dialog here, and don't forget to call permissionHandler after it is dismissed
        permissionHandler(userGavePermission);
      }
    })

المسح في الخلفية

بما أنّ ميزة البحث عن أجهزة الإرشاد تستخدم تقنية BLE، يمكنها العمل في الخلفية. في ما يلي بعض الأمور التي يجب مراعاتها عند اتخاذ قرار باستخدام وضع الخلفية:

  • هناك تكلفة إضافية للبطارية عند استخدام BLE في الخلفية. التكلفة منخفضة، ولكن يجب قياسها قبل اتخاذ قرار استخدام وضع الخلفية.
  • سيطلب نظام التشغيل iOS من المستخدم الإذن باستخدام الموقع الجغرافي في الخلفية في حال تفعيل ميزة البحث عن iBeacon أو إيقاف وضع توفير الطاقة.

لتفعيل ميزة البحث عن أجهزة الإرشاد في الخلفية، اتّبِع الخطوات الإضافية التالية:

  • يمكنك تفعيل وضع الخلفية لاشتراكك من خلال تمرير عنصر GNSBeaconStrategy تم ضبطه بشكل صحيح. يوضّح المقتطف التالي كيفية إجراء ذلك:

    Objective-C

    id<GNSSubscription> beaconSubscription = [messageManager
        subscriptionWithMessageFoundHandler:myMessageFoundHandler
                         messageLostHandler:myMessageLostHandler
                                paramsBlock:^(GNSSubscriptionParams *params) {
                                  params.deviceTypesToDiscover = kGNSDeviceBLEBeacon;
                                  params.beaconStrategy = [GNSBeaconStrategy
                                      strategyWithParamsBlock:^(GNSBeaconStrategyParams *params) {
                                        params.allowInBackground = YES;
                                      }];
                                }];
    

    Swift

    let beaconSubscription = messageManager.subscriptionWithMessageFoundHandler(
        myMessageFoundHandler, messageLostHandler: myMessageLostHandler,
        paramsBlock: { (params: GNSSubscriptionParams!) in
          params.deviceTypesToDiscover = .BLEBeacon
          params.beaconStrategy =
              GNSBeaconStrategy(paramsBlock: { (params: GNSBeaconStrategyParams!) in
                params.allowInBackground = true
              })
        })
    

  • أضِف الإدخالات المطلوبة إلى ملف Info.plist في تطبيقك:

    • ‫UIBackgroundModes إدخال:

      • ‫bluetooth-central للبحث عن أجهزة تتضمّن بلوتوث منخفض الطاقة في الخلفية
      • ‫location للبحث عن أجهزة iBeacon في الخلفية باستخدام وضع الطاقة العالية يمكنك حذف هذا إذا كنت تجري مسحًا ضوئيًا منخفض الطاقة لإشارات Eddystone فقط.
    • NSLocationAlwaysUsageDescription سلسلة تصف سبب تتبُّعك الموقع الجغرافي للمستخدم في الخلفية على سبيل المثال، "مطلوب معرفة موقعك الجغرافي للبحث عن إشارات في الخلفية". لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Apple. يمكنك حذف هذا إذا كنت تجري مسحًا ضوئيًا منخفض الطاقة لأجهزة إرسال Eddystone فقط.

  • هل يمكن للمستخدم تفعيل ميزة "المسح في الخلفية" أو إيقافها في تطبيقك؟ في هذه الحالة، يجب حفظ قيمة وضع الخلفية في NSUserDefaults لأنّ نظام التشغيل iOS يمكنه إيقاف تطبيقك في أي وقت أثناء تشغيله في الخلفية. يجب أن ينفّذ تطبيقك ما يلي:

    • يتم حفظ قيمة وضع الخلفية في NSUserDefaults عندما يغيّرها المستخدم.
    • عند بدء التشغيل، يمكنك قراءته من NSUserDefaults واستعادة اشتراك الإشارات إذا كان وضع الخلفية مفعَّلاً.

إشعارات في الخلفية

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