แอปของคุณสามารถสมัครรับข้อความบีคอน Bluetooth Low Energy (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"
})
โดยค่าเริ่มต้น การสมัครใช้บริการบีคอนจะสแกนหาบีคอนทั้ง 2 ประเภท ได้แก่ 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
})
})
เมื่อสแกนหา iBeacon กล่องโต้ตอบสิทธิ์เข้าถึงตำแหน่งของ iOS จะแสดงขึ้นก่อนกล่องโต้ตอบสิทธิ์ของ Nearby หากต้องการลบล้างกล่องโต้ตอบนี้ (เช่น เพื่อแสดงกล่องโต้ตอบ "ก่อนการตรวจสอบ" ที่อธิบายเหตุผลที่ต้องใช้สิทธิ์เข้าถึงตำแหน่ง) ให้ตั้งค่า 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สำหรับการสแกน BLE ในเบื้องหลังlocationสำหรับการสแกน iBeacon ในเบื้องหลังโดยใช้โหมดพลังงานสูง คุณสามารถละเว้นส่วนนี้ได้หากทำการสแกนพลังงานต่ำสำหรับบีคอน Eddystone เท่านั้น
สตริง
NSLocationAlwaysUsageDescriptionที่อธิบายเหตุผลที่คุณจะติดตามตำแหน่งของผู้ใช้ในเบื้องหลัง เช่น "ต้องใช้ตำแหน่งของคุณเพื่อสแกนหาบีคอนในเบื้องหลัง" ดูรายละเอียดได้ในเอกสารประกอบของ Apple คุณสามารถละเว้นขั้นตอนนี้ได้หากกำลังสแกนพลังงานต่ำสำหรับบีคอน Eddystone เท่านั้น
ผู้ใช้เปิดหรือปิดใช้การสแกนในเบื้องหลังในแอปของคุณได้ไหม หากเป็นเช่นนั้น คุณควรบันทึกค่าโหมดเบื้องหลังเป็น
NSUserDefaultsเนื่องจาก iOS สามารถปิดแอปของคุณได้ทุกเมื่อขณะที่แอปทำงานอยู่เบื้องหลัง แอปของคุณควรดำเนินการดังต่อไปนี้- บันทึกค่าโหมดพื้นหลังเป็น
NSUserDefaultsทุกครั้งที่ผู้ใช้เปลี่ยนค่า - เมื่อเริ่มต้นระบบ ให้อ่านจาก
NSUserDefaultsและกู้คืนการสมัครใช้บริการบีคอนหากเปิดใช้โหมดพื้นหลัง
- บันทึกค่าโหมดพื้นหลังเป็น
การแจ้งเตือนในเบื้องหลัง
หากต้องการให้แอปแจ้งเตือนผู้ใช้เมื่อพบบีคอนขณะทำงานอยู่เบื้องหลัง คุณสามารถใช้การแจ้งเตือนในเครื่องได้ โปรดดูรายละเอียดที่หัวข้อการแจ้งเตือนในเบื้องหลัง