一.名词解释：

产品状态：描述开发者创建的Product ID开发环节的状态，已发布的Product ID将上线完整软硬件能力

• 开发中：开发者新创建的Product ID，可完整定义软硬件能力；提交更新后的Product ID，除品类、通信协议外的，其它可修改定义；提交发布审核被驳回的Product ID，可完整定义软硬件能力
• 审核中：提交小二审核，此时均不可修改
• 已发布：小二审核通过，产品状态变为已发布，此时均不可修改

量产状态：描述开发者创建的Product ID生产环节的状态

未量产：开发者未申请三元组，或提交量产三元组申请被小二驳回的状态

审核中：“产品状态”已发布，开发者提交三元组量产申请，小二尚未审核的状态

已量产：“产品状态”已发布，开发者提交三元组量产申请，小二审核通过的状态

上架状态：指量产即将销售，将Product ID透出在天猫精灵App中，可在天猫精灵App-我家-添加设备中搜索露出

未上架：开发者未提交上架，或提交上架申请后被小二驳回的状态

审核中：“产品状态”已发布、“量产状态”已量产，小二尚未审批的状态

已量产：“产品状态”已发布、“量产状态”已量产，小二审核通过后的状态，示例如下：

二、新手教程

1.产品开发-添加新产品

进入”产品开发“首页，点击添加新产品。个人开发者可创建10个产品，企业开发者可创建50个产品

选择需要开发的产品品类，点击查看天猫精灵已支持的品类列表

填写待开发产品的品牌、名称、型号及通讯协议。产品软件发布及上线后，天猫精灵音箱将按录入的品牌播报，天猫精灵App将按录入的品牌、产品名称提供用户搜索和界面展示。

2.产品定义

选择产品支持的功能，已选择的功能将呈现在功能列表中，分为”属性、事件、服务“。

属性：描述设备具备的下发控制、状态上报功能，如开关、模式调节

事件：描述设备上报的信息、故障、告警，如低电量上报

服务：描述由天猫精灵云端提供的服务能力，如定时开关

选择确认产品功能后，点击”下一步“，进入”人机交互“。 

3.人机交互

控制口令：

平台根据开发者所选功能将自动生成对应的语音语料，功能对应的全部意图（打开、关闭、查询等）、语料将呈现在语料区域。相关泛化语料未全部呈现，开发者可在设备调试-调试中心对语料进行泛化测试。

触屏交互：

产品展示图：

按天猫精灵产品展示图视觉规范，上传产品图素材，用于天猫精灵App-我家、添加设备搜索及设备详情页产品展示。此项为必填。

配网引导：

平台新建的产品默认支持天猫精灵音箱语音配网（”天猫精灵，找队友“）。除此外，用户可通过天猫精灵App对蓝牙BLE Mesh、蓝牙BLE GATT或WiFi设备配网绑定，绑定成功后，可通过天猫精灵音箱语音或天猫精灵App控制、查询等。

升级引导：

平台创建的产品，可在开放平台“设备管理”新增固件，验证测试通过发布后，会推送至天猫精灵App-我家-设备详情页设备升级入口

固件新增时，为提供给用户友好的交互体验，开发者需录入完整的升级向导图文介绍

控制面板

平台提供标准面板与自定义面板2种接入方式，目前开放的屏显端为天猫精灵App，天猫精灵CC、电视、手表、车机等生态线暂未开放。

默认面板：无需二次开发，根据产品定义功能自动生成

自主面板：需开发者基于组件能力自主开发、测试验证后上传。目前开放H5面板，后续将开放支付宝小程序，可支持多端面板投放，视觉及前端规范：

• 面板框架视觉规范
• 面板组件视觉规范
• 面板组件开发规范

将已开发好的控制面板打包（格式.zip）上传至平台，生成虚拟设备。使用开发者淘宝账号登陆天猫精灵App，扫描平台生成的二维码，进入虚拟设备控制面板调试页面。

设备消息

基于开发者定义的功能，平台提供常用的消息模板。开发者编辑触发条件后，会自动生成消息，目前可在天猫精灵音箱语音端，天猫精灵App端推送

勾选消息模板后，提交成功后生效

4.设备调试

选择设备模组及型号，用于开发硬件设备及调试。

生成三元组-点击查看，查看测试三元组，开发者可将三元组烧录至固件，同时联调测试多个设备可下载测试三元组列表。个人开发者10组测试三元组，企业开发者50组测试三元组。

进入调试中心前准备：

1. 使用开发者淘宝账号配网绑定天猫精灵音箱，已绑定的音箱将呈现在调试音箱列表中，选需要的测试的音箱（音箱型号和音箱Device ID）
2. 对所选的调试音箱，使用”天猫精灵，找队友“语音配网，将IoT硬件设备加入调试绑定设备列表中

已配网后的IoT设备将出现在”选择调试绑定设备列表“中：

选择在线调试进入调试前台，选择查看日志进入设备在线日志前台。点击查看调试中心详细指导

5.软件发布

软件发布前，开发者须使用调试中心完成语音、App进行完整软件功能测试，在实验室及产线进行完整硬件性能测试后，确认产品品牌、品类等信息无误。

• 下载配网二维码，并透传在说明书，商品详情页，帮助用户快速完成配网绑定
• 上传涵盖天猫精灵语音配网、App配网及基本功能语料指导的说明书。说明书模板
• 将完整配网绑定、语音功能、App功能使用录制视频上传至优酷，将视频链接录入至平台

完成以上信息后，点击立即发布，即可提交软件发布审核。

6.软件更新

已发布的产品，在小批量测试及产测如发现bug或缺陷需修复时，可提交更新，提交确认后产品状态回退至开发中，可修改品类、通信协议之外的内容，修复bug或缺陷，再次提交小二审核。

已发布的产品，申请量产三元组审核通过后进入“产品状态：已发布”，“量产状态：已量产”状态

已发布、已量产的产品不能更新

已发布、已量产的产品不能更新

已发布、已量产的产品不能更新

重要的事情说三遍！

7.量产管理

已提交审核的产品列表，开发者可在设备管理-上线管理中查看全部设备状态及列表。提交审核被驳回的将会以开发中（被驳回）状态呈现，鼠标移至驳回可查看小二驳回原因，并按规范进行修改。

8.上架管理

考虑到产品开发环节和量产厂测环节debug时，会存在较多测试Product ID，为在天猫精灵App及其生态体系呈现用户最终定型的产品，平台提供上架管理，上架后的型号将在天猫精灵App-我家-添加设备列表中透出，并作为生态设备在阿里巴巴零售体系内给与运营支持

三、附录：开发、量产、上架必填/选填项列表