一、概述

统一互联是鸿蒙生态中实现设备间互联互通的核心技术体系，旨在构建统一、开放、安全的设备互联标准，实现易用、可靠、安全、分布式的互联互通操作一体化体验。

本文聚焦于设备联动与控制场景，讲解从控制端开发到设备端开发的核心技术路径，涵盖云平台服务、APP控制端、IoT Connect SDK组件以及多平台设备Demo的完整开发指南。

二、技术架构总览

2.1 核心组成

组件	说明
鸿蒙生态云平台(HarmonyConnect Cloud)	网络统一组织和调用资源，提供服务
鸿蒙生态终端(HarmonyConnect Device)	连接到互联网络中可执行控制指令的电子化产品
鸿蒙生态配置器(HarmonyConnect Configurator)	配置应用终端并接入家庭局域网络的逻辑实体
鸿蒙生态通用互联APP(HarmonyConnect APP)	运行在智能设备中用于生态设备管理的应用程序
鸿蒙生态桥接设备(HarmonyConnect Bridge Device)	将非IP设备接入互联网络的设备

2.2 控制模式

模式	说明
点到点本地控(P2P)	手机与设备之间的直接控制，无需云平台支持
局域网本地控	外网断开时，通过家庭局域网发送控制命令
远程控制	通过云平台实现远程设备控制

三、开发指南章节索引

3.1 基础概念与概述

章节	内容简介
联动与控制概述	系统架构、控制模式、接口标准详解

3.2 控制端开发

3.2.1 通用互联APP

通用互联APP是鸿蒙生态中的核心控制入口，支持设备发现、配网、控制、场景联动等功能。

章节	内容简介
通用互联APP简介	功能介绍、代码获取安装
通用互联APP代码讲解	开发代码详细解释

3.2.2 云平台服务

云平台提供账号管理、物模型、设备管理、场景联动等核心服务。

章节	内容简介
云平台总览	云平台模块概览
账号云	账号管理、用户组织管理、权限认证
物模型云	物模型定义与管理
设备管理云	设备注册、绑定、状态管理
场景云	场景联动配置与管理
云平台后台管理	运营管理后台功能

3.3 设备端开发

3.3.1 IoT Connect SDK

IoT Connect SDK是专为OpenHarmony资源受限的瘦设备构建的连接控制核心组件，提供发现配网、端云连接等能力。

章节	内容简介
SDK组件简介	功能介绍、模块说明、接口API

3.3.2 设备Demo构建

以下是针对不同芯片平台和套餐类型的Demo构建指南：

RK3568平台（标准系统）

套餐类型	场景说明
WiFi Only	模拟瘦设备发现配网云控受控端
BLE Only	模拟瘦设备发现配网云控受控端
WiFi/BLE Combo	模拟瘦设备发现配网云控受控端

Hi3863平台（轻量级系统）

套餐类型	场景说明
WiFi Only	瘦设备点对点本地控受控端
BLE Only	瘦设备点对点本地控受控端
WiFi/BLE Combo	瘦设备发现配网云控受控端
BLE/SLE Combo	星闪生态设备

星闪桥设备（基于RK3568 + Hi3873E）

套餐类型	场景说明
WiFi/BLE/SLE Combo	星闪桥设备

四、开发流程指引

4.1 控制端开发流程

1. 云平台服务详解

• 账号云、物模型云、设备管理云、场景云等服务详解，参考云平台各模块文档

2. 开发控制APP

• 获取通用互联APP源码：ohos-connect-hap
• 参考APP开发指南

4.2 设备端开发流程

1. 云平台注册

• 在云平台注册产品信息，获取产品ID（prodId）、厂商ID（manuId）
• 创建物模型，定义服务、事件、特征

2. 选择硬件平台

• 标准系统设备：选择RK3568开发板
• 轻量级设备：选择Hi3863开发板

3. 选择套餐类型

• 仅本地控制：WiFi Only或BLE Only
• 需要云端远程控制：WiFi/BLE Combo

4. 获取IoT Connect SDK

• 仓库地址：IoT Connect SDK

5. 开发设备Demo

• 参考对应平台的Demo构建文档
• 配置设备信息、服务定义、对接IoTConnect组件

6. 编译烧录

• 按照Demo文档中的编译指南进行构建和烧录

4.3 联合调试

1. 联系统一互联PMC或在laval社区提单，进行APP白名单配置
2. 安装通用互联APP至HarmonyOS Next手机
3. 设备上电，启动配网流程
4. 在APP中扫描发现设备，完成配网
5. 控制设备，验证功能

五、技术标准参考

标准名称
鸿蒙生态设备统一互联 物模型技术标准
鸿蒙生态设备统一互联 接入与控制接口技术标准

六、代码仓库索引

仓库名称	仓库地址	用途说明
IoT Connect SDK	https://gitcode.com/ohos-oneconnect/communication_iot_connect	设备端互联核心组件
通用互联APP	https://gitcode.com/ohos-oneconnect/ohos-connect-hap	控制端APP
示例代码仓	https://gitcode.com/ohos-oneconnect/applications_sample_iot_connect_samples	设备Demo示例
云平台-账号	https://gitcode.com/ohos-oneconnect/cloud-account	账号云服务
云平台-物模型	https://gitcode.com/ohos-oneconnect/cloud-model	物模型云服务
云平台-设备管理	https://gitcode.com/ohos-oneconnect/cloud-device	设备管理云服务
云平台-场景	https://gitcode.com/ohos-oneconnect/cloud-business	场景云服务
云平台-后台管理	https://gitcode.com/ohos-oneconnect/cloud-manager	后台管理功能