Device Management Changelog

cl.device_manager.1 Change of API Permissions

Added permission verification for some APIs of device management from OpenHarmony 4.0.8.2.

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 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 required permissions for your application before these APIs are called.