HarmonyOS实战开发-如何实现设备管理相关的功能。

介绍

本示例主要展示了设备管理相关的功能，使用@ohos.distributedHardware.deviceManager 等接口，实现了包括获取本机设备信息，获取授信设备列表，根据过滤条件扫描设备，设备认证，设备状态订阅，导入凭据，控制设备是否允许被发现等功能。

效果预览

使用说明

1. 进入应用会自动获取本机设备信息，并且注册设备状态监听，在有设备上下线的时候，刷新可信设备列表
2. 在主界面，可以点击允许被发现开关控制本机是否允许被发现；
3. 在主界面，可以点击刷新，刷新可信设备列表，点击已认证，解除认证关系；
4. 在主界面，可以点击过滤条件，选择对应的过滤条件，在发现设备时进行过滤；
5. 在主界面，可以点击发现，发现周边的设备，并点击发现的设备，进行PIN码认证；

工程目录

entry/src/main/ets/
|---common
|   |---Constant.ets                       // 弹窗工具
|   |---Logger.ets                         // 日志工具
|---entryability
|---model
|   |---RemoteDeviceModel.ets              // 主要封装了DeviceManager库相关的接口，实现相关的功能
|---pages
|   |---index.ets                          // 首页
|   |---FilterOption.ets                   // 过滤条件页面
|   |---ListDeviceView.ets                 // 列表设备组件

具体实现

获取本机设备信息，获取授信设备列表，根据过滤条件扫描设备，设备认证，设备状态订阅，控制设备是否允许被发现等功能，接口封装在RemoteDeviceModel

* 使用RemoteDeviceModel.createDeviceManager()来获取DeviceManager对象；
* 获取本机设备信息：调用RemoteDeviceModel.getLocalDeviceInfo()来获取本机设备信息；
* 注册设备状态监听：调用RemoteDeviceModel.registerDeviceStateListener()，来注册设备状态监听;
* 获取可信设备列表：调用RemoteDeviceModel.getTrustedDeviceList()来获取可信设备列表;
* 发布设备：调用RemoteDeviceModel.setIsSupportRange()设置是否上报距离，然后调用deviceManager.publishDeviceDiscovery()发布设备;
* 停止发布设备：调用RemoteDeviceModel.unAuthenticateDevice()停止发布;
* 发现和停止发现设备：调用RemoteDeviceModel.startDeviceDiscovery()发现设备，调用RemoteDeviceModel.stopDeviceDiscovery()停止发现设备;
* 认证和取消认证设备：调用RemoteDeviceModel.authenticateDevice()认证，调用RemoteDeviceModel.unAuthenticateDevice()取消认证设备;

相关概念

设备管理：用于获取可信设备和本地设备的相关信息。在调用DeviceManager的方法前，需要先通过createDeviceManager构建一个DeviceManager实例。

相关权限

允许系统应用获取分布式设备的认证组网能力：ohos.permission.ACCESS_SERVICE_DM。

约束与限制

1.本示例需要组网测试。

2.本示例仅支持标准系统上运行，支持设备：RK3568。

3.本示例为Stage模型，支持API10版本SDK，SDK版本号(API Version 10 Release),镜像版本号(4.0 Release)。

4.本示例需要使用DevEco Studio 版本号(4.0 Release)及以上版本才可编译运行。

5.本示例需要使用@ohos.distributedHardware.deviceManager系统权限的系统接口。使用Full SDK时需要手动从镜像站点获取，并在DevEco Studio中替换。

6.本示例涉及系统接口，需要配置系统应用签名，可以参考特殊权限配置方法 ，把配置文件中的“app-feature”字段信息改为“hos_system_app”。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo code/SystemFeature/DistributedAppDev/DistributedAuthentication > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master