The developer documentation is currently available in Chinese only. English site
开发者

为 RtiTek 设备开发小程序

每种产品的控制界面是一个小程序。小程序通过 App 提供的接口连接设备、读取和下发设备状态、在页面之间导航,不直接接触蓝牙。

文档对应 App 0.6.8(2026-10-07)。接口处于 v1 草稿期,多数标注「会调整」。

小程序怎样调用设备

  • 小程序(Web App)是运行在 App 里 WebView 中的静态网页。App 向网页注入全局对象 window.rti,以及兼容层 window.ty。
  • 命令和事件走同一条 WebView postMessage 桥:命令是请求-响应(await rti.xxx()),事件由 App 推送(rti.onXxx(cb))。没有对外监听的 HTTP API。
  • 一个会话绑定唯一一台设备。小程序不能扫描、不能连别的设备,也不能直接访问 GATT。
  • 小程序只接触「连接」「DP(设备状态项)」这类业务概念,不接触 UUID、字节和 GATT。DP 按设备的已认证产品解释。

示例

await rti.connect();
const dps = await rti.getDeviceState();
await rti.publishDps({ brightness: 80 });

完整的消息格式、超时和写语义见 运行模型;全部接口见 接口清单。