iOS SDK

import IKhoEmbedded

// 应用启动时调用一次(如 AppDelegate / App.init)
IKhoEmbedded.configure(userToken: "USER_ACCESS_TOKEN")

IKhoEmbedded.setUserToken("NEW_USER_ACCESS_TOKEN")

<key>NSBluetoothAlwaysUsageDescription</key>
<string>用于连接 iKho 录音卡并同步设备上的录音</string>

<key>NSMicrophoneUsageDescription</key>
<string>用于在应用内录制与试听音频</string>

<!-- 后台保持蓝牙连接,支持后台同步 -->
<key>UIBackgroundModes</key>
<array>
  <string>bluetooth-central</string>
</array>

import IKhoEmbedded

final class DeviceCoordinator: IKhoDeviceDelegate {
    private var lastSerial: String?

    func start() {
        IKhoDeviceManager.shared.delegate = self
        IKhoDeviceManager.shared.scanDevices()
    }

    // 扫描到设备时回调(可能多次触发)
    func deviceScanResult(_ devices: [IKhoDevice]) {
        guard let target = devices.first(where: { $0.serialNumber == lastSerial })
                ?? devices.first else { return }
        IKhoDeviceManager.shared.stopScan()
        IKhoDeviceManager.shared.bind(device: target)
    }

    // 绑定结果
    func deviceBindChanged(_ result: IKhoBindResult) {
        if result.bound { print("已绑定 \(result.serialNumber)") }
    }
}

func deviceStateChanged(_ state: IKhoDeviceState) {
    print("电量 \(state.batteryLevel)% · 充电中 \(state.isCharging)")
    print("剩余存储 \(state.freeStorage) / \(state.totalStorage) 字节")
}

// 主动刷新一次设备状态
IKhoDeviceManager.shared.refreshDeviceState()

// 读取设备上的录音列表(默认 BLE 通道)
IKhoDeviceManager.shared.fetchRecordings()

func recordingListUpdated(_ recordings: [IKhoRecording]) {
    for r in recordings {
        print("\(r.id) · \(r.durationSeconds)s · \(r.sizeBytes) bytes")
    }
}

// 把某条录音同步到手机
IKhoDeviceManager.shared.exportAudio(recordingId: recording.id, format: .m4a)

func exportProgress(recordingId: String, progress: Int) { /* 0–100 */ }
func exportCompleted(recordingId: String, outputPath: String) { /* 文件已就绪 */ }
func exportFailed(recordingId: String, error: IKhoError) { /* 处理错误 */ }

// 开启 Wi-Fi 快传(设备会开启热点,SDK 自动接入)
IKhoDeviceManager.shared.setWiFiTransfer(enabled: true)

// 通道就绪后再发起同步
func wifiTransferReady() {
    IKhoDeviceManager.shared.exportAudio(recordingId: recording.id, format: .m4a)
}

// 单条导出,指定格式(mp3 / m4a / wav)
IKhoDeviceManager.shared.exportAudio(recordingId: id, format: .mp3)

// 批量导出多条录音
IKhoDeviceManager.shared.exportAudioBatch(recordingIds: selectedIds, format: .wav)

func exportBatchProgress(completed: Int, total: Int) {
    print("已完成 \(completed) / \(total)")
}

// 自动重连默认开启,可按需关闭
IKhoDeviceManager.shared.setAutoReconnect(enabled: true)

// 连接状态变化(断开与重连成功都会回调)
func deviceConnectionChanged(_ state: IKhoConnectionState) {
    switch state {
    case .connected:
        print("已连接,恢复同步")
    case .reconnecting:
        print("连接中断,等待设备回到近场")
    case .disconnected:
        print("已断开")
    }
}

func exportProgress(recordingId: String, progress: Int) {
    // 回调在 SDK 内部队列,更新 UI 前切回主线程
    DispatchQueue.main.async {
        self.progressText = "\(progress)%"
    }
}

// 让所有代理回调直接派发到主队列
IKhoDeviceManager.shared.callbackQueue = .main

// 查询当前音频缓存占用(字节)
let usedBytes = IKhoDeviceManager.shared.audioCacheSize()
print("缓存占用 \(usedBytes) 字节")

// 清理指定日期之前的缓存文件
let thirtyDaysAgo = Calendar.current.date(byAdding: .day, value: -30, to: Date())!
IKhoDeviceManager.shared.clearAudioCache(olderThan: thirtyDaysAgo)

// 清空全部音频缓存
IKhoDeviceManager.shared.clearAudioCache()

// 解绑当前设备并清除本地绑定态
IKhoDeviceManager.shared.unbind(clear: true)