deepvoice_client/local_plugins/chat_api/android

ChatAPI Android 实现

基于 openai-kotlin 4.0.1 的 ChatAPI 插件 Android 实现。

特性

• ✅ 基于 openai-kotlin 4.0.1 的 OpenAI API 客户端
• ✅ 与 iOS 版本接口完全一致
• ✅ 支持流式和非流式对话
• ✅ 支持多模态内容（文本和图像识别）
• ✅ 工具调用架构预留（MCP 功能暂时留空）
• ✅ 协程支持和异步处理
• ✅ 完整的错误处理和取消机制

依赖

• openai-kotlin 4.0.1
• ktor-client-okhttp 2.3.2
• kotlinx-coroutines
• gson

主要文件

• ChatApiPlugin.kt - Flutter 插件桥接层
• ChatApiService.kt - 核心 ChatAPI 服务实现
• StreamCallback.kt - 流式回调接口

与 iOS 版本的一致性

Android 实现完全遵循 iOS 版本的接口定义：

1. 初始化方法: initialize(apiKey, baseUrl, model, mcpServer)
2. 消息创建: createUserMessage(), createAssistantMessage()
3. 消息发送: sendMessage() (非流式), sendMessageStream() (流式)
4. 函数注册: registerFunction()
5. MCP 相关: 接口保留，功能暂时留空
6. 流式事件: 完全一致的事件类型和回调

MCP 功能状态

MCP (Model Context Protocol) 相关功能在 Android 版本中暂时留空，包括：

• initializeMcpClient() - 返回 false
• isMcpInitialized() - 返回 false
• handleMcpToolCall() - 返回占位符消息
• 工具调用会通知上层但不会实际执行

使用示例

// 初始化
chatApiService.initialize(
    apiKey = "your-api-key",
    baseUrl = "https://api.openai.com/v1/",
    model = "gpt-3.5-turbo",
    mcpServer = ""
)

// 流式对话
chatApiService.sendMessageStream(listOf(
    mapOf("role" to "user", "content" to "Hello!")
))

注意事项

1. 需要网络权限 INTERNET 和 ACCESS_NETWORK_STATE
2. 所有网络请求在后台线程执行
3. 流式回调在主线程触发
4. 支持取消正在进行的请求