!17060 [分布式硬件DM]添加API访问权限

Merge pull request !17060 from 史晓晓/master

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&lt;{ param: string}&gt;): void;
 
 ui状态变更回调。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1025,6 +1069,8 @@ off(type: 'uiStateChange', callback?: Callback&lt;{ param: string}&gt;): void;
 
 取消ui状态变更回调。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1050,6 +1096,8 @@ on(type: 'deviceStateChange',  callback: Callback&lt;{ action: DeviceStateChange
 
 注册设备状态回调。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1077,6 +1125,8 @@ off(type: 'deviceStateChange', callback?: Callback&lt;{ action: DeviceStateChang
 
 取消注册设备状态回调。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1104,6 +1154,8 @@ on(type: 'deviceFound', callback: Callback&lt;{ subscribeId: number, device: Dev
 
 注册发现设备回调监听。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1131,6 +1183,8 @@ off(type: 'deviceFound', callback?: Callback&lt;{ subscribeId: number, device: D
 
 取消注册设备发现回调。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1158,6 +1212,8 @@ on(type: 'discoverFail', callback: Callback&lt;{ subscribeId: number, reason: nu
 
 注册设备发现失败回调监听。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1185,6 +1241,8 @@ off(type: 'discoverFail', callback?: Callback&lt;{ subscribeId: number, reason:
 
 取消注册设备发现失败回调。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1212,6 +1270,8 @@ on(type: 'publishSuccess', callback: Callback&lt;{ publishId: number }&gt;): voi
 
 注册发布设备发现回调监听。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1240,6 +1300,8 @@ off(type: 'publishSuccess', callback?: Callback&lt;{ publishId: number }&gt;): v
 
 取消注册设备发布成功回调。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1267,6 +1329,8 @@ on(type: 'publishFail', callback: Callback&lt;{ publishId: number, reason: numbe
 
 注册设备发布失败回调监听。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1294,6 +1358,8 @@ off(type: 'publishFail', callback?: Callback&lt;{ publishId: number, reason: num
 
 取消注册设备发布失败回调。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1321,6 +1387,8 @@ on(type: 'serviceDie', callback: () =&gt; void): void
 
 注册设备管理服务死亡监听。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**
@@ -1348,6 +1416,8 @@ off(type: 'serviceDie', callback?: () =&gt; void): void
 
 取消注册设备管理服务死亡监听。
 
+**需要权限**：ohos.permission.ACCESS_SERVICE_DM
+
 **系统能力**：SystemCapability.DistributedHardware.DeviceManager
 
 **参数：**

zh-cn/release-notes/changelogs/OpenHarmony_4.0.8.2/changelogs-device_manager.md

+# 设备管理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     |
+
+**适配指导**
+
+调用以上接口，需要申请相应的权限才能正常调用。