更新记录

1.0.2（2026-08-06）

1

1.0.1（2026-08-06）

1

1.0.0（2026-08-06）

• 初次版本，内部测试使用

平台兼容性

uni-app(3.8.1)

uni-app x(3.8.1)

kongbai-aizoring

AIZORING 智能戒指 SDK 的 uni-app 插件，支持 Android/iOS 双平台。

特性

• 统一的跨平台 API，一套代码适配 Android 和 iOS
• 原生数据自动转换为 JSON 格式
• 支持 116 个设备控制命令
• 完整的事件监听机制
• TypeScript 类型支持

导出 API

• initialize(options)
• requestPermissions(options?)
• startScan(options?) / stopScan()
• connect(options) / disconnect() / unbind()
• isConnected()
• getSupportedCommands()
• execute(options)
• onEvent(listener) / offEvent()
• destroy()

快速开始

1. 初始化 SDK

import { initialize, onEvent } from '@/uni_modules/kongbai-aizoring'

initialize({
  appName: 'AIZORING Demo',
  appId: '__UNI__90B411F',
  appVersion: '1.0.0',
  region: 1,
  debug: true,
  success: (res) => console.log('初始化成功', res),
  fail: (err) => console.error('初始化失败', err)
})

2. 监听设备事件

onEvent((event) => {
  console.log(event.type, event.data)
  // connection: 连接状态变化
  // scan: 扫描到设备
  // power: 电量变化
  // transparent: 透传数据
})

3. 扫描并连接设备

import { startScan, connect } from '@/uni_modules/kongbai-aizoring'

startScan({
  success: () => console.log('开始扫描')
})

// 监听 scan 事件获取设备列表
// 找到目标设备后连接
connect({
  deviceId: 'xx:xx:xx:xx:xx:xx',
  success: () => console.log('连接成功'),
  fail: (err) => console.error('连接失败', err)
})

4. 执行设备命令

import { execute } from '@/uni_modules/kongbai-aizoring'

// 获取健康数据
execute({
  command: 'health.fetch',
  params: { timestamp: Date.now() },
  success: (res) => console.log('健康数据', res),
  fail: (err) => console.error('获取失败', err)
})

// 开始心率测量
execute({
  command: 'measure.start',
  params: { type: 1 },
  success: (res) => console.log('测量开始', res)
})

命令列表

插件支持 116 个设备控制命令，完整列表请查看：API-MAPPING-COMPLETE.md

平台差异

• 双端支持：54 个命令
• Android 独有：42 个命令
• iOS 独有：20 个命令

文档中 ❌ SDK不支持 表示该平台官方 SDK 未提供此功能。

运行要求

• Android minSdkVersion 为 23，需真机授予蓝牙、位置、健康等权限。
• iOS 最低版本为 13.0；厂商 Framework 仅提供 iPhoneOS arm64，不支持模拟器，必须使用真机运行。
• ECG、血糖、情绪、录音和 OTA 受设备型号、固件、厂商授权及服务端配置影响。
• 设备命令应串行调用，不要并发发送多个蓝牙请求。
• iOS requestPermissions 返回当前 CoreBluetooth 权限和电源状态；系统权限弹窗由首次扫描触发。