diff --git a/zh-cn/application-dev/reference/apis/js-apis-device-manager.md b/zh-cn/application-dev/reference/apis/js-apis-device-manager.md index ff506ad318e9f737d6d9a03f711f97613d983529..e584fbb5c0e6b12d847858e83cc5a908c6b8d943 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-device-manager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-device-manager.md @@ -227,6 +227,8 @@ release(): void 设备管理实例不再使用后，通过该方法释放DeviceManager实例。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **错误码：** @@ -253,6 +255,8 @@ getTrustedDeviceListSync(): Array<DeviceInfo> 同步获取所有可信设备列表。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **返回值：** @@ -285,6 +289,8 @@ getTrustedDeviceList(callback:AsyncCallback<Array<DeviceInfo>>): voi 获取所有可信设备列表。使用callback异步回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -315,6 +321,8 @@ getTrustedDeviceList(): Promise<Array<DeviceInfo>> 获取所有可信设备列表。使用Promise异步回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **返回值：** @@ -347,6 +355,8 @@ getLocalDeviceInfoSync(): [DeviceInfo](#deviceinfo) 同步获取本地设备信息。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **返回值：** @@ -379,6 +389,8 @@ getLocalDeviceInfo(callback:AsyncCallback<DeviceInfo>): void 获取本地设备信息。使用callback异步回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -409,6 +421,8 @@ getLocalDeviceInfo(): Promise<DeviceInfo> 获取本地设备信息。使用Promise异步回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **返回值：** @@ -441,6 +455,8 @@ getDeviceInfo(networkId: string, callback:AsyncCallback<DeviceInfo>): void 通过指定设备的网络标识获取该设备的信息。使用callback异步回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -474,6 +490,8 @@ getDeviceInfo(networkId: string): Promise<DeviceInfo> 通过指定设备的网络标识获取该设备的信息。使用Promise异步回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -506,6 +524,8 @@ startDeviceDiscovery(subscribeInfo: SubscribeInfo): void 发现周边设备。发现状态持续两分钟，超过两分钟，会停止发现，最大发现数量99个。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -550,6 +570,8 @@ startDeviceDiscovery(subscribeInfo: SubscribeInfo, filterOptions?: string): void 发现周边设备。发现状态持续两分钟，超过两分钟，会停止发现，最大发现数量99个。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -604,6 +626,8 @@ stopDeviceDiscovery(subscribeId: number): void 停止发现周边设备。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -638,6 +662,8 @@ publishDeviceDiscovery(publishInfo: PublishInfo): void 发布设备发现。发布状态持续两分钟，超过两分钟会停止发布。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -679,6 +705,8 @@ unPublishDeviceDiscovery(publishId: number): void 停止发布设备发现。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -713,6 +741,8 @@ authenticateDevice(deviceInfo: DeviceInfo, authParam: AuthParam, callback: Async 认证设备。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -764,6 +794,8 @@ unAuthenticateDevice(deviceInfo: DeviceInfo): void 解除认证设备。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -803,6 +835,8 @@ verifyAuthInfo(authInfo: AuthInfo, callback: AsyncCallback<{deviceId: string, 验证认证信息。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -839,6 +873,8 @@ setUserOperation(operateAction: number, params: string): void; 设置用户ui操作行为。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -873,6 +909,8 @@ requestCredentialRegisterInfo(requestInfo: string, callback: AsyncCallback<{regi 获取凭据的注册信息。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -908,6 +946,8 @@ importCredential(credentialInfo: string, callback: AsyncCallback<{resultInfo: st 导入凭据信息。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -959,6 +999,8 @@ deleteCredential(queryInfo: string, callback: AsyncCallback<{resultInfo: string} 删除凭据信息。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -995,6 +1037,8 @@ on(type: 'uiStateChange', callback: Callback<{ param: string}>): void; ui状态变更回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1025,6 +1069,8 @@ off(type: 'uiStateChange', callback?: Callback<{ param: string}>): void; 取消ui状态变更回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1050,6 +1096,8 @@ on(type: 'deviceStateChange', callback: Callback<{ action: DeviceStateChange 注册设备状态回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1077,6 +1125,8 @@ off(type: 'deviceStateChange', callback?: Callback<{ action: DeviceStateChang 取消注册设备状态回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1104,6 +1154,8 @@ on(type: 'deviceFound', callback: Callback<{ subscribeId: number, device: Dev 注册发现设备回调监听。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1131,6 +1183,8 @@ off(type: 'deviceFound', callback?: Callback<{ subscribeId: number, device: D 取消注册设备发现回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1158,6 +1212,8 @@ on(type: 'discoverFail', callback: Callback<{ subscribeId: number, reason: nu 注册设备发现失败回调监听。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1185,6 +1241,8 @@ off(type: 'discoverFail', callback?: Callback<{ subscribeId: number, reason: 取消注册设备发现失败回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1212,6 +1270,8 @@ on(type: 'publishSuccess', callback: Callback<{ publishId: number }>): voi 注册发布设备发现回调监听。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1240,6 +1300,8 @@ off(type: 'publishSuccess', callback?: Callback<{ publishId: number }>): v 取消注册设备发布成功回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1267,6 +1329,8 @@ on(type: 'publishFail', callback: Callback<{ publishId: number, reason: numbe 注册设备发布失败回调监听。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1294,6 +1358,8 @@ off(type: 'publishFail', callback?: Callback<{ publishId: number, reason: num 取消注册设备发布失败回调。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1321,6 +1387,8 @@ on(type: 'serviceDie', callback: () => void): void 注册设备管理服务死亡监听。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** @@ -1348,6 +1416,8 @@ off(type: 'serviceDie', callback?: () => void): void 取消注册设备管理服务死亡监听。 +**需要权限**：ohos.permission.ACCESS_SERVICE_DM + **系统能力**：SystemCapability.DistributedHardware.DeviceManager **参数：** diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.8.2/changelogs-device_manager.md b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.8.2/changelogs-device_manager.md new file mode 100644 index 0000000000000000000000000000000000000000..5ad4a0548e01bba90c69302dcc31566d03d67afa --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.8.2/changelogs-device_manager.md @@ -0,0 +1,52 @@ +# 设备管理ChangeLog +## cl.device_manager.1 接口权限变更 + +从Opeharmonny 4.0.8.2版本开始，部分接口新增权限校验。 + +**变更影响** + +在Opeharmonny 4.0.8.2之后版本开发的应用，需要持有相应权限，否则无法正常调用接口。 + +**关键的接口/组件变更** + +| 模块名 | 类名 | 方法/属性/枚举/常量 | 新增权限 | +| ------------------------- | ------------------- | ------------------------------------------------------------ | -------- | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** release(): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** getTrustedDeviceListSync(): Array<DeviceInfo> | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** getTrustedDeviceList(callback:AsyncCallback<Array<DeviceInfo>>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** getTrustedDeviceList(): Promise<Array<DeviceInfo>> | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** getLocalDeviceInfoSync(): DeviceInfo | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** getLocalDeviceInfo(callback:AsyncCallback<DeviceInfo>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** getLocalDeviceInfo(): Promise<DeviceInfo> | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** getDeviceInfo(networkId: string, callback:AsyncCallback<DeviceInfo>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** getDeviceInfo(networkId: string): Promise<DeviceInfo> | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** startDeviceDiscovery(subscribeInfo: SubscribeInfo): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** startDeviceDiscovery(subscribeInfo: SubscribeInfo, filterOptions?: string): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** stopDeviceDiscovery(subscribeId: number): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** publishDeviceDiscovery(publishInfo: PublishInfo): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** unPublishDeviceDiscovery(publishId: number): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** authenticateDevice(deviceInfo: DeviceInfo, authParam: AuthParam, callback: AsyncCallback<{deviceId: string, pinToken ?: number}>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** unAuthenticateDevice(deviceInfo: DeviceInfo): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** verifyAuthInfo(authInfo: AuthInfo, callback: AsyncCallback<{deviceId: string, level: number}>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** setUserOperation(operateAction: number, params: string): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** requestCredentialRegisterInfo(requestInfo: string, callback: AsyncCallback<{registerInfo: string}>): void; | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** importCredential(credentialInfo: string, callback: AsyncCallback<{resultInfo: string}>): void; | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** deleteCredential(queryInfo: string, callback: AsyncCallback<{resultInfo: string}>): void; | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** on(type: 'uiStateChange', callback: Callback<{ param: string}>): void; | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** off(type: 'uiStateChange', callback?: Callback<{ param: string}>): void; | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** on(type: 'deviceStateChange', callback: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** off(type: 'deviceStateChange', callback?: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** on(type: 'deviceFound', callback: Callback<{ subscribeId: number, device: DeviceInfo }>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** off(type: 'deviceFound', callback?: Callback<{ subscribeId: number, device: DeviceInfo }>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** on(type: 'discoverFail', callback: Callback<{ subscribeId: number, reason: number }>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** off(type: 'discoverFail', callback?: Callback<{ subscribeId: number, reason: number }>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** on(type: 'publishSuccess', callback: Callback<{ publishId: number }>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** off(type: 'publishSuccess', callback?: Callback<{ publishId: number }>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** on(type: 'publishFail', callback: Callback<{ publishId: number, reason: number }>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** off(type: 'publishFail', callback?: Callback<{ publishId: number, reason: number }>): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** on(type: 'serviceDie', callback: () => void): void | ohos.permission.ACCESS_SERVICE_DM | +| @ohos.distributedHardware.deviceManager | deviceManager | **function** off(type: 'serviceDie', callback?: () => void): void | ohos.permission.ACCESS_SERVICE_DM | + +**适配指导** + +调用以上接口，需要申请相应的权限才能正常调用。