开发星闪应用前,需完成设备确认、环境准备与权限申请等准备工作,并可通过查询接口确认设备支持星闪且星闪开关已开启。开发前建议先阅读星闪常见问题中关于服务UUID、事件订阅、SSAP属性描述符与设备地址的说明。
开发者需要在应用中动态申请星闪权限ohos.permission.ACCESS_NEARLINK,包括在应用配置文件中声明此权限,并向用户申请授权。该权限为user_grant授权方式,申请步骤如下:
查询设备是否支持星闪,完整的API说明以及示例代码请参考:@ohos.nearlink.manager (星闪基础管理能力)。
| 接口名 | 描述 |
|---|---|
| isNearLinkSupported(): boolean | 主动查询当前设备是否支持星闪。 |
导入相关模块。
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { manager } from '@kit.ConnectivityKit'; 发起当前设备是否支持星闪的状态查询。
try {
let supported: boolean = manager.isNearLinkSupported();
// ...
} catch (err) {
hilog.error(0x0000, 'testTag',
`errCode: ${(err as BusinessError).code}, errMessage: ${(err as BusinessError).message}`);
} 提供主动查询和订阅通知两种获取星闪开关状态的方式,完整的API说明以及示例代码请参考:@ohos.nearlink.manager (星闪基础管理能力)。
| 接口名 | 描述 |
|---|---|
| getState(): NearlinkState | 主动查询星闪开关状态。 |
| onStateChange(callback: Callback<NearlinkState>): void | 订阅星闪开关状态变化事件。使用callback异步回调。 |
| offStateChange(callback?: Callback<NearlinkState>): void | 取消订阅星闪开关状态变化事件。使用callback异步回调。 |
导入相关模块。
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { manager } from '@kit.ConnectivityKit'; 发起星闪开关状态查询。
try {
let state: manager.NearlinkState = manager.getState();
// ...
} catch (err) {
hilog.error(0x0000, 'testTag',
`errCode: ${(err as BusinessError).code}, errMessage: ${(err as BusinessError).message}`);
} 订阅星闪开关状态变化。
try {
manager.onStateChange((state: manager.NearlinkState) => {
hilog.info(0x0000, 'testTag', `NearLink state changed: ${state}`);
// ...
});
} catch (err) {
hilog.error(0x0000, 'testTag',
`errCode: ${(err as BusinessError).code}, errMessage: ${(err as BusinessError).message}`);
} 取消订阅星闪开关状态变化。
try {
manager.offStateChange();
} catch (err) {
hilog.error(0x0000, 'testTag',
`errCode: ${(err as BusinessError).code}, errMessage: ${(err as BusinessError).message}`);
}