导航|地址|刷新
集成指南-个推文档中心








文档中心开发者中心

，欢迎您！

您的优惠服务将于到期。





基本资料



安全设置



应用管理




退出登录
登录/注册SDK下载个推学堂请选择产品
消息推送

用户运营

OneID服务

AI应用工坊

统计分析

用户分析

标签管理

模型管理

短信服务

数字人外呼

一键认证

合规检测

点击提升







体验更多产品服务


欢迎登录开发者中心

立即登录

本月不再提醒





使用手册

客户端
Android
集成文档

API文档


iOS
集成文档

API文档


H5&小程序
集成文档

API文档



常见问题

SDK更新日志




当前位置：个推AI应用工坊 > 客户端 > Android > 集成文档



集成指南


集成指南

本文档介绍 Android Studio 开发环境下基于 Maven 方式集成的步骤。

本文档适用 SDK 版本：2.0.0.0 及以后


本文默认读者已经具有基础的 Android 知识，以及项目工程结构如下：
Getui_SDK_Demo_AS_official/ |- app/ （项目主模块） ||- libs/ （第三方库） ||- src/ （代码目录） ||- build.gradle （模块级 gradle 文件） |- gradle/ |- build.gradle （顶层 gradle 文件） |- settings.gradle | ......
注：其中 “......” 表示省略其他与本教程无关的内容，以下 “......” 表示相同意义，不再重复说明。


重点提示

注意：

1、需要集成com.getui:gtc:3.3.1.0及以上版本。

1. 创建个推应用

请参考 创建应用 获取相应的AppID信息。该信息在之后的步骤配置中将会使用。

2. Maven 集成

2.1 配置 Maven 库地址

在项目根目录 build.gradle 文件的 allprojects.repositories 块中，添加个推 maven 库地址 maven { url "https://mvn.getui.com/nexus/content/repositories/releases/"}，如下所示：
buildscript { repositories { mavenCentral()google() } dependencies { ...... } } allprojects { repositories { mavenCentral()google()maven { url'https://jitpack.io' } //个推仓库地址maven { url"https://mvn.getui.com/nexus/content/repositories/releases/" } } }
2.2 配置依赖


配置 SDK 依赖及应用参数：在 app/build.gradle 文件的 dependencies 块中引用个推 SDK 依赖 implementation 'com.getui:aisdk:${version}'，此处的 ${version} 为对应的 SDK 版本号，并在android.defaultConfig 下添加 manifestPlaceholders，配置个推相关的应用参数， 如下所示：
......android{defaultConfig{manifestPlaceholders = [GETUI_APPID : "your appid",]}......}dependencies{api'com.getui:aisdk:2.0.1.0' //AI SDKapi'com.getui:gtc:3.3.1.0' //个推核心组件}

2.3 权限申明（重要）

为确保AISDK能稳定运行，SDK需要以下权限，aar包中的manifest已默认添加
</manifest><uses-permissionandroid:name="android.permission.RECORD_AUDIO" /><uses-permissionandroid:name="android.permission.MODIFY_AUDIO_SETTINGS" /><uses-permissionandroid:name="android.permission.ACCESS_NETWORK_STATE" /><uses-permissionandroid:name="android.permission.INTERNET" /><uses-permissionandroid:name="android.permission.ACCESS_COARSE_LOCATION" /><uses-permissionandroid:name="android.permission.ACCESS_FINE_LOCATION" /></manifest>
3. 编写集成代码

3.1 初始化 SDK

SDK需要先初始化才能正常运行，建议您在Application或首页的OnCreate方法中，初始化AISDK。请参考下列代码实现初始化方法：
AiManager.getInstance().initialize(getApplicationContext(), new Callback<String>() { @Override public void onFailure(Throwable t) { //初始化失败Log.e("AISDK", "初始化失败", t); } @Override public void onResponse(String response) { //初始化成功，返回 'sdk init success'Log.d("AISDK", "初始化成功: " + response); } });
注意：后续SDK所有的API调用都依赖初始化成功，请确保onResponse完成后再调用其他接口

3.2 加载智能体页面

SDK需要确保初始化成功后才能进行AI会话
//true表示打开智能体页面；false表示不打开，开发者可根据response里的url自行处理AiManager.getInstance().loadAgent("{替换为你的agentId}", true, new Callback<String>() { @Override public void onFailure(Throwable t) { Log.e("AISDK", "loadAgent failed", t); } @Override public void onResponse(String response) { Log.e("AISDK", "loadAgent success"); } });
成功拉起聊天页如下








以上文档对您是否有帮助？
有帮助没帮助



您的改进建议

是否遇到以下问题

问题类型


1、内容与功能不一致；

2、文章描述不清晰；

3、图片和视频难理解；

4、对产品功能不满意；

5、不是我想要的内容；

6、其他:


问题类型不能为空



反馈建议



联系方式



取 消提 交





反馈成功

非常感谢您的反馈，我们会继续努力做到更好！
确定






在这篇文章中：重点提示1. 创建个推应用2. Maven 集成3. 编写集成代码







文档中心搜索

搜 索















------
导航页 打开网址