harmony 鸿蒙设备管理ChangeLog

2023-06-24
浏览 (450)

设备管理ChangeLog

cl.device_manager.1 接口权限变更

从Openharmony 4.0.8.2版本开始，部分接口新增权限校验。

变更影响

从Openharmony 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 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

适配指导

调用以上接口，需要申请相应的权限才能正常调用。

cl.device_manager.2 所有接口进行系统接口权限校验

从Openharmony 4.0.8.2版本开始，所有接口进行系统接口权限校验。

变更影响

非系统应用无法调用系统接口，如调用方为非系统应用或未申请SystemApi相关权限，将无法调用接口。

关键的接口/组件变更

所有接口均进行系统接口权限校验，接口明细如下：

接口、枚举或变量名	类型	是否为SystemApi
createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager>): void;	interface	是
release(): void	interface	是
getTrustedDeviceListSync(): Array<DeviceInfo>	interface	是
getTrustedDeviceListSync(isRefresh: boolean): Array<DeviceInfo>;	interface	是
getTrustedDeviceList(callback:AsyncCallback<Array<DeviceInfo>>): void	interface	是
getTrustedDeviceList(): Promise<Array<DeviceInfo>>	interface	是
getLocalDeviceInfoSync(): DeviceInfo	interface	是
getLocalDeviceInfo(callback:AsyncCallback<DeviceInfo>): void	interface	是
getLocalDeviceInfo(): Promise<DeviceInfo>	interface	是
getDeviceInfo(networkId: string, callback:AsyncCallback<DeviceInfo>): void	interface	是
getDeviceInfo(networkId: string): Promise<DeviceInfo>	interface	是
startDeviceDiscovery(subscribeInfo: SubscribeInfo): void	interface	是
startDeviceDiscovery(subscribeInfo: SubscribeInfo, filterOptions?: string): void	interface	是
stopDeviceDiscovery(subscribeId: number): void	interface	是
publishDeviceDiscovery(publishInfo: PublishInfo): void	interface	是
unPublishDeviceDiscovery(publishId: number): void	interface	是
authenticateDevice(deviceInfo: DeviceInfo, authParam: AuthParam, callback: AsyncCallback<{deviceId: string, pinToken ?: number}>): void	interface	是
unAuthenticateDevice(deviceInfo: DeviceInfo): void	interface	是
verifyAuthInfo(authInfo: AuthInfo, callback: AsyncCallback<{deviceId: string, level: number}>): void	interface	是
setUserOperation(operateAction: number, params: string): void	interface	是
requestCredentialRegisterInfo(requestInfo: string, callback: AsyncCallback<{registerInfo: string}>): void;	interface	是
importCredential(credentialInfo: string, callback: AsyncCallback<{resultInfo: string}>): void;	interface	是
deleteCredential(queryInfo: string, callback: AsyncCallback<{resultInfo: string}>): void;	interface	是
on(type: ‘uiStateChange’, callback: Callback<{ param: string}>): void;	interface	是
off(type: ‘uiStateChange’, callback?: Callback<{ param: string}>): void;	interface	是
on(type: ‘deviceStateChange’, callback: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void	interface	是
off(type: ‘deviceStateChange’, callback?: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void	interface	是
on(type: ‘deviceFound’, callback: Callback<{ subscribeId: number, device: DeviceInfo }>): void	interface	是
off(type: ‘deviceFound’, callback?: Callback<{ subscribeId: number, device: DeviceInfo }>): void	interface	是
on(type: ‘discoverFail’, callback: Callback<{ subscribeId: number, reason: number }>): void	interface	是
off(type: ‘discoverFail’, callback?: Callback<{ subscribeId: number, reason: number }>): void	interface	是
on(type: ‘publishSuccess’, callback: Callback<{ publishId: number }>): void	interface	是
off(type: ‘publishSuccess’, callback?: Callback<{ publishId: number }>): void	interface	是
on(type: ‘publishFail’, callback: Callback<{ publishId: number, reason: number }>): void	interface	是
off(type: ‘publishFail’, callback?: Callback<{ publishId: number, reason: number }>): void	interface	是
on(type: ‘serviceDie’, callback: () => void): void	interface	是
off(type: ‘serviceDie’, callback?: () => void): void	interface	是