分布式设备管理子系统变更说明

c1.device_manager.1 设备管理模块接口废弃

访问级别

系统接口

废弃原因

应应用方要求对北向开放接口，新开放的接口包含旧的系统级接口完整功能，接口更加标准并且原子化，符合社区API规范。

废弃影响

非兼容性变更，需要开发者进行适配。

废弃发生版本

从OpenHarmony SDK 4.1.2.3开始。

废弃的接口

|接口声明|废弃说明|替代接口| |–|–|–| |function createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager>): void|使用deviceManager.createDeviceManager接口创建一个设备管理实例|function createDeviceManager(bundleName: string): DeviceManager;| |function release(): void|使用deviceManager.releaseDeviceManager释放DeviceManager实例|function releaseDeviceManager(deviceManager: DeviceManager): void;| |function getTrustedDeviceListSync(): Array<DeviceInfo>|使用getAvailableDeviceListSync同步获取所有可信设备列表|function getAvailableDeviceListSync(): Array<DeviceBasicInfo>;| |function getTrustedDeviceListSync(isRefresh: boolean): Array<DeviceInfo>;|废弃|无替代接口| |function getTrustedDeviceList(callback:AsyncCallback<Array<DeviceInfo>>): void|使用getAvailableDeviceList获取所有可信设备列表|function getAvailableDeviceList(callback:AsyncCallback<Array<DeviceBasicInfo>>): void;| |function getTrustedDeviceList(): Promise<Array<DeviceInfo>>|使用getAvailableDeviceList获取所有可信设备列表|function getAvailableDeviceList(): Promise<Array<DeviceBasicInfo>>;| |function getLocalDeviceInfoSync(): DeviceInfo|使用getLocalDeviceNetworkId获取本地设备网络标识，
使用getLocalDeviceName获取本地设备名称，
使用getLocalDeviceType获取本地设备类型，
使用getLocalDeviceId获取本地设备id|function getLocalDeviceNetworkId(): string;
function getLocalDeviceName(): string;
function getLocalDeviceType(): number;
function getLocalDeviceId(): string;| |function getLocalDeviceInfo(callback:AsyncCallback<DeviceInfo>): void|使用getLocalDeviceNetworkId获取本地设备网络标识，
使用getLocalDeviceName获取本地设备名称，
使用getLocalDeviceType获取本地设备类型，
使用getLocalDeviceId获取本地设备id|function getLocalDeviceNetworkId(): string;
function getLocalDeviceName(): string;
function getLocalDeviceType(): number;
function getLocalDeviceId(): string;| |function getLocalDeviceInfo(): Promise<DeviceInfo>|使用getLocalDeviceNetworkId获取本地设备网络标识，
使用getLocalDeviceName获取本地设备名称，
使用getLocalDeviceType获取本地设备类型，
使用getLocalDeviceId获取本地设备id|function getLocalDeviceNetworkId(): string;
function getLocalDeviceName(): string;
function getLocalDeviceType(): number;
function getLocalDeviceId(): string;| |function getDeviceInfo(networkId: string, callback:AsyncCallback<DeviceInfo>): void|使用getDeviceName通过指定设备的网络标识获取该设备名称，
使用getDeviceType通过指定设备的网络标识获取该设备类型|function getDeviceName(networkId: string): string;
function getDeviceType(networkId: string): number;| |function getDeviceInfo(networkId: string): Promise<DeviceInfo>|使用getDeviceName通过指定设备的网络标识获取该设备名称，
使用getDeviceType通过指定设备的网络标识获取该设备类型|function getDeviceName(networkId: string): string;
function getDeviceType(networkId: string): number;| |function startDeviceDiscovery(subscribeInfo: SubscribeInfo): void|使用startDiscovering发现周边设备|function startDiscovering(discoverParam: {[key: string]: Object} , filterOptions?: {[key: string]: Object} ): void;| |function startDeviceDiscovery(subscribeInfo: SubscribeInfo, filterOptions?: string): void|使用startDiscovering发现周边设备|function startDiscovering(discoverParam: {[key: string]: Object} , filterOptions?: {[key: string]: Object} ): void;| |function stopDeviceDiscovery(subscribeId: number): void|使用stopDiscovering停止发现周边设备|function stopDiscovering(): void;| |function publishDeviceDiscovery(publishInfo: PublishInfo): void|废弃|无替代接口| |function unPublishDeviceDiscovery(publishId: number): void|废弃|无替代接口| |function authenticateDevice(deviceInfo: DeviceInfo, authParam: AuthParam, callback: AsyncCallback<{deviceId: string, pinToken ?: number}>): void|使用bindTarget认证设备|function bindTarget(deviceId: string, bindParam: {[key: string]: Object} , callback: AsyncCallback<{deviceId: string}>): void;| |function unAuthenticateDevice(deviceInfo: DeviceInfo): void|使用unbindTarget解除认证设备|function unbindTarget(deviceId: string): void;| |function verifyAuthInfo(authInfo: AuthInfo, callback: AsyncCallback<{deviceId: string, level: number}>): void|废弃|无替代接口| |function setUserOperation(operateAction: number, params: string): void|使用replyUiAction回复用户ui操作行为|function replyUiAction(action: number, actionResult: string): void;| |function requestCredentialRegisterInfo(requestInfo: string, callback: AsyncCallback<{registerInfo: string}>): void;|废弃|无替代接口| |function importCredential(credentialInfo: string, callback: AsyncCallback<{resultInfo: string}>): void;|废弃|无替代接口| |function deleteCredential(queryInfo: string, callback: AsyncCallback<{resultInfo: string}>): void;|废弃|无替代接口| |function on(type: ‘uiStateChange’, callback: Callback<{ param: string}>): void;|使用on(‘replyResult’)回复UI操作结果回调|function on(type: ‘replyResult’, callback: Callback<{ param: string}>): void;| |function off(type: ‘uiStateChange’, callback?: Callback<{ param: string}>): void;|使用off(‘replyResult’)取消回复UI操作结果回调|function off(type: ‘replyResult’, callback?: Callback<{ param: string}>): void;| |function on(type: ‘deviceStateChange’, callback: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void|使用on(‘deviceStateChange’)注册设备状态回调|function on(type: ‘deviceStateChange’, callback: Callback<{ action: DeviceStateChange, device: DeviceBasicInfo }>): void;| |function off(type: ‘deviceStateChange’, callback?: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void|使用off(‘deviceStateChange’)取消注册设备状态回调|function off(type: ‘deviceStateChange’, callback?: Callback<{ action: DeviceStateChange, device: DeviceBasicInfo }>): void;| |function on(type: ‘deviceFound’, callback: Callback<{ subscribeId: number, device: DeviceInfo }>): void|使用on(‘discoverSuccess’)注册发现设备成功回调监听|function on(type: ‘discoverSuccess’, callback: Callback<{ device: DeviceBasicInfo }>): void;| |function off(type: ‘deviceFound’, callback?: Callback<{ subscribeId: number, device: DeviceInfo }>): void|使用off(‘discoverSuccess’)取消注册设备发现成功回调|function off(type: ‘discoverSuccess’, callback?: Callback<{ device: DeviceBasicInfo }>): void;| |function on(type: ‘discoverFail’, callback: Callback<{ subscribeId: number, reason: number }>): void|使用on(‘discoverFailure’)注册设备发现失败回调监听|function on(type: ‘discoverFailure’, callback: Callback<{ reason: number }>): void;| |function off(type: ‘discoverFail’, callback?: Callback<{ subscribeId: number, reason: number }>): void|使用off(‘discoverFailure’)取消注册设备发现失败回调|function off(type: ‘discoverFailure’, callback?: Callback<{ reason: number }>): void;| |function on(type: ‘publishSuccess’, callback: Callback<{ publishId: number }>): void| 废弃|无替代接口| |function off(type: ‘publishSuccess’, callback?: Callback<{ publishId: number }>): void| 废弃|无替代接口| |function on(type: ‘publishFail’, callback: Callback<{ publishId: number, reason: number }>): void| 废弃|无替代接口| |function off(type: ‘publishFail’, callback?: Callback<{ publishId: number, reason: number }>): void| 废弃|无替代接口| |function on(type: ‘serviceDie’, callback: () => void): void|使用on(‘serviceDie’)注册设备管理服务死亡监听|function on(type: ‘serviceDie’, callback?: Callback<{}>): void;| |function off(type: ‘serviceDie’, callback?: () => void): void|使用off(‘serviceDie’)取消注册设备管理服务死亡监听|function off(type: ‘serviceDie’, callback?: Callback<{}>): void;| |interface DeviceInfo|使用DeviceBasicInfo表示分布式设备基本信息|interface DeviceBasicInfo| |interface SubscribeInfo|废弃|无替代接口| |interface AuthParam|废弃|无替代接口| |interface AuthInfo|废弃|无替代接口| |interface PublishInfo|废弃|无替代接口| |enum DeviceType|废弃|无替代接口| |enum AuthForm|废弃|无替代接口| |enum DeviceStateChangeAction|使用DeviceStateChange表示设备状态|enum DeviceStateChange| |enum DiscoverMode|废弃|无替代接口| |enum ExchangeMedium|废弃|无替代接口| |enum ExchangeFreq|废弃|无替代接口| |enum SubscribeCap|废弃|无替代接口|

适配指导

建议使用新模块的接口进行开发，参见@ohos.distributedDeviceManager。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙multimedia子系统ChangeLog

harmony 鸿蒙上传下载子系统ChangeLog

harmony 鸿蒙arkui子系统ChangeLog