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

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。