1.弹窗UI配置

生态设备配网弹窗需要三方厂商提供提供设备中英文传播名和设备传播图。
标题命名规则：品牌名+产品名+型号
设备传播图规范：https://developer.huawei.com/consumer/cn/doc/design-guides/i-connect-0000002354482789
中英文传播名显示不要超过一行，设备传播图需要适配暗黑模式

示例如下：
中文传播名：中移智鸿智能摄像头C619A
英文传播名：AOS Smart Camera C619A
图片：https://smarthome-drcn.dbankcdn.cn/device/guide/oneconnect/Z1234/iconB.png

2.靠近发现广播报文

OpenHarmony 生态靠近发现广播格式参考如下

广播定义可参考
https://device.harmonyos.com/cn/docs/DevicePartner-Guides/DevicePartner-Guides/device-development-ble-specifications-advertising-0000001352545729#section1719614474446

示例：
0X16 0xEEFD011707040011F7155A30303036FF0004023738
参照上述解析规则，解析后字段说明如下图：

调试工具 ：可以在应用市场下载BLE调试精灵。

BLE调试精灵搜索到海尔柜机空调靠近发现广播截图如下：

点击扫描到的广播，查看广播AD Data。图中画红框的部分为靠近发现广播报文。

3.弹窗抑制规则

不弹窗场景：

• 振铃、拨号 、通话中；
• 阔折叠外屏；
• 账号未登录 、无网络；
• 未同意智慧生活权限隐私；

抑制规则：

• 一个亮屏周期 ，同一个设备只弹框一次；
• 同一个设备连续取消两次，抑制7天；连续取消3次，永久抑制；

调试过程抑制恢复手段：

• 方法1：手机账号退出登录，重新登陆后同意智慧生活APP权限隐私
• 方法2：执行命令hdc shell bm clean -d -n com.huawei.hmos.ailifesvc，重新打开智慧生活APP

4.云云对接获取手机号权限如何申请

厂商接入弹窗配网，需要厂商应用申请获取华为账户手机号权限，可以参考如下文档。
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V14/account-config-permissions-V14

注意事项：

• 该权限为受控权限，申请后，联系统一互联项目对接人员
• 已经接入过鸿蒙智联云云对接套餐的厂商，使用之前对接的appid申请该权限

5.云云对接接口指导

云云对接接口指导请联系统一互联项目组。

6.配网时手机侧如何获取设备信息

手机侧同厂商设备连接成功，通过customSecData指令查询设备信息。
查询参数如下：

{
    "sid": "deviceInfo"
}

返回值：参考 iot_connect 组件IotcDeviceInfo结构体定义，新增以下字段，厂商用于扩展。

{
    ...
    "customData": "xxxxx", // 厂商自定义扩展信息
}

7.配网时手机侧如何下发配网指令

手机侧通过netCfg指令给设备下发配网指令。

{
    "ssid": "xxxx", // wifi ssdid
    "password": "xxxx", // wifi 密码
    "verifyCode": "xxxx", // 配网verifyCode
    "customData": "xxxx" // 厂商自定义扩展信息
}

8.设备主动上报

配网指令下发成功后，设备会给手机侧上报配网进度。
响应字段：

{
    "service": "netCfg", // 固定字段
    "status": 100, // 配网过程值
}

status取值	含义
100	wifi 连接成功
102	wifi 连接失败
104	wifi 连接中
202	wifi 设备配网失败

9.手机侧怎么判定配网成功

手机侧给设备下发配网指令后，当手机侧收到家居云mqtt绑定设备的指令并且轮询设备配网状态为成功，认为配网成功；
或者设备给手机上报wifi连接成功响应但10秒后没有收到mqtt绑定设备的指令，手机侧主动轮询设备配网状态且成功查询设备快照，认为配网成功。

10.三方APP如何适配APP link

参考以下文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-linking-startupapp

11.三方厂商H5设备详情页跳转按钮配置

DP平台上已有组件，将该组件拖到H5配置参数。

12.三方APP如何接受H5设备详情页跳转参数

解析Want对象parameters中的扩展参数

参数	含义
action	固定值action.oneconnect.device.detail
deviceId	三方设备ID

厂商可以使用以下DEMO调试app-linking跳转

    let context = getContext(this) as common.UIAbilityContext;
    context.openLink("applink", {
        appLinkingOnly: true,
        parameters: {
            "action": "action.oneconnect.device.detail",
            "deviceId": "xxxx"
        }
    }).then((value) => {
        hilog.info(DOMAIN, 'testTag', '%{public}s', 'openLink');
    }).catch((error: BusinessError) => {
        hilog.info(DOMAIN, 'testTag', '%{public}s', 'openLink error ' + error.message);
    })

13.如何导出手机测日志

方法1：shell窗口执行获取日志命令：hdc shell hilog > test.log回车后，操作复现步骤，日志就可以实时获取了
按ctrl+c结束当前命令

方法2：hdc file recv data/log/hilog 到本地，将对应日期的日志和hilog_dict_xxxx.zip 拷贝后打包，发送给对接人员。或者执行 hdc parse ,可以将日志解析。

14.beta版智慧生活申请方式

1.使用参与测试的华为账号登录DP（Device Partner）平台，进入账号管理-基本资料-申请测试权限，提交后等待处理完成。
2.测试手机登录具有测试权限的华为账号，前往应用市场下载最新版本“智慧生活”APP。
3.打开智慧生活APP会自动切换到沙箱环境，可以前往：我的->连接三方平台，厂商名称后面显示“认证”即确认当前是沙箱环境。

• 该方式不再与手机uuid绑定，用具有测试权限的华为账号登录即可。申请测试权限的华为账号需要加入企业群组，如果未加入用DP平台管理员账号邀请加入。
• 如果智慧生活未自动切换到沙箱环境，可以按照以下方法排查：1. 请确认华为账号是否已获得测试权限；2. 检查 智慧生活APP->我的->设置->关于->鸿蒙智联基础服务版本，应不低于17.0.2.310，低于该版本需更新到最新版本。
• 具有测试权限的华为账号如果想要连接商用环境，需取消测试权限。

15. 云测流控策略

• 设备控制消息流控：同一用户，同一设备，1S内限制 15次；
• 数据上报流控：10S内相同数据不会再上报

16. 配网流程DMOE

17. 一件配网DEMO

18.非OH设备适配靠近发现配网

代码基线

选择ohos-oneconnect dev0427分支

源码集成

SDK 使用GN 编译，如果集成的系统不支持GN，将gn文件中iot_connect_ble_support = true 的所有代码添加到项目中编译。
mbedtls，cJson，bounds_checking_function iot_connect中使用以下版本，如果版本不匹配，自行调整。

mbedtls

项目中mbedtls版本使用3.X，仓库路径可参考https://gitcode.com/openharmony/third_party_mbedtls

cJson

项目中mbedtls版本19，仓库路径可参考https://gitcode.com/openharmony/third_party_cJSON

bounds_checking_function

仓库路径可参考 https://gitcode.com/openharmony/third_party_bounds_checking_function

OS适配

iot_connect 中，适配了cmsis2，posix和freertos，其他OS需要参考代码自行适配。

DEMO 参考

仓库路径：https://gitcode.com/ohos-oneconnect/applications_sample_iot_connect_samples/tree/master/Nearby_Discovery_Popup/popup_network_configuration