#常见问题

#App 常见问题

#页面报错小程序不存在

• 未匹配到符合的小程序，请检查传入的小程序 ID 是否正确。

#小程序尚未关联 App

• 原因：未查询到 App 和小程序的关联关系。
• 在开发者平台-投放管理 确认当前 App 是否在投放 App 列表内，不在列表则需勾选要投放的 App。

#小程序体验码无效

• 此错误一般出现于审核单异常/过期，重新提交审核即可。

#当前小程序不存在可用的版本

• 在开发者平台确认小程序是否存在线上版本。
• 如果没有线上版本小程序，则发布一个线上版本再尝试。

#当前小程序不存在可用的体验版本

• 没有找到符合的体验版小程序，请在开发者平台确认要打开的小程序是否存在体验版本。
• 需要将对应小程序要打开的版本设置为体验版再打开。

#小程序版本不存在

• 未找到指定版本的小程序，请在开发者平台中检查小程序是否存在此版本。

#无权限访问该版本

• 原因：未添加当前小程序白名单。
• 请在开发者平台-白名单中添加账号的白名单。
• 如果是 OEM App 账号提示用户不存在, 则需要添加用户标识, 用户标识的获取可通过长按小程序右上角之后弹出的基础信息弹窗中长按复制。

#无法打开小程序, 请稍后重试

• 网络原因，请检查网络并稍后重试。

#当前的 APP 版本无法支持小程序功能

• 原因：小程序所依赖的 Kit 版本和当前 App 所依赖的 Kit 版本不满足包含关系。
• 在开发者平台确认小程序依赖的基础库版本。长按右上角 x 号查看当前 App 的基础库版本。对比两者版本，App 基础库版本大于等于小程序基础库版本即满足下发逻辑。
• 在开发者平台确认小程序依赖的 Kit 版本。长按右上角 x 号查看当前 App 集成的 Kit 版本。对比二者版本，App 的每一个 Kit 版本都大于等于小程序的 Kit 版本。
• 更多匹配规则请查看。

#OemApp 如何升级？

• 如果您的 OemApp 版本不够，导致小程序无法加载， 请去涂鸦IoT平台升级 App 版本。 更新App版本

#其他无法解决的问题

• 请在涂鸦开发者论坛给我们留言。

#Ray 框架开发常见问题

#为什么在Ray框架引用部分三方库会导致报错？

原因：

• 版本兼容的原因:

  • 确保您引入的第三方库与 Ray 和其他相关库的版本兼容。不同的库版本之间可能存在不同的 API 或依赖关系，导致冲突。

• 运行环境的原因：

  • 小程序的运行环境有一些限制。某些浏览器 API 或全局对象在小程序中可能不可用，这可能会导致报错。比如直接在Ray框架中使用antd 或者echart等。
  • 对于不对浏览器对象进行操作的库 如Lodash，Redux等，是可以直接使用。

• 错误信息排查：

  • 查看报错信息的具体内容，可能会给您一些线索。报错信息通常会指明出错的文件、行数和错误类型。

• 社区支持：

  • 如果遇到问题，可以查看社区或第三方库的 GitHub 页面，看是否有其他用户遇到类似的问题，并查看是否有解决方案或更新。

#面板开发常见问题

#为什么虚拟设备调试功能点为空且项目工程里获取到的设备 schema 为空？

原因：

• 因为智能化方式为 生态设备接入 的产品的功能点获取方式与 产品开发 的产品不同，而当前虚拟设备插件及项目模板工程暂未开放支持这块功能，因此虚拟设备调试插件和项目模板工程里获取到的功能点都是空白的，这个功能我们正在规划中，敬请期待。

解决方案：

• 可基于我们当前提供的 基础物模型 API 能力 自行封装实现，其中：
  • 获取设备功能点可通过 getDeviceThingModelInfo 方法
  • 控制设备可通过 publishThingModelMessage 方法
  • 监听设备功能点可通过 onReceivedThingModelMessage

#如何判断当前设备是单个设备还是群组？

• 根据启动参数里是否包含 groupId 判断

#如何调试群组设备？

• 在开发者工具的编译参数的启动参数设置 groupId

#如何进行多设备控制？

在一个面板下控制多个设备，需要将需要额外控制的设备 id 存储在当前设备的属性里面。

• 1.首先，我们在当前面板可以调用 获取设备 id 列表 获取设备 id。
• 2.然后调用 批量获取设备信息 获取设备信息。
• 3.通过UI展现设备列表，或者其他方式确定需要额外控制的设备 id。
• 4.通过调用设置设备属性 存储设备 id。
• 5.后续就可以从 获取设备属性 获取设备 id，进行设备控制。

#如何获取设备ID (deviceId)?

• 进入 App 设备面板, 点击右上角进设备详情页，再点击设备信息, 进入设备信息页, 页面中显示的虚拟 ID 就是设备 ID, 也就是调试时需要传参数 deviceId。