# 设备管理 >![](../../public_sys-resources/icon-note.gif) **说明：** >从 API Version 7 开始支持。 ## 导入模块 ``` import deviceManager from '@ohos.distributedHardware.deviceManager'; ``` ## deviceManager.createDeviceManager createDeviceManager\(bundleName: string, callback: AsyncCallback\): void 创建一个设备管理器实例。 - 参数：

参数名	类型	必填	说明
bundleName	string	是	指示应用程序的包名。
callback	AsyncCallback<DeviceManager>	是	DeviceManager实例创建时调用的回调，返回设备管理器对象实例。

- 示例： ``` deviceManager.createDeviceManager("ohos.samples.jshelloworld", (err, data) => { if (err) { console.info("createDeviceManager err:" + JSON.stringify(err)); return; } console.info("createDeviceManager success"); this.dmInstance = data; }); ``` ## DeviceStateChangeAction 表示设备状态变化的枚举。

名称	默认值	说明
ONLINE	0	设备上线。
READY	1	设备就绪，设备信息同步已完成。
OFFLINE	2	设备下线。
CHANGE	3	设备信息更改。

## DeviceType 表示设备类型的枚举类。

名称	默认值	说明
SPEAKER	0x0A	智能音箱
PHONE	0x0E	手机
TABLET	0x11	平板
WEARABLE	0x6D	智能穿戴
TV	0x9C	智慧屏

## DeviceInfo 设备信息。

名称	类型	必填	描述
deviceId	number	是	设备的唯一标识。
deviceName	string	是	设备名称。
deviceType	number	是	设备类型。

## DeviceManager 设备管理实例，用于获取可信设备和本地设备的相关信息。在调用DeviceManager的方法前，需要先通过createDeviceManager构建一个DeviceManager实例dmInstance。 ### release release\(\): void 设备管理实例不再使用后，通过该方法释放DeviceManager实例。 - 示例： ``` dmInstance.release(); ``` ### getTrustedDeviceListSync getTrustedDeviceListSync\(\): Array 同步获取所有可信设备列表。 - 返回值：

名称	说明
Array<DeviceInfo>	返回可信设备列表。

- 示例： ``` var deviceInfoList = dmInstance.getTrustedDeviceListSync(); ``` ### on\('deviceStateChange'\) on\(type: 'deviceStateChange', callback: Callback<\{ action: DeviceStateChangeAction, device: DeviceInfo \}\>\): void 注册设备状态回调。 - 参数：

名称	参数类型	必填	说明
type	string	是	注册设备状态回调，固定为deviceStateChange。
callback	Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>	是	指示要注册的设备状态回调，返回设备状态和设备信息。

- 示例： ``` dmInstance.on('deviceStateChange', (data) => { console.info("deviceStateChange on:" + JSON.stringify(data)); } ); ``` ### off\('deviceStateChange'\) off\(type: 'deviceStateChange', callback?: Call back<\{ action: DeviceStateChangeAction, device: DeviceInfo \}\>\): void 取消注册设备状态回调。 - 参数：

名称	参数类型	必填	说明
type	string	是	根据应用程序的包名取消注册设备状态回调。
callback	Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>	是	指示要取消注册的设备状态回调，返回设备状态和设备信息。

- 示例： ``` dmInstance.off('deviceStateChange', (data) => { console.info('deviceStateChange' + JSON.stringify(data)); } ); ``` ### on\('serviceDie'\) on\(type: 'serviceDie', callback: \(\) =\> void\): void 注册设备管理服务死亡监听。 - 参数：

名称	参数类型	必填	说明
type	string	是	注册serviceDie回调，以便在devicemanager服务异常终止时通知应用程序。
callback	() => void	是	注册serviceDie的回调方法。

- 示例： ``` dmInstance.on("serviceDie", () => { console.info("serviceDie on"); } ); ``` ### off\('serviceDie'\) off\(type: 'serviceDie', callback?: \(\) =\> void\): void 取消注册设备管理服务死亡监听。 - 参数：

名称	参数类型	必填	说明
type	string	是	取消注册serviceDie回调，以便在devicemanager服务异常终止时通知应用程序。
callback	() => void	否	取消注册serviceDie的回调方法。

- 示例： ``` dmInstance.off("serviceDie", () => { console.info("serviceDie off"); } ); ```