统一互联生态设备配网FAQ

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
参照上述解析规则，解析后字段说明如下图：

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设备详情页如何跳转

厂商适配跳转详情页请联系统一互联项目组。

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 ,可以将日志解析。

13.智慧生活beta版本调试

厂商在接入鸿蒙智联后，可以在鸿蒙智联DP平台申请beta版本智慧生活。注意：该方式申请的安装包不要提供给真实用户。
申请方法：在dp平台提交工单，提供测试手机的系统版本号，智慧生活的版本号，测试手机的uuid。
uuid 获取方法：

hdc shell
bm get -u

在DP平台下载beta版本智慧生活附件包，在window电脑下解压该安装包，执行附件中的install.bat工具（需要配置hdc环境 ）。
安装成功后，打开智慧生活，智慧生活主页会有beta标识。
环境切换：智慧生活>我的>设置>开发者选项>环境设置>认证沙箱
切换后，重新打开智慧生活，在主页下拉刷新，多刷新几次。然后进入智慧生活>我的 >连接三方平台，三方厂商名称后面出现认证标识，说明切换沙箱环境成功，如果没有成功，重复上述操作。