- 场景描述:在体验设备联动示例时,参考“温度过高时自动关闭设备”文档,发现虽然涵盖了创建产品、注册设备、设置规则、验证操作的基本流程,但缺少整体流程图、部分关键操作截图、JSON/Topic 验证示例,以及对参数字段的详细说明。功能建议:1. 添加端到端流程图,清晰描绘从物模型定义到结果验证的交互路径。 2. 增加可选的设备联动场景示例,例如湿度报警或气体浓度告警,提高迁移温度。 3. 在验证环节补充 Topic 路径与 JSON 数据格式示例,便于用户准确上报并验证。用户体验建议:1. 在“添加条件”和“配置动作”等关键步骤区域增加界面截图,提高视觉定位效率。 2. 对“重复抑制”、“数据时效”等配置项加入注释或推荐值说明,降低误操作风险。 3. 验证操作补充上报示例结构,并明确使用模拟器或虚拟设备的流程细节。产品一致性 / 缺陷问题:- 明确示例功能是否受版本或区域限制(如基础版/标准版/企业版)。 - 确认文档按钮名称、描述与控制台 UI 一致性,如“创建规则”等,用词应与 UI 同步。 - 如 `Profile_tempSensor.zip` 链接失效,建议提供备用下载路径或控制台模板入口。 场景描述:在体验设备联动示例时,参考“温度过高时自动关闭设备”文档,发现虽然涵盖了创建产品、注册设备、设置规则、验证操作的基本流程,但缺少整体流程图、部分关键操作截图、JSON/Topic 验证示例,以及对参数字段的详细说明。功能建议:1. 添加端到端流程图,清晰描绘从物模型定义到结果验证的交互路径。 2. 增加可选的设备联动场景示例,例如湿度报警或气体浓度告警,提高迁移温度。 3. 在验证环节补充 Topic 路径与 JSON 数据格式示例,便于用户准确上报并验证。用户体验建议:1. 在“添加条件”和“配置动作”等关键步骤区域增加界面截图,提高视觉定位效率。 2. 对“重复抑制”、“数据时效”等配置项加入注释或推荐值说明,降低误操作风险。 3. 验证操作补充上报示例结构,并明确使用模拟器或虚拟设备的流程细节。产品一致性 / 缺陷问题:- 明确示例功能是否受版本或区域限制(如基础版/标准版/企业版)。 - 确认文档按钮名称、描述与控制台 UI 一致性,如“创建规则”等,用词应与 UI 同步。 - 如 `Profile_tempSensor.zip` 链接失效,建议提供备用下载路径或控制台模板入口。
- 场景描述:在体验“任务三:数据转发”功能时,查阅“转发方式概述”文档,发现虽然列举了多种协议方式,但缺少选型对比、性能规格、示例格式等实用信息,也缺少流程图与目录导航指引,影响用户理解与配置效率。功能建议:1. 补充不同协议在场景应用(高吞吐、低时延、轻量通信等)中的优劣对比; 2. 提供 JSON 推送示例结构(字段、层次说明),便于快速集成; 3. 补充 AMQP 和 MQTT 的性能规格(如最大吞吐、并发连接数量等)。用户体验建议:1. 增加目录索引或锚点导航,提高长文档的访问便捷性; 2. 插入转发流程图或图标说明(如订阅→推送流程),提升理解效率; 3. 在 HTTP/HTTPS 部分补充安全建议,如 TLS 证书校验、URL 安全校验策略等。产品缺陷 / 一致性问题:- 明确列出不同区域或平台版本是否全部支持所有协议方式,避免用户因功能限制而迷惑; - 补充控制台与 API 配置方式的差异说明(权限要求、响应时效、配置一致性),帮助开发者选择合适流程。 场景描述:在体验“任务三:数据转发”功能时,查阅“转发方式概述”文档,发现虽然列举了多种协议方式,但缺少选型对比、性能规格、示例格式等实用信息,也缺少流程图与目录导航指引,影响用户理解与配置效率。功能建议:1. 补充不同协议在场景应用(高吞吐、低时延、轻量通信等)中的优劣对比; 2. 提供 JSON 推送示例结构(字段、层次说明),便于快速集成; 3. 补充 AMQP 和 MQTT 的性能规格(如最大吞吐、并发连接数量等)。用户体验建议:1. 增加目录索引或锚点导航,提高长文档的访问便捷性; 2. 插入转发流程图或图标说明(如订阅→推送流程),提升理解效率; 3. 在 HTTP/HTTPS 部分补充安全建议,如 TLS 证书校验、URL 安全校验策略等。产品缺陷 / 一致性问题:- 明确列出不同区域或平台版本是否全部支持所有协议方式,避免用户因功能限制而迷惑; - 补充控制台与 API 配置方式的差异说明(权限要求、响应时效、配置一致性),帮助开发者选择合适流程。
- 场景描述:在体验“任务二:设备管理”时,查阅“管理设备”文档,发现其缺少关键操作界面截图、权限说明与状态判断辅助(特别是 NB-IoT 与 MQTT 状态区别),影响用户的学习效率与操作准确性。功能建议:1. 补充关键操作演练示例,如“冻结→解冻→调试→群组操作”的完整流程图或短视频演示。 2. 添加典型使用场景建议,例如设备频繁异常上线时推荐排查顺序或操作流程。用户体验建议:1. 增加批量删除操作模板、失败反馈界面、调试流程等截图,增强视觉操作指引。 2. 优化状态说明,将设备类型状态阈值差异使用图表或颜色标识呈现,帮助快速比对判断。 3. 对删除操作的风险提示,建议使用红色高亮或警示图标,提高可视化提醒。产品缺陷 / 一致性问题:- 明确哪些操作(如删除、冻结、调试)可能需要额外权限或特定版本支持,帮助用户判断入口找不到的原因。 - 补充“调试设备”功能支持范围说明(哪些设备类型支持详情调试),提升期望管理准确性。 - 建议与控制台 UI 保持同步更新,如字段名称、按钮文案修改应及时调整文档。 场景描述:在体验“任务二:设备管理”时,查阅“管理设备”文档,发现其缺少关键操作界面截图、权限说明与状态判断辅助(特别是 NB-IoT 与 MQTT 状态区别),影响用户的学习效率与操作准确性。功能建议:1. 补充关键操作演练示例,如“冻结→解冻→调试→群组操作”的完整流程图或短视频演示。 2. 添加典型使用场景建议,例如设备频繁异常上线时推荐排查顺序或操作流程。用户体验建议:1. 增加批量删除操作模板、失败反馈界面、调试流程等截图,增强视觉操作指引。 2. 优化状态说明,将设备类型状态阈值差异使用图表或颜色标识呈现,帮助快速比对判断。 3. 对删除操作的风险提示,建议使用红色高亮或警示图标,提高可视化提醒。产品缺陷 / 一致性问题:- 明确哪些操作(如删除、冻结、调试)可能需要额外权限或特定版本支持,帮助用户判断入口找不到的原因。 - 补充“调试设备”功能支持范围说明(哪些设备类型支持详情调试),提升期望管理准确性。 - 建议与控制台 UI 保持同步更新,如字段名称、按钮文案修改应及时调整文档。
- 场景描述:在体验“任务一:创建产品”时,参考“创建产品”文档,发现文档操作指引过于简略,缺少截图、真实配置示例、风险提示样式及一致性的 UI 命名说明,降低用户上手效率。功能建议:1. 补充“创建产品”页面及关键配置项的控制台截图,帮助用户快速定位操作入口。 2. 在协议类型/数据格式等选项中增加推荐值组合示例(如“MQTT + JSON + UTF-8”等常见配置)。用户体验建议:1. 将文档内容拆分为“前提条件”“操作步骤”“配置说明”“后续操作”模块,提升阅读体验。 2. 使用表格或粗体形式展示“产品名称”字符规则;对“删除产品清空资源”的描述使用红色或图标强调风险。产品缺陷 / 一致性问题:- 核对并同步“更多-删除”描述与控制台实际按钮名称,防止误导。 - 针对特定协议类型、ProductID 命名规则与 API 接口的一致性添加说明;兼顾区域和版本差异,说明可用限制。 场景描述:在体验“任务一:创建产品”时,参考“创建产品”文档,发现文档操作指引过于简略,缺少截图、真实配置示例、风险提示样式及一致性的 UI 命名说明,降低用户上手效率。功能建议:1. 补充“创建产品”页面及关键配置项的控制台截图,帮助用户快速定位操作入口。 2. 在协议类型/数据格式等选项中增加推荐值组合示例(如“MQTT + JSON + UTF-8”等常见配置)。用户体验建议:1. 将文档内容拆分为“前提条件”“操作步骤”“配置说明”“后续操作”模块,提升阅读体验。 2. 使用表格或粗体形式展示“产品名称”字符规则;对“删除产品清空资源”的描述使用红色或图标强调风险。产品缺陷 / 一致性问题:- 核对并同步“更多-删除”描述与控制台实际按钮名称,防止误导。 - 针对特定协议类型、ProductID 命名规则与 API 接口的一致性添加说明;兼顾区域和版本差异,说明可用限制。
- 场景描述:在体验“任务九:应用 SDK 接入”时,参考“应用侧 Java SDK 使用指南”文档,发现其只提供 Java 示例,安全提示不够突出,且缺少错误处理建议,影响易用性与安全性。功能建议:1. 添加其他语言(如 Python、Go、C#)的 SDK 简单接入示例,拓宽文档适用开发者范围。 2. 增加端到端流程图,涵盖“应用创建→认证→查询设备”等关键步骤,让用户更直观理解整体流程。用户体验建议:1. 对 AK/SK 安全存储的提示设置为“安全警示”样式(如加粗、标红),提醒开发者不要将密钥硬编码。 2. 建议文档明确推荐一个稳定 SDK 版本(如 3.0.60),并说明选择版本的依据。 3. 插入控制台抓图,说明如何查找 REGION_ID 和 ENDPOINT 的具体位置,提升实践操作效率。产品缺陷 / 一致性问题:- 补充 SDK 与 IoTDA 平台不同版本之间的兼容性说明,降低因版本不匹配导致错误调用的风险。 - 针对示例中可能抛出的异常类型(如 ConnectionException 等),提供建议的重试或日志记录策略,便于开发者故障快速定位。 场景描述:在体验“任务九:应用 SDK 接入”时,参考“应用侧 Java SDK 使用指南”文档,发现其只提供 Java 示例,安全提示不够突出,且缺少错误处理建议,影响易用性与安全性。功能建议:1. 添加其他语言(如 Python、Go、C#)的 SDK 简单接入示例,拓宽文档适用开发者范围。 2. 增加端到端流程图,涵盖“应用创建→认证→查询设备”等关键步骤,让用户更直观理解整体流程。用户体验建议:1. 对 AK/SK 安全存储的提示设置为“安全警示”样式(如加粗、标红),提醒开发者不要将密钥硬编码。 2. 建议文档明确推荐一个稳定 SDK 版本(如 3.0.60),并说明选择版本的依据。 3. 插入控制台抓图,说明如何查找 REGION_ID 和 ENDPOINT 的具体位置,提升实践操作效率。产品缺陷 / 一致性问题:- 补充 SDK 与 IoTDA 平台不同版本之间的兼容性说明,降低因版本不匹配导致错误调用的风险。 - 针对示例中可能抛出的异常类型(如 ConnectionException 等),提供建议的重试或日志记录策略,便于开发者故障快速定位。
- 场景描述:在查阅“API 概览”页面时,尽管接口罗列齐全,但缺少关键的使用示例、响应说明、权限控制和页面导航,导致查找和使用成本较高。功能建议:1. 为关键接口添加请求/响应示例片段,尤其是“创建设备”“下发设备消息”等常用场景。 2. 说明 API 的版本及兼容性(如新增或弃用提示)。用户体验建议:1. 增加页面章节目录或左侧目录导航,支持快速跳转与折叠查看。 2. 可视化突出常用接口或初学者推荐入口,便于快速定位。产品缺陷 / 一致性问题:- 文档未明确标注调用接口所需权限和配额限制,如调用频率或每日限额。 - 缺少常见错误码及返回格式说明,建议补充常见异常举例与处理建议。 场景描述:在查阅“API 概览”页面时,尽管接口罗列齐全,但缺少关键的使用示例、响应说明、权限控制和页面导航,导致查找和使用成本较高。功能建议:1. 为关键接口添加请求/响应示例片段,尤其是“创建设备”“下发设备消息”等常用场景。 2. 说明 API 的版本及兼容性(如新增或弃用提示)。用户体验建议:1. 增加页面章节目录或左侧目录导航,支持快速跳转与折叠查看。 2. 可视化突出常用接口或初学者推荐入口,便于快速定位。产品缺陷 / 一致性问题:- 文档未明确标注调用接口所需权限和配额限制,如调用频率或每日限额。 - 缺少常见错误码及返回格式说明,建议补充常见异常举例与处理建议。
- 场景描述:在体验“任务七:设备监控”时,查看“设备消息跟踪”文档,但发现文档主要说明功能用途与设备支持类型(NB-IoT / MQTT),缺少实际操作指引、界面截图、权限说明,也未提供常见问题处理建议。功能建议:1. 增加详细操作步骤:如何进入消息跟踪入口、如何选择设备、如何查看结果等。 2. 添加失败或超限场景的示例说明,例如“超过 10 台设备无法继续跟踪时系统提示内容”。 3. 补充典型使用场景说明,如“如何通过追踪辅助排查命令下发失败”。用户体验建议:1. 插入控制台操作流程截图(菜单路径、按钮样式、追踪界面等),提升视觉引导。 2. 说明 NB-IoT 与 MQTT 设备在追踪表现或数据可视化方面的差异,帮助用户选择合适方式。产品缺陷 / 一致性问题:- 说明该功能在不同版本(基础版/标准版/企业版)是否可用,以及是否需要特定 IAM 权限或角色授权。 - 如有地域差异或上线延迟,应提示“以控制台实际显示为准”。 场景描述:在体验“任务七:设备监控”时,查看“设备消息跟踪”文档,但发现文档主要说明功能用途与设备支持类型(NB-IoT / MQTT),缺少实际操作指引、界面截图、权限说明,也未提供常见问题处理建议。功能建议:1. 增加详细操作步骤:如何进入消息跟踪入口、如何选择设备、如何查看结果等。 2. 添加失败或超限场景的示例说明,例如“超过 10 台设备无法继续跟踪时系统提示内容”。 3. 补充典型使用场景说明,如“如何通过追踪辅助排查命令下发失败”。用户体验建议:1. 插入控制台操作流程截图(菜单路径、按钮样式、追踪界面等),提升视觉引导。 2. 说明 NB-IoT 与 MQTT 设备在追踪表现或数据可视化方面的差异,帮助用户选择合适方式。产品缺陷 / 一致性问题:- 说明该功能在不同版本(基础版/标准版/企业版)是否可用,以及是否需要特定 IAM 权限或角色授权。 - 如有地域差异或上线延迟,应提示“以控制台实际显示为准”。
- 场景描述:在体验“任务六:规则引擎”功能时,参考“规则引擎介绍”文档,发现文档虽介绍功能分类和授权机制,但缺少具体业务场景示例、详细配置说明和 IAM 授权界面截图,不便于用户实际操作理解。功能建议:1. 添加典型业务场景示例,比如“温控联动”“异常数据通知”以便用户快速理解场景配置。 2. 补充设备条件判断表达式与动作配置界面的参数说明,提升实用性。用户体验建议:1. 优化文档结构:增加章节划分(如“功能概述”“规则类型”“授权流程”“示例配置”),增强可读性。 2. 插入授权流程中 IAM 控制台截图,明确“iotda_admin_trust”委托创建和授权位置。产品缺陷 / 一致性问题:- 文档未说明区域或版本差异对规则引擎功能支持的影响,建议明确支持范围。 - 建议补充规则数量或并发配额说明,帮助用户评估可控性与稳定性。 场景描述:在体验“任务六:规则引擎”功能时,参考“规则引擎介绍”文档,发现文档虽介绍功能分类和授权机制,但缺少具体业务场景示例、详细配置说明和 IAM 授权界面截图,不便于用户实际操作理解。功能建议:1. 添加典型业务场景示例,比如“温控联动”“异常数据通知”以便用户快速理解场景配置。 2. 补充设备条件判断表达式与动作配置界面的参数说明,提升实用性。用户体验建议:1. 优化文档结构:增加章节划分(如“功能概述”“规则类型”“授权流程”“示例配置”),增强可读性。 2. 插入授权流程中 IAM 控制台截图,明确“iotda_admin_trust”委托创建和授权位置。产品缺陷 / 一致性问题:- 文档未说明区域或版本差异对规则引擎功能支持的影响,建议明确支持范围。 - 建议补充规则数量或并发配额说明,帮助用户评估可控性与稳定性。
-
【功能建议】页面缺少交互引导截图 未采纳文中提及 IAM 创建委托 iotda_admin_trust,并与其他云服务连接(DIS、OBS、Kafka、SMN 等),却没有配图展示操作入口或授权流程。建议补充 IAM 控制台截图和授权按钮位置示意。规则引擎介绍_规则引擎_用户指南_设备接入 IoTDA-华为云 文中提及 IAM 创建委托 iotda_admin_trust,并与其他云服务连接(DIS、OBS、Kafka、SMN 等),却没有配图展示操作入口或授权流程。建议补充 IAM 控制台截图和授权按钮位置示意。规则引擎介绍_规则引擎_用户指南_设备接入 IoTDA-华为云
-
【功能建议】文档结构过于简略 未采纳信息集中在第一段,缺少分节标题划分流程模块,例如「什么是规则引擎」「两种规则类型」「授权配置流程」「使用场景示例」。建议优化文档结构,使阅读更层次化、更易导航。规则引擎介绍_规则引擎_用户指南_设备接入 IoTDA-华为云 信息集中在第一段,缺少分节标题划分流程模块,例如「什么是规则引擎」「两种规则类型」「授权配置流程」「使用场景示例」。建议优化文档结构,使阅读更层次化、更易导航。规则引擎介绍_规则引擎_用户指南_设备接入 IoTDA-华为云
-
【功能建议】缺失条件表达式与动作配置说明 预审不通过文中没有展示如何编写判断条件(如温度 > 30°C)或设置动作(通知/下发命令)时的界面字段说明或参数范围。建议添加配置截图和常见表达式示例,帮助用户快速上手。 文中没有展示如何编写判断条件(如温度 > 30°C)或设置动作(通知/下发命令)时的界面字段说明或参数范围。建议添加配置截图和常见表达式示例,帮助用户快速上手。
-
【功能建议】缺少典型使用场景示例 预审不通过文档目前只是概述规则引擎功能(设备联动 vs 数据转发),但未结合具体业务场景展开说明。建议补充示例,如“温湿度超过阈值自动开风扇”或“光照不足时启动摄像头告警”,提高文档的实用性与情境代入感。 文档目前只是概述规则引擎功能(设备联动 vs 数据转发),但未结合具体业务场景展开说明。建议补充示例,如“温湿度超过阈值自动开风扇”或“光照不足时启动摄像头告警”,提高文档的实用性与情境代入感。
- 场景描述:在“设备集成设备端 SDK 接入”文档中,体验 Java SDK 部分顺畅,但缺失其他语言示例、整体流程图及异常排查建议,可能导致开发者理解成本提升或接入失败时无排错思路。功能建议:1. 补充 Python、Go、C# 等语言的接入示例代码片段。 2. 增加端到端流程图(从项目新建→设备激活→上报→命令下发→运行结果),可采用图表或短视频形式。用户体验建议:1. 在“前提条件”部分补充 IntelliJ、Maven 与 CA 证书获取的官方链接。 2. 对示例中关键参数(如连接地址、deviceId、deviceSecret)增加说明,特别是如何获取和安全存储。产品缺陷 / 一致性问题:- 示例中使用的 SDK 版本(1.2.1)未提示与最新版本的兼容性,建议增加版本说明与更新维护提醒。 - 对 `device.init()` 初始化失败缺少排查建议,建议附加失败反馈处理模版(如打印日志、加入重试机制)。 场景描述:在“设备集成设备端 SDK 接入”文档中,体验 Java SDK 部分顺畅,但缺失其他语言示例、整体流程图及异常排查建议,可能导致开发者理解成本提升或接入失败时无排错思路。功能建议:1. 补充 Python、Go、C# 等语言的接入示例代码片段。 2. 增加端到端流程图(从项目新建→设备激活→上报→命令下发→运行结果),可采用图表或短视频形式。用户体验建议:1. 在“前提条件”部分补充 IntelliJ、Maven 与 CA 证书获取的官方链接。 2. 对示例中关键参数(如连接地址、deviceId、deviceSecret)增加说明,特别是如何获取和安全存储。产品缺陷 / 一致性问题:- 示例中使用的 SDK 版本(1.2.1)未提示与最新版本的兼容性,建议增加版本说明与更新维护提醒。 - 对 `device.init()` 初始化失败缺少排查建议,建议附加失败反馈处理模版(如打印日志、加入重试机制)。
-
【用户体验】异常处理和失败排查缺失 预审不通过文档中代码示例写道 device.init() != 0 时直接返回,但未提示开发者如何捕获、输出日志或查阅常见失败原因。建议加入失败排查方向或异常处理代码模板,提升容错体验。 文档中代码示例写道 device.init() != 0 时直接返回,但未提示开发者如何捕获、输出日志或查阅常见失败原因。建议加入失败排查方向或异常处理代码模板,提升容错体验。
-
【用户体验】版本号说明不明确 已实现示例依赖的 Java SDK 版本为 1.2.1,但没有提醒读者如果后端 SDK 有更新,是否需同步替换或兼容性保证。建议标注“基于 SDK v1.2.1”并提醒及时关注 SDK 更新。设备集成设备端SDK接入_设备侧接入开发_开发指南_设备接入 IoTDA-华为云 示例依赖的 Java SDK 版本为 1.2.1,但没有提醒读者如果后端 SDK 有更新,是否需同步替换或兼容性保证。建议标注“基于 SDK v1.2.1”并提醒及时关注 SDK 更新。设备集成设备端SDK接入_设备侧接入开发_开发指南_设备接入 IoTDA-华为云
上滑加载中
推荐直播
-
HDC深度解读系列 - Serverless与MCP融合创新,构建AI应用全新智能中枢2025/08/20 周三 16:30-18:00
张昆鹏 HCDG北京核心组代表
HDC2025期间,华为云展示了Serverless与MCP融合创新的解决方案,本期访谈直播,由华为云开发者专家(HCDE)兼华为云开发者社区组织HCDG北京核心组代表张鹏先生主持,华为云PaaS服务产品部 Serverless总监Ewen为大家深度解读华为云Serverless与MCP如何融合构建AI应用全新智能中枢
回顾中 -
关于RISC-V生态发展的思考2025/09/02 周二 17:00-18:00
中国科学院计算技术研究所副所长包云岗教授
中科院包云岗老师将在本次直播中,探讨处理器生态的关键要素及其联系,分享过去几年推动RISC-V生态建设实践过程中的经验与教训。
回顾中 -
一键搞定华为云万级资源,3步轻松管理企业成本2025/09/09 周二 15:00-16:00
阿言 华为云交易产品经理
本直播重点介绍如何一键续费万级资源,3步轻松管理成本,帮助提升日常管理效率!
回顾中
热门标签