AGPting SDK 开发手册

概述

AGPting SDK 提供了一个完整的AI助手解决方案，包含语音唤醒、意图识别、对话管理和
特定功能处理等功能。本文档将详细介绍 SDK 的使用方法和主要组件。

基础配置

1. 初始化说明

首次使用 SDK 时，需要进行正确的初始化配置。

1.1 基础初始化

1.2 首次安装要求

建议首次安装时保持网络连接

如果首次安装时断网，应用会退出

重新联网后再次启动应用即可正常使用

1.3 设备验证流程

首次安装时会生成设备ID并保存

联网后会进行服务器验证

验证成功后会缓存配置信息

后续启动时优先使用缓存配置

2. 最佳实践

及时处理和显示错误信息

实现所有回调方法

正确处理生命周期事件

在 Activity/Fragment 销毁时释放资源

合理设置超时时间

注意内存泄漏问题

2.1 初始化建议

建议在应用启动时检查网络状态

首次安装时提示用户需要网络连接

实现适当的错误提示和重试机制

2.2 错误处理

SDK 使用统一的错误回调机制，通过 onError 方法传递错误信息。

常见错误类型：

Wakeup error: 唤醒错误

Recognition timeout: 识别超时

Network error: 网络错误

Initialization failed: 初始化失败

唤醒功能

1. 唤醒参数配置

2. 参数说明

micGain: 麦克风增益，范围 0.1-5.0，值越大音量越大

audioGain: 音频增益，范围 0.1-5.0，值越大音量越大

sensitivity: 识别灵敏度，范围 0.0-1.0，值越大越容易唤醒

sampleRate: 采样率，推荐 16000

noiseReduction: 是否启用降噪

noiseThreshold: 噪声阈值，范围 0.0-1.0，值越小降噪越强

smoothingFrames: 平滑帧数，范围 1-10，值越大平滑效果越好

3. 推荐配置

4. 状态流转

语音唤醒功能的状态流转如下：

IDLE (空闲) → SPEECH_RECOGNIZING (识别中) → THINKING (处理中) → SPEAKING (播放中) → IDLE

5. 超时处理

6. 唤醒词说明

目前支持的唤醒词为"hey nano"，如需自定义唤醒词，请联系技术支持。

意图识别

1. 意图置信度

对话管理

1. 对话上下文

2. 对话打断

性能优化

1. 内存管理

2. 缓存策略

意图识别模型缓存

唤醒词模型缓存

语音合成音频缓存

3. 网络优化

调试与测试

1. 日志级别

2. 性能监控

3. 测试模式

安全与隐私

1. 数据安全

本地数据存储使用 Android 加密存储

网络传输使用 HTTPS 加密

敏感信息（如设备ID）进行脱敏处理

2. 隐私保护

仅在必要时请求权限

提供隐私政策说明

支持用户数据删除

常见问题

1. 唤醒相关

Q: 为什么唤醒后没有自动退出？
A: 检查是否正确实现了超时处理，确保在 RECOGNITION_TIMEOUT 后调用 startWakeupDetection()。

Q: 唤醒词识别率低怎么办？
A: 1. 确保环境噪音不要过大
2. 保持适当的说话距离（建议 30-50cm）
3. 检查麦克风权限是否正确授予

2. 性能相关

Q: 如何优化电量消耗？
A: 1. 合理设置唤醒检测间隔
2. 不使用时及时调用 stopWakeupDetection()
3. 使用 PowerManager 管理唤醒状态

技术支持

技术支持邮箱：453031711@qq.com

官网：agpting.com

Android AI SDK-文字版开发文档

AGPting SDK 开发手册

概述

目录

基础配置

1. 初始化说明

1.1 基础初始化

1.2 首次安装要求

1.3 设备验证流程

2. 最佳实践

2.1 初始化建议

2.2 错误处理

唤醒功能

1. 唤醒参数配置

2. 参数说明

3. 推荐配置

4. 状态流转

5. 超时处理

6. 唤醒词说明

意图识别

1. 意图置信度

对话管理

1. 对话上下文

2. 对话打断

性能优化

1. 内存管理

2. 缓存策略

3. 网络优化

调试与测试

1. 日志级别

2. 性能监控

3. 测试模式

安全与隐私

1. 数据安全

2. 隐私保护

常见问题

1. 唤醒相关

2. 性能相关

技术支持

Android AI SDK-文字版 开发文档

AGPting SDK 开发手册#

概述#

目录#

基础配置#

1. 初始化说明#

1.1 基础初始化#

1.2 首次安装要求#

1.3 设备验证流程#

2. 最佳实践#

2.1 初始化建议#

2.2 错误处理#

唤醒功能#

1. 唤醒参数配置#

2. 参数说明#

3. 推荐配置#

4. 状态流转#

5. 超时处理#

6. 唤醒词说明#

意图识别#

1. 意图置信度#

对话管理#

1. 对话上下文#

2. 对话打断#

性能优化#

1. 内存管理#

2. 缓存策略#

3. 网络优化#

调试与测试#

1. 日志级别#

2. 性能监控#

3. 测试模式#

安全与隐私#

1. 数据安全#

2. 隐私保护#

常见问题#

1. 唤醒相关#

2. 性能相关#

技术支持#

Android AI SDK-文字版开发文档

AGPting SDK 开发手册

概述

目录

基础配置

1. 初始化说明

1.1 基础初始化

1.2 首次安装要求

1.3 设备验证流程

2. 最佳实践

2.1 初始化建议

2.2 错误处理

唤醒功能

1. 唤醒参数配置

2. 参数说明

3. 推荐配置

4. 状态流转

5. 超时处理

6. 唤醒词说明

意图识别

1. 意图置信度

对话管理

1. 对话上下文

2. 对话打断

性能优化

1. 内存管理

2. 缓存策略

3. 网络优化

调试与测试

1. 日志级别

2. 性能监控

3. 测试模式

安全与隐私

1. 数据安全

2. 隐私保护

常见问题

1. 唤醒相关

2. 性能相关

技术支持