xref: /docs/en/release-notes/changelogs/OpenHarmony_4.0.8.2/changelogs-device_manager.md (revision e41f4b71)

# Device Management Changelog
## cl.device_manager.1 API Permission Change

Added permission verification for some APIs.

**Change Impact**

The apps developed using OpenHarmony 4.0.8.2 or later must have the corresponding permissions. Otherwise, the related APIs cannot be called.

**Key API/Component Changes**

| Module                   | Class               | Method/Attribute/Enum/Constant                                         | Added Permission|
| ------------------------- | ------------------- | ------------------------------------------------------------ | -------- |
| @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** getTrustedDeviceListSync(isRefresh: boolean): 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     |

**Adaptation Guide**

Apply for the corresponding permissions for your application before these APIs are called.


## cl.device_manager.2 Permission Verification for All System APIs

Added permission verification for all system APIs.

**Change Impact**

Non-system applications and applications without system API permission cannot call system APIs.

**Key API/Component Changes**

System API permission verification is performed on all APIs. The table below describes the APIs.

| API/Enum/Variable| Type| System API|
| -------- | -------- | ------- |
| createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager>): void;                 | interface | Yes|
| release(): void                                                                                        | interface | Yes|
| getTrustedDeviceListSync(): Array<DeviceInfo>                                                    | interface | Yes|
| getTrustedDeviceListSync(isRefresh: boolean): Array<DeviceInfo>;                                       | interface | Yes|
| getTrustedDeviceList(callback:AsyncCallback<Array<DeviceInfo>>): void                      | interface | Yes|
| getTrustedDeviceList(): Promise<Array<DeviceInfo>>                                         | interface | Yes|
| getLocalDeviceInfoSync(): DeviceInfo                                                                   | interface | Yes|
| getLocalDeviceInfo(callback:AsyncCallback<DeviceInfo>): void                                     | interface | Yes|
| getLocalDeviceInfo(): Promise<DeviceInfo>                                                        | interface | Yes|
| getDeviceInfo(networkId: string, callback:AsyncCallback<DeviceInfo>): void                       | interface | Yes|
| getDeviceInfo(networkId: string): Promise<DeviceInfo>                                            | interface | Yes|
| startDeviceDiscovery(subscribeInfo: SubscribeInfo): void                                               | interface | Yes|
| startDeviceDiscovery(subscribeInfo: SubscribeInfo, filterOptions?: string): void                       | interface | Yes|
| stopDeviceDiscovery(subscribeId: number): void                                                         | interface | Yes|
| publishDeviceDiscovery(publishInfo: PublishInfo): void                                                 | interface | Yes|
| unPublishDeviceDiscovery(publishId: number): void                                                      | interface | Yes|
| authenticateDevice(deviceInfo: DeviceInfo, authParam: AuthParam, callback: AsyncCallback<{deviceId: string, pinToken ?: number}>): void   |interface | Yes|
| unAuthenticateDevice(deviceInfo: DeviceInfo): void                                                     | interface | Yes|
| verifyAuthInfo(authInfo: AuthInfo, callback: AsyncCallback<{deviceId: string, level: number}>): void          | interface | Yes|
| setUserOperation(operateAction: number, params: string): void                                          | interface | Yes|
| requestCredentialRegisterInfo(requestInfo: string, callback: AsyncCallback<{registerInfo: string}>): void;    | interface | Yes|
| importCredential(credentialInfo: string, callback: AsyncCallback<{resultInfo: string}>): void;                | interface | Yes|
| deleteCredential(queryInfo: string, callback: AsyncCallback<{resultInfo: string}>): void;                     | interface | Yes|
| on(type: 'uiStateChange', callback: Callback<{ param: string}>): void;                                        | interface | Yes|
| off(type: 'uiStateChange', callback?: Callback<{ param: string}>): void;                                      | interface | Yes|
| on(type: 'deviceStateChange',  callback: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void                   | interface | Yes|
| off(type: 'deviceStateChange', callback?: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void                  | interface | Yes|
| on(type: 'deviceFound', callback: Callback<{ subscribeId: number, device: DeviceInfo }>): void                                      | interface | Yes|
| off(type: 'deviceFound', callback?: Callback<{ subscribeId: number, device: DeviceInfo }>): void                                    | interface | Yes|
| on(type: 'discoverFail', callback: Callback<{ subscribeId: number, reason: number }>): void                                         | interface | Yes|
| off(type: 'discoverFail', callback?: Callback<{ subscribeId: number, reason: number }>): void                                       | interface | Yes|
| on(type: 'publishSuccess', callback: Callback<{ publishId: number }>): void                                                         | interface | Yes|
| off(type: 'publishSuccess', callback?: Callback<{ publishId: number }>): void                                                       | interface | Yes|
| on(type: 'publishFail', callback: Callback<{ publishId: number, reason: number }>): void                                            | interface | Yes|
| off(type: 'publishFail', callback?: Callback<{ publishId: number, reason: number }>): void                                          | interface | Yes|
| on(type: 'serviceDie', callback: () => void): void                                                    | interface | Yes|
| off(type: 'serviceDie', callback?: () => void): void                                                  | interface | Yes|

**Adaptation Guide**

The caller must be a system application or an application with the system API permission.