Ứng dụng của bạn có thể đăng ký nhận thông báo của đèn hiệu Bluetooth năng lượng thấp (BLE) bằng chính cơ chế dùng để đăng ký nhận thông báo do các thiết bị ở gần khác xuất bản.
Theo mặc định, gói thuê bao đèn hiệu chỉ hoạt động khi ứng dụng của bạn ở nền trước. Khi ứng dụng của bạn chuyển sang chế độ nền, các gói thuê bao sẽ tự động ngừng quét tìm đèn hiệu. Hãy xem phần Quét trong nền để biết thông tin chi tiết về cách bật tính năng quét trong nền.
Để đăng ký nhận báo hiệu, hãy đặt tham số deviceTypesToDiscover thành kGNSDeviceBLEBeacon trong các tham số đăng ký. Đoạn mã sau đây minh hoạ cách thực hiện việc này:
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
})
Gói thuê bao ở trên chỉ khám phá các đèn hiệu thuộc sở hữu của dự án và nhận tất cả thông báo từ các đèn hiệu đó. Nếu muốn nhận thông báo từ đèn hiệu đã đăng ký bằng một không gian tên khác, bạn có thể truyền không gian tên trong tham số gói thuê bao. Tương tự, nếu muốn một loại thông báo cụ thể, bạn cũng có thể truyền một loại thông báo để lọc. Đoạn mã sau đây cho biết cách thực hiện việc này:
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"
})
Theo mặc định, gói thuê bao đèn hiệu sẽ quét cả hai loại đèn hiệu, Eddystone và iBeacon. Khi bạn bật tính năng quét iBeacon, người dùng sẽ được nhắc cấp quyền cho ứng dụng sử dụng dữ liệu vị trí của họ. Info.plist của ứng dụng phải bao gồm khoá NSLocationWhenInUseUsageDescription kèm theo nội dung giải thích ngắn gọn về lý do sử dụng thông tin vị trí. Hãy xem
tài liệu của Apple
để biết thông tin chi tiết.
Nếu chỉ muốn quét tìm đèn hiệu Eddystone, bạn có thể tắt tính năng quét iBeacon trong GNSBeaconStrategy và iOS sẽ không yêu cầu người dùng cấp quyền sử dụng thông tin vị trí. Đoạn mã sau đây cho biết cách tắt tính năng quét iBeacon cho gói thuê bao ban đầu ở trên:
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
})
})
Theo mặc định, tính năng quét tiết kiệm pin được bật, đôi khi có thể dẫn đến độ trễ lớn khi tìm đèn hiệu Eddystone. Khi chế độ tiết kiệm pin bị tắt, tính năng quét iBeacon sẽ được dùng để giúp tìm đèn hiệu Eddystone, nhờ đó có thể giảm độ trễ này. Tuy nhiên, việc này dẫn đến mức sử dụng pin cao hơn và iOS sẽ yêu cầu người dùng cấp quyền sử dụng thông tin vị trí.
Đoạn mã sau đây cho biết cách tắt chế độ tiết kiệm pin khi quét tìm đèn hiệu 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
})
})
Khi quét tìm iBeacon, hộp thoại cấp quyền truy cập thông tin vị trí của iOS sẽ xuất hiện trước hộp thoại cấp quyền cho tính năng Thiết bị ở gần. Nếu bạn muốn ghi đè hộp thoại này (ví dụ: để cung cấp hộp thoại "kiểm tra trước" giải thích lý do cần có quyền truy cập vị trí), hãy đặt permissionRequestHandler thành một khối tuỳ chỉnh trong các tham số gói thuê bao. Đoạn mã sau đây cho biết cách thực hiện việc này:
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);
}
})
Quét ở chế độ nền
Vì tính năng quét đèn hiệu sử dụng BLE nên tính năng này có thể hoạt động ở chế độ nền. Sau đây là một số điều bạn cần lưu ý khi quyết định sử dụng chế độ nền:
- BLE nền sẽ tiêu tốn thêm pin. Chi phí thấp, nhưng bạn nên đo lường trước khi quyết định sử dụng chế độ nền.
- iOS sẽ yêu cầu người dùng cấp quyền sử dụng thông tin vị trí ở chế độ nền nếu tính năng quét iBeacon được bật hoặc chế độ tiết kiệm pin bị tắt.
Để bật tính năng quét đèn hiệu ở chế độ nền, hãy làm theo các bước bổ sung sau:
Bật chế độ nền cho gói thuê bao bằng cách truyền vào một đối tượng
GNSBeaconStrategyđược định cấu hình đúng cách. Đoạn mã sau đây minh hoạ cách thực hiện việc này: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 }) })Thêm các mục bắt buộc vào tệp
Info.plistcủa ứng dụng:UIBackgroundModesmục:bluetooth-centralđể quét BLE ở chế độ nền.locationđể quét iBeacon ở chế độ nền bằng chế độ công suất cao. Bạn có thể bỏ qua bước này nếu chỉ quét đèn hiệu Eddystone ở chế độ tiết kiệm pin.
NSLocationAlwaysUsageDescriptionchuỗi mô tả lý do bạn sẽ theo dõi vị trí của người dùng ở chế độ nền. Ví dụ: "Cần có thông tin vị trí của bạn để quét tìm đèn hiệu trong nền". Hãy xem tài liệu của Apple để biết thông tin chi tiết. Bạn có thể bỏ qua bước này nếu chỉ quét đèn hiệu Eddystone ở chế độ tiết kiệm pin.
Người dùng có thể bật hoặc tắt tính năng quét trong nền trong ứng dụng của bạn không? Nếu có, bạn nên lưu giá trị chế độ nền vào
NSUserDefaultsvì iOS có thể tắt ứng dụng của bạn bất cứ lúc nào khi ứng dụng đang chạy ở chế độ nền. Ứng dụng của bạn nên làm những việc sau:- Lưu giá trị chế độ nền vào
NSUserDefaultsbất cứ khi nào người dùng thay đổi giá trị đó. - Khi khởi động, hãy đọc từ
NSUserDefaultsvà khôi phục gói thuê bao đèn hiệu nếu chế độ nền được bật.
- Lưu giá trị chế độ nền vào
Thông báo ở chế độ nền
Nếu muốn ứng dụng thông báo cho người dùng khi phát hiện thấy đèn hiệu trong khi chạy ở chế độ nền, bạn có thể sử dụng thông báo cục bộ. Để biết thông tin chi tiết, hãy xem phần thông báo trong nền.