# Starter App 规格

> 起步应用规划的能力清单、架构概览与目录结构。仓库尚未开放提供。

本页描述的是 Embedded SDK 的接口形态设计,SDK 尚未开放发放。需要「用 iKho 硬件采集并绑定到你的 App」的合作方,请通过[联系我们](/docs/mcp-cli/contact/)登记需求,我们会在 SDK 开放时通知。
当前已可用的是服务端三组接口:[认证](/docs/api-reference/auth/overview/)、[文件上传](/docs/api-reference/file/overview/)、[转写](/docs/api-reference/transcription/overview/)。可以先用你自己的音频跑通转写链路,见[后端篇教程](/docs/embedded/tutorial-backend/)。

起步应用是一套 iOS 模板工程的设计,集成 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 图标
```