Android-MVVM-Architecture-Android-Voice-AI-SDK

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Kotlin 编写的 Android 应用工程（UI 基于 Jetpack Compose）
• 已接入 Hilt 依赖注入，可标注 @HiltAndroidApp 与 @AndroidEntryPoint
• 可用的 Anthropic API Key
• 设备麦克风与扬声器，用于音频采集与语音播放

安装与启动步骤

1. 1确认工程前置条件

   README 只给出 Hilt 配置与配置项说明，未提供 Gradle 依赖坐标，需先到仓库或官网确认引入方式再动手。

2. 2开启 Hilt 应用入口

   在自定义 Application 类上加 @HiltAndroidApp；这是 README Quick Start 中明确给出的 Hilt setup 步骤。

   @HiltAndroidApp
   class MyApp : Application()

   复制

3. 3标记 Activity 入口

   在承载语音交互界面的 Activity 上加 @AndroidEntryPoint，Hilt 才能完成注入；README 示例为 ComponentActivity 子类。

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

   复制

4. 4覆盖 VoiceAIConfig

   把 config { } 块传给 VoiceAISDK.Builder 覆盖默认值，anthropicApiKey 为必填；参考 README 配置表填写其他字段。

   config {
       anthropicApiKey = "sk-ant-xxxxxxxx"
       aiModel = "claude-3-5-sonnet-20241022"
   }

   复制

关键配置

如何确认成功

运行应用并授予麦克风权限，对设备说一句话；若能听到 TTS 语音回复，说明 VAD→STT→Claude→TTS 链路已打通。

常见问题

注意事项

• README 的 Quick Start 只展示了 Step 2（Hilt setup），缺少 Step 1 的依赖引入说明，请以仓库和官网文档为准。
• 配置表字段均属于 VoiceAIConfig，通过传给 VoiceAISDK.Builder 的 config { } 块覆盖默认值。
• 启用 emotionDetectionEnabled 必须先取得用户同意并填写 emotionConsentRationale。
• certificatePins 只接受 SHA-256 证书指纹，用于 OkHttp 客户端的证书固定。