基于 MVVM 架构的 Android Voice AI SDK

flowchart LR
    Microphone --> AudioRecord --> VAD --> STT --> ClaudeAI["Claude AI"] --> TTS --> Speaker

---

Android Voice AI SDK 是一个可复用的 Android 库，让任何应用都能在几分钟内集成完整的语音驱动 AI 对话管道。它通过设备麦克风采集音频，将语音转录为文本，发送给 Anthropic Claude 获取智能响应，并通过文本转语音（TTS）功能将回复朗读给用户——这一切只需通过一个 VoiceAISDK.Builder 调用即可完成。该 SDK 提供开箱即用的 Jetpack Compose UI 组件、可替换的 STT/TTS 引擎适配器、端侧情绪检测，以及包括 PII（个人身份信息）脱敏和加密密钥存储在内的安全工具。

功能特性

层级	能力
音频输入	语音活动检测 (VAD)、噪声处理、流式 PCM 采集
识别	语音转文本 (STT)、语言检测、说话人区分
理解	意图提取、实体识别、对话上下文
操作	API 编排、工作流执行、任务自动化
响应	LLM 回答生成 (Anthropic Claude)
语音输出	文本转语音 (TTS)、语音风格选择、音频流式传输
安全	用户授权、身份验证、防滥用
分析	对话日志、会话摘要、质量指标

要求

要求	版本
Android Studio	Meerkat 或更高版本
最小 SDK	24 (Android 7.0)
Kotlin	2.0+ (项目使用 2.3.21)
Anthropic API 密钥	必需 — 请在 console.anthropic.com 获取

快速开始

第 1 步 — 添加依赖和 Manifest 权限

在您的 build.gradle.kts 中：

dependencies {
    implementation("com.sdk:voice-ai-sdk:1.0.0")
}

在 app/src/main/AndroidManifest.xml 中：

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />

第 2 步 — Hilt 设置

在您的 Application 类上标注 @HiltAndroidApp，在 Activity 上标注 @AndroidEntryPoint：

@HiltAndroidApp
class MyApp : Application()

@AndroidEntryPoint
class MainActivity : ComponentActivity() { ... }

第 3 步 — 在 local.properties 中添加 API 密钥

local.properties 已被 git 忽略，因此您的密钥不会进入源代码控制：

ANTHROPIC_API_KEY=sk-ant-...

然后通过 app/build.gradle.kts 中的 BuildConfig 将其公开：

defaultConfig {
    buildConfigField(
        "String",
        "ANTHROPIC_API_KEY",
        "\"${project.findProperty("ANTHROPIC_API_KEY") ?: ""}\"",
    )
}

buildFeatures {
    buildConfig = true
}

第 4 步 — 构建 SDK

通过创建 AppModule 使用 Hilt 提供 SDK：

@Module
@InstallIn(SingletonComponent::class)
object AppModule {

    @Provides
    @Singleton
    fun provideVoiceAIConfig(): VoiceAICo