起步应用与指南

Starter App 规格

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

本页描述的是 Embedded SDK 的接口形态设计,SDK 尚未开放发放。需要「用 iKho 硬件采集并绑定到你的 App」的合作方,请通过联系我们登记需求,我们会在 SDK 开放时通知。

当前已可用的是服务端三组接口:认证、文件上传、转写。可以先用你自己的音频跑通转写链路,见后端篇教程。

起步应用是一套 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 图标

这一页有帮助吗?