外观
system.interconnect 补充 API
约 263 字小于 1 分钟
2026-07-15
官网公开了连接实例、状态、诊断、发送和四类事件，但未列出 JIDL 中保留的旧状态接口。
connect.getApkStatus()
无参数，同步返回手机端应用状态字符串：
| 返回值 | 含义 |
|---|---|
CONNECTED | 手机端应用已连接 |
DISCONNECTED | 通道存在但当前未连接 |
UNINSTALLED | 手机端应用未安装 |
import interconnect from '@system.interconnect'
const connect = interconnect.instance()
if (typeof connect.getApkStatus === 'function') {
console.log(connect.getApkStatus())
}该方法在 JIDL 中明确标记为废弃。新代码应使用 getReadyState() 和 diagnosis()，因为后者能区分连接超时、应用未安装和其他错误。
Promise 返回形式
同源 JIDL 把以下方法定义为 Promise：
const state = await connect.getReadyState()
const diagnosis = await connect.diagnosis({ timeout: 10000 })
await connect.send({ data: payload, timeout: 1000 })官网主要展示 callback 写法。不同框架版本可能同时支持两种风格，应以返回对象是否具有 .then 为准。
机型可用性
| Xiaomi Smart Band 10 Pro | Xiaomi Watch S4 41mm |
|---|---|
| △ | △ |