远程台灯功能

简介
碰一碰特性是HarmonyOS具备的多终端业务协同技术。通过碰一碰的交互方式，可以将手机和全场景设备连接起来。再通过手机端的原子化服务能力，快速完成配网、远程控制。解决了应用与设备之间接续慢、配网复杂、传输难的问题，为用户带来无缝切换的流畅体验。

本篇Codelab将指导大家如何开发一个模拟的“远程台灯”案例。在本案例中，通过手机碰一碰NFC标签，可以从HAG获取到关联意图信息。通过获取到的关联意图信息，可以拉起对应的原子化服务。该原子化服务通过调用hilink接口，并结合设备侧代码实现，可以完成开发板与手机间的配网并建立通信通道。完成此步骤后，即可通过手机控制Hi3861开发版中LED灯的开关了。

通过该案例，大家将会学会：

通过碰一碰能力，拉起手机端原子化服务。

快速完成手机与设备的配网。

通过手机对设备进行控制。

说明： 本指导仅用于个人开发者体验HarmonyOS碰一碰特性，不能作为商用方案进行碰一碰特性的开发和上架。

实物简介
Hi3861开发板

华为手机，系统版本为HarmonyOS 2.0.0.168及以上，手机具体型号为Mate 40 Pro。将手机上智慧生活基础服务升级至12.0.0.306及以上版本。具体操作步骤如下：

查看“智慧生活基础服务”版本，打开手机“设置>应用服务>应用管理”，搜索“智慧生活基础服务”。
升级“智慧生活基础服务”，打开手机“智慧生活”App，点击“我的 > 设置 > 检查应用更新”，更新“智慧生活基础服务”。
Hi3861开发板
本样例基于Hi3861开发板开发，请准备Hi3861开发板（HiSpark Wi-Fi IoT智能家居套件）。包含开发板主板、底板和OLED板。

HarmonyOS原子化服务开发
创建工程
设备配网原子化服务（entry）
设备控制原子化服务（control）
本案例将要实现“碰一碰-拉起原子化服务-设备配网-设备控制”的完整流程，整个流程都要基于手机端的原子化服务实现。开发原子化服务使用的工具为DevEco Studio 3.0 Beta2，关于工具配置请查看官方指导文档搭建开发环境流程。

打开创建工程向导界面，选择“Empty Ability”模板创建原子化服务，用于设备配网。

在工程配置中，Project type选择“Atomic Service”，并打开“Show in Service Center”选项，点击Finish按钮即可完成创建设备配网原子化服务。

在已创建好的“entry”目录上右击，选择“Empty Ability”模板新建一个Module，用于设备控制。

在模块配置界面，“Module type”中选择的“Feature”，点击“Next”。

配置Module的“Page ability name”，点击“Finish”完成创建。

设备配网原子化服务（entry）
配网过程需要依赖hilink的接口，因此首先需要在entry\build.gradle中加入对hilink的依赖。

dependencies {
    ...
    ohosTestImplementation 'com.huawei.ohos.testkit:runner:2.0.0.200'
}

手机碰一碰nfc标签，将会拉起用于配网的原子化服务（entry模块）。在服务的入口MainAbility中，完成了对nfc中的产品信息的读取，以及将“abilityContext”和从意图中获取的“nanSessionId”注册到用于配网的NetConfigAbility中。

// 读取产品信息
Object productInfo = Objects.requireNonNull(intent.getParams()).getParam("productInfo");
if (productInfo != null) {
    productId = (String) productInfo;
}

// 从intent中读取的nanSessionId用于配网，同时需要将abilityContext和ses