# 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 图标
```