跳到正文
起步应用与指南

Starter App 规格

起步应用内置的能力清单、架构概览与目录结构。

起步应用是一套可直接上手的生产级模板,已集成 Embedded SDK 与转写 API。下面是它开箱即用的能力与工程结构。

内置能力

能力说明
设备绑定从蓝牙扫描到加密绑定的完整配对流程,支持多设备
录音同步BLE 与 Wi-Fi 快传双通道,把设备上的录音同步到手机
录音列表展示录音元数据(时长、大小、时间),支持单条与批量操作
转写展示调用转写 API,展示带说话人与时间戳的逐字稿
本地缓存已同步的音频与逐字稿本地留存,离线可读
多语言界面文案支持中英文切换

架构概览

起步应用是纯 SwiftUI 工程,业务协调层调用 Embedded SDK 完成设备操作,转写走转写 API:

  • 视图层(SwiftUI) —— 欢迎、扫描、主界面、录音列表、详情、设置。
  • 协调层(DeviceCoordinator) —— 持有 IKhoDeviceManager,实现 IKhoDeviceDelegate,把设备事件转成界面状态。
  • Embedded SDK —— 负责 BLE / Wi-Fi 通道、加密绑定与音频同步。
  • 转写 API —— 上传同步下来的音频,异步取回逐字稿。
图示占位起步应用架构图(视图层 → 协调层 → Embedded SDK / 转写 API)

目录结构

bash
ikho-starter-app/
└── ios/
    ├── IKhoStarterApp.xcodeproj
    ├── IKhoConfig.xcconfig        # Client 凭证与用户令牌
    └── IKhoStarterApp/
        ├── App/                   # App 入口与生命周期
        ├── Onboarding/            # 欢迎页、扫描、绑定
        ├── Home/                  # 已连接设备、录音入口
        ├── Files/                 # 录音列表与同步
        ├── Detail/                # 逐字稿与活动记录
        ├── Settings/             # 解绑、固件、账户
        ├── Theme/                 # IKhoTheme.swift 品牌色
        └── Resources/             # Assets.xcassets 图标