【接入指南 之 云云接入】快速接入HONOR Connect平台（上）

一、创建新产品

 1.1点击右上角的“管理中心”或首页“加入我们”，进入“产品开发”界面.

 1.1点击HONOR Connect进入开发步骤，点击产品开发>产品管理“+”号新建一款产品，

 1.3填写创建项目基本信息，选择产品品类，选择接入、通信类型、设备类型、设备认证方式。

 1.4选择接入云云对接接入方式，需完成云对接配置。

提示：

若遇特殊情况，云对接配置在“接口调测”步骤前完成即可 。

 

云对接配置

  1.4.1在文档中心，点击“设置”选择“云对接配置”进入信息配置页面。

  1.4.2在云对接配置页面，选择右上角的“编辑”对产品的“选择应用、企业信息、开发者OAuth（测试）、云对接测试、开发者OAuth（生产）、设备支持列表”信息进行详细配置。

    1.4.1.1选择应用：选择上传产品应用列表、应用包名。

提示：

选择产品应用列表请先下载阅读云云对接开发指南。

 

  1.4.3企业信息：

    1.4.3.1填写上传产品：品牌名称（中/英文）、品牌副标题（中/英文）。

    1.4.3.2上传产品品牌LOGO。

提示：

照片仅支持PNG格式、160*160px、288*288px。

LOGO上传后将会显示在荣耀智慧空间APP中。

品牌LOGO照片上传前请下载阅读 LOGO图片规范。

     1.4.3.3上传应用名称（中/英文） ，应用副标题（中/英文），应用描述（中/英文），品牌LOGO图片。

  1.4.4进行开发者（测试）

  1.4.5进行开发者云对接测试

  1.4.6进行开发者开发者OAuth（生产）

  1.4.7查看设备支持列表（仅支持已签收和已授权的产品）

1.5填写基本信息，点击“选择品类”选择产品接入方式为直接接入，根据产品配置选择：接入方式，通信类型，配网方式，设备类型，设备认证方式。（带*号的为必填项）

提示：

产品型号应与检测报告、法规证书、产品说明书、产品铭牌上的型号保持一致。

选择品类时请下载阅读HONOR Connect 生态认证法规认证要求Checklist。

涉及多型号时请勾选“涉及多型号”；

涉及多型号：勾选以支持定义多个产品子型号，为每个子型号分别配置不同外形、颜色展示图标，在智慧空间App以及其他产品管理入口进行区分展示。

型号编码：最多支持16 (0-F) 个子型号编码，子型号编码需要在产线预置，并调用HONOR Connect SDK对应接口传入，以支持在设备接入注册流程中进行绑定。

接入方式（产品创建成功后将不能更改此项）。

直连接入：通过端侧模组固件SDK集成完成HONOR Connect平台接入;

云云对接：通过帐号绑定授权完成HONOR Connect平台接入;

通信类型：产品创建成功后将不能更改此项。

配网方式：二维码仅可用于此单品，不可跨单品使用；选择配网方式前请仔细阅读配网二维码生成规范及视觉设计指导。

1.6选填“项目计划”，包括项目成立时间、硬件电路板完成时间、固件（嵌入式）开发完成时间、原型机认证时间等。

提示：

设备硬件开发完成时间：智能模组焊接到设备上的完成时间。

项目计划是为了更好的匹配您的商业计划，同时便于沟通，请尽可能完整的填写您的项目信息。

1.7填写“联系人”项目（带*的为必填项）。

提示：

项目经理、产品经理是为了更好的匹配您的商业计划，同时便于沟通，请尽可能完整的填写您的项目信息。

项目经理：角色职责：
               1）对项目进度负责。
               2）项目进度遇到阻塞时，需协调资源解决问题。
               3）项目为代理商交付时，项目负责人应该为代理商。

产品经理：若为代理商交付的项目，建议提供原厂可以确定功能定义的人的联系方式。

二、功能定义

1.新建标准服务

 1.1进入产品管理完成“创建项目”产品信息配置点击“下一步”进入功能定义界面。

 1.2可进行新建标准服务、新建自定义服务、复制品类功能配置。

 1.3点击选择“新建标准服务”，在右侧弹出框内输入需要添加的功能名称或直接勾选产品功能。

 1.4设定后点击“确定”返回功能定义界面，在新建标准服务列表可查看新增品类功能并可对新增功能进行编辑或删除。

提示：

必选功能无法删除。

新增品类功能前会用红色“·”提示。

功能定义列表右侧可随时下载产品“profile”

 

 1.5点击右侧“编辑”按钮可对产品属性进行编辑/删除/新增。

2.新建事件

 2.1若想要将消息推送至APP消息中心，可点击右侧新建事件，在右侧弹框中输入事件名称、事件标识，选择事件类型、输出参数，并勾选推送至APP消息中心。

提示：

对于接入HONOR Connect生态的智能硬件设备，可以将设备故障通知、耗材使用情况等消息通过消息推送的方式发送至荣耀智慧空间APP消息中心，以便用户了解并关注设备状态。

请严格遵守当地法律法规，推送内容请勿包含敏感词与违禁词；推送内容围绕产品功能设计，请勿包含隐性商业推广或其他不相关信息。

事件类型：事件是指终端设备主动推送给用户的特定瞬时信息；共分三种类型：消息 (如洗衣机完成洗衣) 、告警 (如冰箱门未关) 和故障 (如压缩机不工作)。

 2.2点击完成/确定返回“功能定义”列表。 

 

 

3.新建自定义服务

 3.1点击“新建自定义服务”，输入服务名称、服务标识，点击“确定”返回新建自定义服务列表。

提示：

新建自定义服务暂不支持语音控制、需手工配置设备联动、建议优先选择品类功能。

服务名称最多输入5个中文字、10个英文或10个数字。

服务标识只可输入英文或数字、且只能英文字符，最多25个字符。

 

 3.2新建自定义服务列表可对新建自定义服务进行编辑/删除。

  3.2.1点击“编辑”可“新增属性”。在右侧弹框编辑新增属性名称、属性标识，选择操作权限、数据类型。

提示：

操作权限：write是APP下发指令给设备；read是APP从设备获取数据；report是设备主动上报数据给APP。

数据类型：bool非真即假的二值型变量，如开关功能；enum自定义的有限集合值，如档位的高、中、低；int是厂商输入步长后系统传递整数值；string是厂商输入字符长度。

  3.2.2根据产品功能选择操作权限、数据类型。当数据类型为enum时需设置产品枚举值。

  3.2.3当数据类型为int时需设置取值范围和步长，以及是/否百分比显示。

    选是，则点击“确定”即可。

    选否，请根据单位使用规范填写单位。

     3.2.3.1当数据类型选string时，请输入字符长度。

提示：

该数据类型无标准化的界面UI呈现，增加该数据类型则需要线下自行定制开发UI。

字符长度最大为1000个字节。

 

3.2.4点击“确定”返回自定义功能列表。

 

4.复制品类功能

 4.1点击“复制品类功能”。

提示：

复制品类功能仅复制原产品服务能力，复制后将替换现有服务列表。

已驳回、已终止认证的产品无法进行复制。

 

4.2点击需要进行品复制类功能的产品，点击“确定”返回复制功能列表。

5.详情

 5.1点击功能定义列表右上角“详情”按钮可随时查看/编辑项目详情，包括产品信息、固件信息、项目计划、联系人。

 5.2在项目详情窗口还可查看项目认证进度详情。

三、APP设计

1.概述

荣耀智慧空间APP是接入HONOR Connect平台的重要入口，可以实现荣耀产品与合作伙伴产品的统一管理。合作伙伴可以通过开发设计、插件程序接入荣耀智慧空间APP，让消费者体验“智慧”生活带来的便捷。

• 产品添加：用户可通过荣耀智慧空间APP快速发现并添加产品。
• 产品管控：可通过荣耀智慧空间APP远程操控产品、查看状态、分类管理、共享产品、删除产品等。
• 场景联动：通过场景编排可以实现不同产品、不同功能的联动，为用户提供智慧化场景体验。

2.操作步骤

 2.1完成功能定义后，点击“下一步”进入APP设计界面。

提示：

未完成功能定义无法进入APP设计环节。

 

 

2.2选择开发方式为“线下自开发”。

提示：

1. 自开发指的是合作伙伴技能较好，有 H5 的开发技能可以完成页面的开发，或者厂家原来已有 H5 的包，经过小规模改造即可适配 HONOR Connect 平台。
2. 厂家在启动开发前需要联系接口人确认开发方式。
3. 厂家自开发的 UX 设计与编写的测试用例需要在上传 H5 包前完成。HONOR Connect 评审状态下仍可以进行 App 设计之后的环节开发。
4. 如果厂家采用自开发方式，需要符合《HONOR Connect App H5 开发指南》。

 2.3可在界面点击下载荣耀智慧空间APP开发指南和UX设计规范、UI设计源文件参考设计。

 2.4上传符合平台规范的UX设计稿，点击提交。

提示：

上传成功会出现弹窗提示，其他文件上传功能与此相同。

 2.5上传符合平台规范的插件程序，点击提交。

提示：

文件名不支持带空格；只支持包含英文字母、数字和特殊字符-_·压缩包中的文件夹名称，只支持包含英文字母、数字。

文件以插件程序­_001命名，压缩成插件程序_001.zip，且文件大小在20M以内。

 2.6上传荣耀隐私要求，点击“下一步”完成APP设计环节。

提示：

隐私声明：请根据产品的销售国家配置合适的地区版本和语言的隐私声明，详见《荣耀隐私要求》。

 2.7页面底部会显示审批流程记录。

四、接口调测

1.主要步骤

 1.1开发

选中，下载Demo、云云对接开发指南、FQA

 1.2测试

  选中，下载测试用例、云云对接测试指南

 

五、产品配置

1.1完成固件开发后，点击“下一步”进入产品配置界面。

提示：

未完成功能定义无法进入产品配置环节。

 1.2进行产品“产品图、配网步骤、APP首页、场景联动、产品国际化”信息配置。

 1.3上传产品图

   1.3.1（单型号）产品图上传 

提示：

上传前请仔细阅读《单品设备图片规范》，以免审核不通过导致认证失败。

  1.3.1.1可上传四种类型产品图：

    （1）第一张产品图用于首页、添加设备、手动添加页：格式尺寸：png、224px*224px，大小500k以内。

    （2）第二张产品图用于问题反馈的列表、场景选择设备、我的场景列表、设备分类管理：格式尺寸：png、160px*160px，大小500k以内。

    （3）第三张产品图用于设备详情页、连接设备大图：格式尺寸：png、1008px*1008px，大小500k以内。

    （4）第四张产品图用于连接设备页：格式尺寸：png、448px*448px，大小500k以内。

  1.3.2（多型号）产品上传

提示：

上传前请仔细阅读 《单品设备图片规范》 ,以免审核不通过导致认证失败。
图片文件命名需同子型号编码保持一致。如 0 (型号1) 入口需上传名为 0.png 的图片。

  1.3.2.1可上传四种类型产品图：

   （1）第一张产品图用于首页、添加设备、手动添加页：格式尺寸：png、224px*224px，大小500k以内。

   （2）第二张产品图用于问题反馈的列表、场景选择设备、我的场景列表、设备分类管理：格式尺寸：png、160px*160px，大小500k以内。

   （3）第三张产品图用于设备详情页、连接设备大图：格式尺寸：png、1008px*1008px，大小500k以内。

   （4）第四张产品图用于连接设备页：格式尺寸：png、448px*448px，大小500k以内。

 

1.4配网步骤图

 1.4.1在产品配置页面，点击“配网步骤图”，进入配网步骤图页面。

提示：

上传前请仔细阅读《单品设备图片规范》，以免审核不通过导致认证失败。

图片上传格式：PNG，尺寸1440px*1728px，大小500k以内。

 1.4.2点击右上角编辑图标可进行页面编辑，编辑后保存即可进行下一步操作。

 

1.5APP首页

 1.5.1完成配网步骤后，点击“下一步”，进入APP首页配置页面。

 1.5.2点击 “添加状态”。添加产品功能属性。

 1.5.3点击功能属性右侧“编辑”按钮，对具体功能属性进行设置。

a.自定义文本状态添加完成后显示情况：

点击操作下方的编辑图标，可进行状态的条件配置。

最多添加5个条件。

 

1.6场景联动

 1.6.1完成APP首页配置后，点击“下一步”，进入“场景联动”页面。

 1.6.2点击右上角“编辑”，即可编辑页面内容。

 1.6.3点击排序即可在功能列表中设定动作执行的顺序。

1.7产品国际化

 1.7.1完成场景联动配置后，点击“下一步”，进入“产品国际化”配置页面。

提示：

国际化配置完成后，如其他开发步骤中中文字段发生变更，须回到国际化配置页面更新保存。

 1.7.2点击右上角“编辑”即可编辑页面内容。

  1.7.2.1功能定义。在产品国际化页面点击右上方“编辑”即可对产品功能进行国际化配置。

  1.7.2.2APP界面显示。在产品国际化页面点击右上方“编辑”即可对产品APP界面显示进行国际化配置。

   1.7.2.3配网引导。在产品国际化页面点击右上方“编辑”即可对产品配网引导进行国际化配置。