写点什么

【接入指南 之 直接接入】手把手教你快速上手接入 HONOR Connect 平台(上)

  • 2022 年 8 月 10 日
    中国香港
  • 本文字数:4185 字

    阅读完需:约 14 分钟

一、创建新产品

1.1 登录 HONOR Connect 平台,点击右上角的“管理中心”或首页“加入我们”。

1.2 点击“HONOR Connect”进入“产品开发”界面,点击“产品管理”。

1.3 在产品管理页签下,点击“+”号新建一款产品。

1.4 填写基本信息,点击“选择品类”选择产品接入方式为直接接入,根据产品配置选择:接入方式,通信类型,配网方式,设备类型,设备认证方式。(带*号的为必填项)

 

提示:

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

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

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

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

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

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

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

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

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

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

 

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

提示:

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

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

1.6 填写“联系人”项目(带*的为必填项)。

提示:

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

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

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

 

二、产品定义

平台支持通过新建标准服务、新建自定义服务、复制品类功能、方法、事件来定义产品功能。

1.基本概念

新建标准服务:用于设置同品类产品都有的功能,例如台灯的开关等。

新建自定义功能:用于设置产品的特有属性。当平台提供的功能不能满足新产品特有功能需求时,开发者可通过自定义的方式实现定制化需求。

复制品类功能:复制品类功能仅复制 原产品服务能力。

2.创建一款新产品

 2.1 登录 HONOR Connect 平台,点击右上角的“管理中心”或首页“加入我们”。

 2.2 左侧导航栏中选择“产品开发>产品管理”,点击开发中的产品,进入“功能定义”界面。

 2.3 选择“新建标准服务”页签。

 

3.新建标准服务

  3.1 在“功能定义”页签中,点击“新建标准服务”。

  3.2 勾选所需要的功能,并点击“确定”。


4.新建自定义服务

 4.1 选择“新建自定义服务”页签。

 

提示:

自定义服务暂不支持部分功能,建议优先选择标准服务。

 

5.复制品类功能

提示:

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

 5.1 选择“复制品类功能”页签,进入选择源产品界面

 5.2 根据页面提示选择相关产品,并点击“确定”。

 

6.了解 profile 数据类型

了解 profile 文件的数据类型,有助于在产品开发与应用开发中实现相关功能。

产品 profile 支持的数据类型包括:整型(int)、字符串(string)、枚举(enum)。

 

7.产品 profile 属性举例

(以耳机为例)

 

三、功能定义

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 点击“新建自定义服务”,输入服务名称、服务标识,点击“确定”返回新建自定义服务列表。

 

提示:

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



 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 在项目详情窗口还可查看项目认证进度详情。

6.了解 profile 数据类型

了解 profile 文件的数据类型,有助于在产品开发与应用开发中实现相关功能。

产品 profile 支持的数据类型包括:整型(int)、字符串(string)、枚举(enum)。

 

7.产品 profile 属性举例

(以耳机为例)



三、功能定义

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 在项目详情窗口还可查看项目认证进度详情。

用户头像

还未添加个人签名 2022.06.28 加入

还未添加个人简介

评论

发布
暂无评论
【接入指南 之 直接接入】手把手教你快速上手接入HONOR Connect平台(上)_开发者_荣耀开发者服务平台_InfoQ写作社区