分类： 微信小程序开发

1. 产品介绍

微信小程序框架已适配手表穿戴类设备，可针对 RTOS（实时操作系统）等低功耗设备场景，实现最小可用的微信小程序运行。

2. 技术方案

由于市场主流穿戴设备的 CPU 性能和内存大小十分有限（整机内存小于 8M），我们针对性实现了最小可用的微信小程序框架，提供：

1. 熟悉的 WXML + WXSS + JS 的微信小程序开发体验
2. 最必要的微信小程序 wx 接口
3. 基本完整的微信小程序页面框架和组件系统
4. 基础的 WXSS 样式和内置组件支持
5. 微信小程序代码包编译器
6. 模拟调试环境

穿戴设备的硬件资源十分有限。为减小存储占用，该微信小程序框架只提供普通微信小程序的功能子集，请开发者严格按照本文档提供的特性列表实现微信小程序。由于接口能力的差异较大，一般需要开发者针对穿戴设备单独开发新的微信小程序。

2.1 UI能力

2.1.1 组件框架

可以使用微信小程序中 Page、Component能力。支持完整的 WXML、WXSS 语法。

2.1.1.1 支持的特性

可以在微信小程序中使用 App、getApp、Page、getCurrentPages、Component。支持 ES6 import / export 与 CommonJS require 两种 JS 模块加载机制。

2.1.1.2 使用差异

使用微信小程序组件框架时应注意下列差异：

• 组件的 styleIsolation 需在 JSON 中配置，不支持在组件 options 中指定
• 不再支持 addGlobalClass，请使用 styleIsolation 代替
• 当使用组件间通信与事件时，可以直接定义 export 属性，不需要声明 wx://component-export。

2.1.1.3 暂未支持的特性

以下能力暂未支持

• Chaining API

• behavior

• WXS

• 暂不支持自定义组件的下列方法：

  • createSelectorQuery
  • createIntersectionObserver
  • createMediaQueryObserver
  • getTabBar
  • animate
  • clearAnimation
  • applyAnimatedStyle
  • clearAnimatedStyle
  • setUpdatePerformanceListener

2.1.2 内置组件

目前仅支持下列内置组件

2.1.2.1 view

属性：无

2.1.2.2 image

属性：

说明：

• 不建议显示高清图片。部分穿戴设备的屏幕分辨率边长仅 200～300 像素，且内存有限，过大图片无法清晰渲染且可能导致内存溢出。
• 不建议使用图片组件显示微信小程序码、二维码、条形码等，建议使用 qrcode 组件。

2.1.2.3 text

属性：无

2.1.2.4 qrcode

穿戴设备微信小程序框架的专属组件，能够根据输入的文本生成并渲染二维码。

考虑到资源消耗，穿戴设备不建议使用图片展示二维码。
对于需要展示微信小程序码的情况，可以参考扫普通链接二维码打开微信小程序 。

2.1.2.5 scroll-view

2.1.2.6 swiper/swiper-item

swiper 支持属性：

2.1.3 WXSS样式

• display: block/flex（支持弹性盒子布局），不支持 inline/inline-block/inline-flex/grid
• position 绝对布局（top、right、bottom、left）
• width、height、margin、padding 等组件尺寸设置
• color 等文本属性
• border 相关属性：border-radius 不支持分别设置四角圆角大小，不支持百分比写法。
• background 相关属性: background-image, background-color
• font-size 等字体设置暂不支持

不支持子元素选择器、后代选择器、接续兄弟选择器、后续兄弟选择器，若有相关开发需求，请通过普通选择器实现。
注意：WXML支持内联样式，但不支持binding（不可以通过setData()修改WXML组件的style属性值）。

2.2 微信小程序配置

2.2.1 app.json

配置项：

window:

用于设置微信小程序的状态栏、导航条、标题、窗口背景色。穿戴设备微信小程序框架只支持设置窗口背景色。

networkTimeout

各类网络请求的超时时间，单位均为毫秒。穿戴设备微信小程序框架只支持设置request的超时时间。

2.2.2 component.json

配置项

styleIsolation

2.2.3 page.json

每一个微信小程序页面可以使用同名.json文件来对本页面的窗口表现进行配置，页面中配置项会覆盖 app.json 的 window 中相同的配置项。

配置项：

2.3 接口能力

• JSAPI 调用方式与完整版一致，支持回调和 Promise 两种调用形式，详情请参考相关文档。
• 本节仅说明和完整版的差异部分，完整的 API 接口说明请参考官网文档。为避免重复，本文省略参数中 success/fail/complete 回调函数的说明，如无特殊说明，均提供与完整版一致的 success/fail/complete 回调接口

2.3.1 微信生态能力

• wx.login：一致
• wx.checkSession: 一致
• wx.getAccountInfoSync：一致

2.3.2 系统信息

• wx.getWindowInfo：一致。额外增加返回值 screenShape。
• wx.getDeviceInfo: 仅支持返回 brand、model、system、platform、cpuType、memorySize。额外增加返回值 deviceType。

wx.getWindowInfo 新增返回值

wx.getDeviceInfo 新增返回值

注意：

本框架不提供wx.getSystemInfo系列接口，请使用getWindowInfo/getDeviceInfo代替。

2.3.3 网络请求

wx.request()

• 参数仅支持 url、data、header、timeout、method(仅支持GET, POST)、dataType、responseType、redirect。
• 返回的 RequestTask 仅支持 abort
• success 回调参数仅支持 data、statusCode、header
• fail 回调参数一致

注意

• 目前暂未提供文件系统支持，故暂未支持 wx.downloadFile/wx.uploadFile。
• 目前仅支持https，不支持TCP、UDP、WebSocket等其他类型的网络请求。

2.3.4 页面路由

• wx.navigateTo：参数仅支持 url
• wx.navigateBack：一致
• wx.redirectTo：一致
• wx.reLaunch：一致

注意：暂未提供tabBar

2.3.5 数据存储

• wx.getStorageInfo(sync)：一致
• wx.setStorage(Sync)：参数仅支持 key、data
• wx.getStorage(Sync)：参数仅支持 key
• wx.removeStorage(Sync)：一致
• wx.clearStorage(Sync)：一致

注意

1. 目前只提供KV存储，暂不提供文件存储。
2. 暂不支持加密存储

2.3.6 UI

• wx.showToast：一致
• wx.hideToast：参数不支持 noConflict，toast 和 loading 默认不可混用
• wx.showLoading：一致
• wx.hideLoading：参数不支持 noConflict，toast 和 loading 默认不可混用
• wx.showModal：参数不支持 editable 和 placeholderText
• wx.getMenuButtonBoundingClientRect：一致

注意：暂无 navigationBar、tabBar、homeButton

2.3.7 生命周期

• wx.getLaunchOptionsSync：参数仅支持 path、scene、query
• wx.getEnterOptionsSync：参数仅支持 path、scene、query
• wx.onUnhandledRejection：一致
• wx.onError：一致
• wx.onPageNotFound：一致
• wx.onAppShow：参数仅支持 path、scene、query
• wx.onAppHide：一致

2.3.8 事件

• bind:touchstart
• bind:touchend
• bind:tap
• bind:longpress

其中事件对象仅支持 type, target, currentTarget 字段，target/currentTarget 仅支持 dataset 字段。

2.3.9 其他

• console.log/info/error/warn/debug：输出会打印在模拟器的命令行窗口中，可以通过 console.log 调试微信小程序逻辑。
• setTimeout/clearTimeout
• setInterval/clearInterval

2.4 其他差异

• 暂不支持微信小程序插件
• 暂不支持微信小程序分包

3. 开发流程

3.1 注册穿戴设备微信小程序框架专属AppID

前置条件：名下需有普通微信小程序的AppID，并作为该微信小程序的管理员。
步骤：

1. 打开微信开发者平台
2. 扫码登录
3. 点击「前往控制台」

4. 选择「我的业务–微信小程序」

5. 页面右上角，切换到穿戴设备微信小程序要挂靠的普通微信小程序。
6. 切换到「硬件设置」
7. 点击「申请创建」

8. 创建成功，获得「穿戴端AppID」

3.2 安装开发者工具拓展

1. 打开「微信开发者工具」(需使用版本号 ≥ 2.01.2507252,建议下载最新 nightly 版开发者工具进行使用)
2. 在「工具栏」选择「设置–拓展设置」
3. 在弹出的页面中，左侧选择「模拟器插件」，右侧选择安装「低功耗硬件微信小程序模式」

3.3 启用低功耗微信小程序模式

装好插件后，将开发模式切换到「低功耗硬件微信小程序模式」

3.4 开发调试

点击「详情」，确保其中设置的AppID与微信开发者平台一致。

我们不建议开发者将JS代码编译为ES5。穿戴设备微信小程序框架支持ES2023，减少不必要的polyfill有助于显著节省最终微信小程序代码包体积，进而节省运行时内存占用。

3.5 体验与发布

完成开发后，可在「微信开发者工具」中点击「上传」。新上传的版本将覆盖旧的「开发版微信小程序」。
开发者可以前往微信开发者平台，管理微信小程序版本、提交审核、发布上线。

4. 联系我们

有合作意向的硬件厂商、微信小程序开发者，欢迎发送邮件联系我们：wx_iot@tencent.com。

在使用微信小程序提供的部分硬件能力时，需要提前将设备在微信进行注册，以便于微信验证设备的真实可信。

例如：微信小程序音视频通话（for 硬件）

1. 设备要求

微信需要硬件能力来对设备身份进行校验。设备厂商需要保证设备满足一定条件。

1.1 安卓设备

设备需要满足下列条件之一：

• 设备 EMMC/UFS 存储上的 RPMB(Replay Protected Memory Block) 分区未被使用；
• 设备支持 TEE，并能按照《设备认证 TEE 规范》开发 TA 并提交验收。

此外，设备厂商需要内置一个 RPMB 分区读写及通信的 RPMBD 服务（由微信提供，参考第 3 节），并保证服务能够开机正常启动。

1.2 Linux 设备

设备需要满足下列条件：

• 设备 EMMC/UFS 存储上的 RPMB(Replay Protected Memory Block) 分区未被使用；

2. 安全策略

对于同一个 modelId，每一台物理设备应分配唯一且不变的 SN。 如果检测到包括但不限于下列情况，可能会导致设备能力被封禁：

• 多台设备共用同一个 SN；
• 同一台设备交替使用多个不同的 SN；
• 使用虚假设备进行设备注册；
• 其他伪造或滥用设备的行为。

3. 设备认证（安卓）

3.1 部署 RPMBD 服务

设备认证需要使用 EMMC/UFS 存储上的 RPMB 分区来保证设备的身份，需要设备厂商内置一个 RPMB 分区读写及通信的服务，并保证服务能够开机正常启动。

3.1.1 下载服务

请在 此处 下载对应平台、版本的 rpmbd 二进制文件。

注意：ARM 64 位版本（TEE）需要设备商按照规范开发 TEE 对应的 TA 模块，详细规范与流程参考设备认证 TEE 规范。

3.1.2 运行服务

将下载的 rpmbd 二进制（以下假设文件名为 rpmbd，下载后可以重命名）集成至系统里并以服务的方式运行起来。

注意

• RPMBD 服务不仅用于注册设备过程，后续使用相关硬件能力时，都需要保证 RPMBD 服务一直运行。
• 每一颗 EMMC/UFS 存储芯片的 RPMB KEY 只能被写一次，不能修改。 如果被写入错误的值 (非注册时的 model_id 和 sn)，那么这颗芯片就无法继续使用。
• 高版本的 android 安全性较强，可能还需要配置 SELinux，且只支持在 system 分区启动。可参考 SELinux 参考配置

运行方式为：

rpmbd /dev/mmcblk1rpmb # /dev/mmcblk1rpmb 为rpmb分区路径, 开发者需要根据自己设备的情况具体填写（高通平台不需要指定）

参考如下 rc 的启动方式：

• /system/etc/init，放到 system 分区启动（建议）

  service rpmbd /system/bin/rpmbd /dev/mmcblk1rpmb
    class main
    user root
    group root system
  

• /vendor/etc/init，放到 vendor 分区启动（仅 Android < 8 支持）

  service rpmbd /vendor/bin/rpmbd
    class main
    user root
    group root system
  

3.2 注册设备

在完成 RPMBD 服务部署后，需要使用 WMPF 认证设备。

4. 设备认证（Linux）

• 使用「微信小程序音视频通话 SDK（直连 Linux 设备）」的设备，请使用wx_device_register注册设备。

5. 常见问题

(1) 注册设备报错 emmc write fail00

检查 rpmbd 服务启动参数里的 rpmb 分区路径是否正确。 若路径正确，确认此路径对应的 rpmb 分区在 Android OS 下能否被访问。

(2) 报错 cert fail

应用缓存被清理，或 Android 认为 APK 有变动导致 keystone 中数字证书失效导致。

需要清理 apk 数据缓存再使用相同的 appid、model_id、SN 调用 registerDevice/registerVoipDevice 刷新密钥。

(3) 接口报错 ticket 1 invalid rpmb_buffer

当前 rpmbd 与 SDK aar 的版本不兼容，应保持二者使用相同版本。例如：rpmbd 服务使用了 1.3 以下版本，而 SDK 使用了 1.3 或以上的版本。

(4) 注册设备返回 -7，或调用接口报错 failed to get native service 或其他获取 rpmbd 服务失败的错误

• 确认已部署 rpmbd 服务，且服务正常运行。（可以通过 ps 查看）
• Android >= 8 版本，请确认 rpmbd 是在 system 分区启动
• 如果启用了 SELinux，需确认 SELinux 的相关规则已正确配置

(5) 注册设备报错 register: null

高版本 android 不允许在主线程里进行网络请求，需要单独开线程里来调用 SDK 接口

(6) 使用物联网卡时，网络请求一直失败

物联网卡请使用 WMPF 注册设备，或设备认证 SDK >= 1.3.1 版本，并确保 servicewechat.com 域名能够正常访问。

(7) 注册设备报错 9800004，device xxx is not confirmed

绝大多数情况是因为注册设备时使用了 1.3 以下版本的 设备认证 SDK，且同时发起了多次 registerVoipDevice 请求，此时有概率设备端使用的密钥与后台不同步，导致设备再也无法成功注册，且该过程不可逆。

建议开发者使用 WMPF 注册设备，或升级到设备认证 SDK 1.3 及以上版本，使用低版本时请务必保证前一次 registerVoipDevice 返回前不要重复调用。

(8) 注册设备报错 9800004，device xxx not registered

绝大多数情况是当前设备之前使用不同的 modelId/sn 进行了注册。如使用 WMPF 注册设备，可以使用 getMiniProgramDeviceInfo 检查下当前设备内的 sn 和 modelId，和传入的是否一致。

(9) 获取票据 getCallerTicket/getDeviceToken 报错 9800004

一般是因为传入的 mode_id 与最初注册设备时不一致。

(10) 报错 ticket 0 digital-sig check fail

多数是因为当前设备已经在这台设备的另一个 App 中注册过，目前设备验证只能用于单个应用。需要再使用相同的 appid、model_id、SN 重新调用 registerDevice/registerVoipDevice 刷新密钥。

例如，同时混用「使用 WMPF 认证设备」和「设备认证 SDK」，可能会导致 WMPF 和 开发者应用互相抢占密钥，导致这个错误。

(11) 注册设备报错 40234 hmac check fail

可能有以下原因

• 设备已经使用其它的 model_id/sn 注册过，此次注册传入了不同的 model_id；
• 设备曾经注册过，且注册设备时使用了 1.3 以下版本的设备认证 SDK，且同时发起了多次 registerVoipDevice 请求，此时有概率设备端使用的密钥与后台不同步，导致设备再也无法成功注册，且该过程不可逆。

(12) 获取 deviceToken 时报错 register info invalid

当从「设备认证 SDK」切换到「使用 WMPF 认证设备」后，需要调用 WMPF registerMiniProgramDevice 重新进行设备注册，若未调用或调用未成功，则在需要获取 deviceToken 的场景会报这个错误。

能力介绍

「微信小程序设备消息」是一种长期订阅类型的「微信小程序订阅消息」，且需要完成「设备接入」才能够使用。

用户在使用设备过程中，需要关注某些由设备触发且需要人工介入的事件。例如安防摄像头检测到异常，设备耗材不足，设备发生故障等等。

「微信小程序设备消息」能力指的是，只要用户在微信小程序内订阅通知，开发者就可以将这些事件以订阅消息的形式发送给用户。消息在微信内的产品形态，目前以「服务通知」形式呈现。

开发流程

1. 设备接入

微信小程序想要使用设备消息能力，首先需要接入设备，详见「设备接入」文档。

完成接入后，开发者可获得由平台分配的 model_id 。model_id 对应一种设备类型，也是调用微信小程序设备能力相关接口的重要凭证。

2. 获取模版 ID

登录「微信小程序管理后台」——「功能」——「订阅消息」——「公共模板库」——「长期订阅」，查看可选用的设备消息模板。

选择设备消息模板中需要的关键词，并提交。

注意：设备消息模版的关键词内容由平台生成，为枚举值，开发者不能够自定义内容。

提交后，可在「我的模板」中找到对应模板的模板 ID ，每个模板以 template_id 标记。

3. 获取设备票据

获取 snTicket 用于「发起订阅」步骤。

详见服务端设备票据接口 hardwareDevice.getSnTicket 。

4. 发起订阅

调用 wx.requestSubscribeDeviceMessage 接口会有以下授权弹窗出现，用户同意订阅消息后，才会有设备消息发送至用户的微信会话。

微信小程序内完成设备消息订阅

用户订阅设备消息时，需要手动点击“添加提醒”，设备触发消息后才会出现“响铃+振动”的强提醒状态，开发者可以在前端界面进行引导。

示例代码

wx.requestSubscribeDeviceMessage({
    sn: 'xxxx',
    snTicket: 'xxxxx',
    modelId: 'xxxxx',
    tmplIds: ['xxxxx'],
    success(res) {
        console.log('[wx.requestSubscribeDeviceMessage success]: ', res)
        // { 'QCpBsp1TGJ1ML-UIwAIMkdXpPGzxSfwJqsKsvMVs3io': 'accept' }
    },
    fail(res) {
        console.log('[wx.requestSubscribeDeviceMessage fail]: ', res)
    }
})

5. 发送设备消息

开发者通过微信服务端接口向用户推送设备消息。

详见服务端设备消息发送接口 hardwareDevice.send 。

服务通知 – 设备消息

设备消息具体形式

提供硬件设备联网、控制、通讯等能力的微信小程序，在完成设备接入后，才可以使用微信小程序提供的硬件能力（例如「设备消息」、「音视频通话」）等。

接入条件

经过微信认证的非个人主体微信小程序。

面向智能硬件生产企业或开发者。

接入步骤

1. 申请设备类目

登录「微信小程序管理后台」——「设置」——「基本设置/服务类目」，点击「申请更多类目」（一个微信小程序最多可申请5个服务类目）。

添加「工具——设备管理」为微信小程序类目。

2. 开通硬件设备能力

登录「微信小程序管理后台」——「功能」——「硬件设备」，阅读设备使用条件和接入流程等，点击「开通」。

管理员扫码确认后开通成功，进入设备管理页面。

3. 添加设备类型

点击添加设备，按照每个字段对应的说明填写信息，如实填写设备相关信息，否则会导致审核不通过。

每次可注册一种设备类型，例如“空调—空调1号”和“空调—空调2号”需要分别进行注册。

注意：

• 选择设备类型时，请认真判断注册的设备类型是否已经是已有的设备类型，比如“洗拖一体机”属于“生活电器——扫地机器人”，请不要重复添加平台设备库中已有的设备品类。如果是设备库中缺失的设备类型，可以选择“其他”。

4. 获取设备 model_id

设备注册成功后，可以获得平台分配的 model_id，model_id 是调用微信小程序设备能力相关接口的重要凭证。获取 model_id 后，微信小程序可以按照相关文档指引调用「设备消息」等硬件能力。