1# 分布式设备管理子系统变更说明 2 3## c1.device_manager.1 设备管理模块接口废弃 4 5**访问级别** 6 7系统接口 8 9**废弃原因** 10 11应应用方要求对北向开放接口，新开放的接口包含旧的系统级接口完整功能，接口更加标准并且原子化，符合社区API规范。 12 13**废弃影响** 14 15非兼容性变更，需要开发者进行适配。 16 17**废弃发生版本** 18 19从OpenHarmony SDK 4.1.2.3开始。 20 21**废弃的接口** 22 23| 接口声明 | 废弃说明 | 替代接口 | 24| -- | -- | -- | 25| function createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager>): void | 使用[deviceManager.createDeviceManager](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#devicemanagercreatedevicemanager)接口创建一个设备管理实例 | function createDeviceManager(bundleName: string): DeviceManager; | 26| function release(): void | 使用[deviceManager.releaseDeviceManager](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#devicemanagerreleasedevicemanager)释放DeviceManager实例 | function releaseDeviceManager(deviceManager: DeviceManager): void; | 27| function getTrustedDeviceListSync(): Array<DeviceInfo> | 使用[getAvailableDeviceListSync](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getavailabledevicelistsync)同步获取所有可信设备列表 | function getAvailableDeviceListSync(): Array<DeviceBasicInfo>; | 28| function getTrustedDeviceListSync(isRefresh: boolean): Array<DeviceInfo>; | 废弃 | 无替代接口 | 29| function getTrustedDeviceList(callback:AsyncCallback<Array<DeviceInfo>>): void | 使用[getAvailableDeviceList](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getavailabledevicelist)获取所有可信设备列表 | function getAvailableDeviceList(callback:AsyncCallback<Array<DeviceBasicInfo>>): void; | 30| function getTrustedDeviceList(): Promise<Array<DeviceInfo>> | 使用[getAvailableDeviceList](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getavailabledevicelist-1)获取所有可信设备列表 | function getAvailableDeviceList(): Promise<Array<DeviceBasicInfo>>; | 31| function getLocalDeviceInfoSync(): DeviceInfo | 使用[getLocalDeviceNetworkId](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldevicenetworkid)获取本地设备网络标识，<br> 使用[getLocalDeviceName](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldevicename)获取本地设备名称，<br> 使用[getLocalDeviceType](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldevicetype)获取本地设备类型，<br> 使用[getLocalDeviceId](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldeviceid)获取本地设备id | function getLocalDeviceNetworkId(): string; <br> function getLocalDeviceName(): string; <br> function getLocalDeviceType(): number; <br> function getLocalDeviceId(): string; | 32| function getLocalDeviceInfo(callback:AsyncCallback<DeviceInfo>): void | 使用[getLocalDeviceNetworkId](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldevicenetworkid)获取本地设备网络标识，<br> 使用[getLocalDeviceName](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldevicename)获取本地设备名称，<br> 使用[getLocalDeviceType](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldevicetype)获取本地设备类型，<br> 使用[getLocalDeviceId](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldeviceid)获取本地设备id | function getLocalDeviceNetworkId(): string; <br> function getLocalDeviceName(): string; <br> function getLocalDeviceType(): number; <br> function getLocalDeviceId(): string; | 33| function getLocalDeviceInfo(): Promise<DeviceInfo> | 使用[getLocalDeviceNetworkId](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldevicenetworkid)获取本地设备网络标识，<br> 使用[getLocalDeviceName](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldevicename)获取本地设备名称，<br> 使用[getLocalDeviceType](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldevicetype)获取本地设备类型，<br> 使用[getLocalDeviceId](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getlocaldeviceid)获取本地设备id | function getLocalDeviceNetworkId(): string; <br> function getLocalDeviceName(): string; <br> function getLocalDeviceType(): number; <br> function getLocalDeviceId(): string; | 34| function getDeviceInfo(networkId: string, callback:AsyncCallback<DeviceInfo>): void | 使用[getDeviceName](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getdevicename)通过指定设备的网络标识获取该设备名称，<br> 使用[getDeviceType](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getdevicetype)通过指定设备的网络标识获取该设备类型 | function getDeviceName(networkId: string): string; <br> function getDeviceType(networkId: string): number; | 35| function getDeviceInfo(networkId: string): Promise<DeviceInfo> | 使用[getDeviceName](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getdevicename)通过指定设备的网络标识获取该设备名称，<br> 使用[getDeviceType](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#getdevicetype)通过指定设备的网络标识获取该设备类型 | function getDeviceName(networkId: string): string; <br> function getDeviceType(networkId: string): number; | 36| function startDeviceDiscovery(subscribeInfo: SubscribeInfo): void | 使用[startDiscovering](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#startdiscovering)发现周边设备 | function startDiscovering(discoverParam: {[key: string]: Object} , filterOptions?: {[key: string]: Object} ): void; | 37| function startDeviceDiscovery(subscribeInfo: SubscribeInfo, filterOptions?: string): void | 使用[startDiscovering](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#startdiscovering)发现周边设备 | function startDiscovering(discoverParam: {[key: string]: Object} , filterOptions?: {[key: string]: Object} ): void; | 38| function stopDeviceDiscovery(subscribeId: number): void | 使用[stopDiscovering](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#stopdiscovering)停止发现周边设备 | function stopDiscovering(): void; | 39| function publishDeviceDiscovery(publishInfo: PublishInfo): void | 废弃 | 无替代接口 | 40| function unPublishDeviceDiscovery(publishId: number): void | 废弃 | 无替代接口 | 41| function authenticateDevice(deviceInfo: DeviceInfo, authParam: AuthParam, callback: AsyncCallback<{deviceId: string, pinToken ?: number}>): void | 使用[bindTarget](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#bindtarget)认证设备 | function bindTarget(deviceId: string, bindParam: {[key: string]: Object} , callback: AsyncCallback<{deviceId: string}>): void; | 42| function unAuthenticateDevice(deviceInfo: DeviceInfo): void | 使用[unbindTarget](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#unbindtarget)解除认证设备 | function unbindTarget(deviceId: string): void; | 43| function verifyAuthInfo(authInfo: AuthInfo, callback: AsyncCallback<{deviceId: string, level: number}>): void | 废弃 | 无替代接口 | 44| function setUserOperation(operateAction: number, params: string): void | 使用[replyUiAction](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#replyuiaction)回复用户ui操作行为 | function replyUiAction(action: number, actionResult: string): void; | 45| function requestCredentialRegisterInfo(requestInfo: string, callback: AsyncCallback<{registerInfo: string}>): void; | 废弃 | 无替代接口 | 46| function importCredential(credentialInfo: string, callback: AsyncCallback<{resultInfo: string}>): void; | 废弃 | 无替代接口 | 47| function deleteCredential(queryInfo: string, callback: AsyncCallback<{resultInfo: string}>): void; | 废弃 | 无替代接口 | 48| function on(type: 'uiStateChange', callback: Callback<{ param: string}>): void; | 使用[on('replyResult')](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#onreplyresult)回复UI操作结果回调 | function on(type: 'replyResult', callback: Callback<{ param: string}>): void; | 49| function off(type: 'uiStateChange', callback?: Callback<{ param: string}>): void; | 使用[off('replyResult')](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#offreplyresult)取消回复UI操作结果回调 | function off(type: 'replyResult', callback?: Callback<{ param: string}>): void; | 50| function on(type: 'deviceStateChange', callback: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void | 使用[on('deviceStateChange')](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#ondevicestatechange)注册设备状态回调 | function on(type: 'deviceStateChange', callback: Callback<{ action: DeviceStateChange, device: DeviceBasicInfo }>): void; | 51| function off(type: 'deviceStateChange', callback?: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void | 使用[off('deviceStateChange')](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#offdevicestatechange)取消注册设备状态回调 | function off(type: 'deviceStateChange', callback?: Callback<{ action: DeviceStateChange, device: DeviceBasicInfo }>): void; | 52| function on(type: 'deviceFound', callback: Callback<{ subscribeId: number, device: DeviceInfo }>): void | 使用[on('discoverSuccess')](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#ondiscoversuccess)注册发现设备成功回调监听 | function on(type: 'discoverSuccess', callback: Callback<{ device: DeviceBasicInfo }>): void; | 53| function off(type: 'deviceFound', callback?: Callback<{ subscribeId: number, device: DeviceInfo }>): void | 使用[off('discoverSuccess')](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#offdiscoversuccess)取消注册设备发现成功回调 | function off(type: 'discoverSuccess', callback?: Callback<{ device: DeviceBasicInfo }>): void; | 54| function on(type: 'discoverFail', callback: Callback<{ subscribeId: number, reason: number }>): void | 使用[on('discoverFailure')](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#ondiscoverfailure)注册设备发现失败回调监听 | function on(type: 'discoverFailure', callback: Callback<{ reason: number }>): void; | 55| function off(type: 'discoverFail', callback?: Callback<{ subscribeId: number, reason: number }>): void | 使用[off('discoverFailure')](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#offdiscoverfailure)取消注册设备发现失败回调 | function off(type: 'discoverFailure', callback?: Callback<{ reason: number }>): void; | 56| function on(type: 'publishSuccess', callback: Callback<{ publishId: number }>): void | 废弃 | 无替代接口 | 57| function off(type: 'publishSuccess', callback?: Callback<{ publishId: number }>): void | 废弃 | 无替代接口 | 58| function on(type: 'publishFail', callback: Callback<{ publishId: number, reason: number }>): void | 废弃 | 无替代接口 | 59| function off(type: 'publishFail', callback?: Callback<{ publishId: number, reason: number }>): void | 废弃 | 无替代接口 | 60| function on(type: 'serviceDie', callback: () => void): void | 使用[on('serviceDie')](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#onservicedie)注册设备管理服务死亡监听 | function on(type: 'serviceDie', callback?: Callback<{}>): void; | 61| function off(type: 'serviceDie', callback?: () => void): void | 使用[off('serviceDie')](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#offservicedie)取消注册设备管理服务死亡监听 | function off(type: 'serviceDie', callback?: Callback<{}>): void; | 62| interface DeviceInfo | 使用[DeviceBasicInfo](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#devicebasicinfo)表示分布式设备基本信息 | interface DeviceBasicInfo | 63| interface SubscribeInfo | 废弃 | 无替代接口 | 64| interface AuthParam | 废弃 | 无替代接口 | 65| interface AuthInfo | 废弃 | 无替代接口 | 66| interface PublishInfo | 废弃 | 无替代接口 | 67| enum DeviceType | 废弃 | 无替代接口 | 68| enum AuthForm | 废弃 | 无替代接口 | 69| enum DeviceStateChangeAction | 使用[DeviceStateChange](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md#devicestatechange)表示设备状态 | enum DeviceStateChange | 70| enum DiscoverMode | 废弃 | 无替代接口 | 71| enum ExchangeMedium | 废弃 | 无替代接口 | 72| enum ExchangeFreq | 废弃 | 无替代接口 | 73| enum SubscribeCap | 废弃 | 无替代接口 | 74 75**适配指导** 76 77建议使用新模块的接口进行开发，参见[@ohos.distributedDeviceManager](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedDeviceManager.md)。 78