起步应用与指南

React Native 接入

通过内测桥模块在 React Native 里复用 Embedded SDK 的设备能力:扫描、绑定、同步。

开发者平台处于内测阶段,接口契约以联调时提供的正式文档为准。账号由对接工程师开通,详见联系我们。

React Native 团队可以通过桥模块(内测)复用 Embedded 的 iOS 能力,而不必用原生写整套设备逻辑。桥模块底层仍是 iOS SDK,通过原生模块把方法与事件暴露到 JS 层。

安装

桥模块以内测形式随开通邮件发放,拷贝进你的项目 modules/ 目录即可被自动识别。

bash

# 桥模块地址随开通邮件发放
git clone https://<你的内测 Git 地址>/ikho-embedded-react-native.git

# 拷贝模块到你的 RN 工程
cp -R ikho-embedded-react-native/modules/ikho-embedded your-app/modules/ikho-embedded

原生模块链接

在 app.json 声明蓝牙与麦克风权限,然后执行 prebuild 让原生模块生效。

app.json

{
  "expo": {
    "ios": {
      "infoPlist": {
        "NSBluetoothAlwaysUsageDescription": "用于连接 iKho 录音卡并同步录音",
        "NSMicrophoneUsageDescription": "用于在应用内录制与试听音频",
        "UIBackgroundModes": ["bluetooth-central"]
      }
    }
  }
}

bash

npx expo prebuild -p ios
npx expo run:ios --device   # 需真机 iPhone

TS 侧 API 形态

import { IKhoEmbedded } from class="tk-str">'ikho-embedded';

await IKhoEmbedded.configure({ userToken });

const subs = [
  IKhoEmbedded.onScanResult(({ devices }) => { /* 展示设备 */ }),
  IKhoEmbedded.onProgress(({ recordingId, progress }) => { /* 同步进度 */ }),
];

await IKhoEmbedded.scanDevices();
await IKhoEmbedded.bindDevice({ serialNumber });
const { files } = await IKhoEmbedded.syncRecordings();

subs.forEach((s) => s.remove());

与纯原生的能力差异

桥模块覆盖最常用的设备能力;更进阶的用法(如 Wi-Fi 快传的完整控制)建议扩展桥模块或直接用原生 iOS SDK。

能力	纯原生 iOS SDK	React Native 桥(内测)
扫描与绑定	支持	支持
BLE 同步	支持	支持
设备状态与电量	支持	支持
Wi-Fi 快传	支持	需扩展桥方法
后台续传	支持	需额外配置

完整方法与回调以 iOS SDK 参考为准;桥模块只是它的 JS 封装。

这一页有帮助吗?