يمكن لتطبيقك الاشتراك في رسائل إشارات البلوتوث المنخفض الطاقة (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واستعادة اشتراك الإشارات إذا كان وضع الخلفية مفعَّلاً.
- يتم حفظ قيمة وضع الخلفية في
إشعارات في الخلفية
إذا أردت أن يرسل تطبيقك إشعارًا إلى المستخدم عند اكتشاف أجهزة إرشاد أثناء تشغيله في الخلفية، يمكنك استخدام الإشعارات المحلية. لمعرفة التفاصيل، يُرجى الاطّلاع على الإشعارات في الخلفية.