# 设备管理 >![](../../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"); } ); ```
参数名
类型
必填
说明
bundleName
string
是
指示应用程序的包名。
callback
AsyncCallback<DeviceManager>
DeviceManager实例创建时调用的回调,返回设备管理器对象实例。
名称
默认值
ONLINE
0
设备上线。
READY
1
设备就绪,设备信息同步已完成。
OFFLINE
2
设备下线。
CHANGE
3
设备信息更改。
SPEAKER
0x0A
智能音箱
PHONE
0x0E
手机
TABLET
0x11
平板
WEARABLE
0x6D
智能穿戴
TV
0x9C
智慧屏
描述
deviceId
number
设备的唯一标识。
deviceName
设备名称。
deviceType
设备类型。
Array<DeviceInfo>
返回可信设备列表。
参数类型
type
注册设备状态回调,固定为deviceStateChange。
Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>
指示要注册的设备状态回调,返回设备状态和设备信息。
根据应用程序的包名取消注册设备状态回调。
指示要取消注册的设备状态回调,返回设备状态和设备信息。
注册serviceDie回调,以便在devicemanager服务异常终止时通知应用程序。
() => void
注册serviceDie的回调方法。
取消注册serviceDie回调,以便在devicemanager服务异常终止时通知应用程序。
否
取消注册serviceDie的回调方法。