通过阅读本文,您可以了解如何在Android端接入AI实时互动消息对话智能体。
源码说明
源码下载
下载地址请参见GitHub开源项目。
源码结构
├── Android //Android平台工程结构跟目录
│ ├── AUIBaseKits //AUI基础组件
│ ├── AUIAICall //UI组件
│ ├── README.md
│ ├── app //Demo入口
│ ├── build.gradle
│ └── settings.gradle
环境要求
Android Studio 插件版本4.1.3
Gradle 7.0.2
Android Studio自带 JDK11
前提要求
已在您的服务端上开发了相关接口或直接部署提供的Server源码,搭建步骤请参见项目部署。
跑通Demo
源码下载后,使用Android Studio打开Android目录。
打开工程文件build.gradle,修改包Id。
您还需进入
AUIAICallAgentIdConfig.java
文件,修改ChatBot_AGENT_ID
为控制台生成的智能体ID,修改Region为智能体所在的区域。private static String ChatBot_AGENT_ID = "<控制台智能体ID>"; private static String Region = "<控制台智能体ID对应的区域>";
地域名称
Region Id
华东1(杭州)
cn-hangzhou
华东2(上海)
cn-shanghai
华北2(北京)
cn-beijing
华南1(深圳)
cn-shenzhen
新加坡
ap-southeast-1
完成智能体配置后,您可以通过以下两种方式来启动智能体:
已部署AppServer:如果您已经在您的服务端上部署了阿里云提供的AppServer源码,您还需要进入文件
AppServiceConst.java
,修改服务端域名。// AppServiceConst.java String HOST = "你的应用服务器域名";
未部署AppServer:如果您还未部署AppServer源码,需要快速跑通Demo并体验智能体。那么您需要进入文件
AUIAIChatAuthTokenHelper.java
,配置EnableDevelopToken
参数,并从控制台拷贝智能体使用的互动消息的AppId、AppKey和AppSign,在App端生成启动鉴权Token。重要该方法需在本地填写AppKey等敏感信息,仅适用于体验及开发阶段,不能用于线上发布,以防止因AppKey被盗取而导致的安全事故。
// AUIAIChatAuthTokenHelper.java public class AUIAIChatAuthTokenHelper { // 设置为true,启动Develop模式 private static final boolean EnableDevelopToken = true; //从控制台拷贝的互动消息的AppId private static final String AIChatIMDevelopAppId = "智能体使用的互动消息的AppId"; //从控制台拷贝互动消息的AppKey private static final String AIChatIMDevelopAppKey = "智能体使用的互动消息的AppKey"; //从控制台拷贝互动消息的AppSign private static final String AIChatIMDevelopAppSign = "智能体使用的互动消息的AppSign"; }
运行App,即可体验AI智能体消息对话功能
快速开发自己的AI对话功能
可通过以下几个步骤快速集成AUIAICall到您的APP中,让您的APP具备智能体消息对话功能。
集成源码
导入AUIAICall:仓库代码下载后,Android Studio菜单选择:File -> New -> Import Module,导入选择文件夹。
修改文件夹下的build.gradle的三方库依赖项。
dependencies { implementation 'androidx.appcompat:appcompat:x.x.x' //修改x.x.x为你工程适配的版本 implementation 'com.google.android.material:material:x.x.x' //修改x.x.x为你工程适配的版本 androidTestImplementation 'androidx.test.espresso:espresso-core:x.x.x' //修改x.x.x为你工程适配的版本 implementation 'com.aliyun.aio:AliVCSDK_ARTC:7.4.0' //修改x.x.x为你工程适配的版本 implementation 'com.aliyun.auikits.android:ARTCAICallKit:2.7.1' implementation 'com.aliyun.sdk.android:AliVCInteractionMessage:x.x.x' }
等待gradle同步完成,完成源码集成。
源码配置
已完成前提条件所需步骤。
进入
AppServiceConst.java
文件,修改服务端域名。// AppServiceConst.java String HOST = "你的应用服务器域名";
说明如果您还未部署AppServer,您可以使用App端生成鉴权Token的方式,快速测试并跑通Demo。详细内容,请参见未部署AppServer。
调用API
上述工作完成后,接下来可以根据自身的业务场景和交互,在您APP其他模块或主页上通过组件接口启动AI对话,也可以根据自身的需求修改源码。
/** 启动之前保证麦克风、摄像头权限已授权 */
// 智能体类型
ARTCAICallEngine.ARTCAICallAgentType aiCallAgentType =
ARTCAICallEngine.ARTCAICallAgentType.ChatBot;
// 智能体ID,消息对话中智能体ID不能为空
String aiAgentId = "XXXXXX";
Context currentActivity = AUIAICallEntranceActivity.this;
Intent intent = new Intent(currentActivity, AUIAIChatInChatActivity.class);
// 进入消息对话的用户id,建议使用业务的登录用户id
String userId = "123";
intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_LOGIN_USER_ID, userId);
// 智能体类型
intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_AI_AGENT_TYPE, aiCallAgentType);
// 智能体ID
intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_AI_AGENT_ID, aiAgentId);
currentActivity.startActivity(intent);