SealTalk-Android
Android 应用 SealTalk 由 融云 RongCloud 出品。
特别注意
SealTalk 自从 1.3.14 版本起，CallLib 模块引用的音视频引擎已替换成 RTC 3.0，与之前的版本不互通。详细内容请参考官网的
特点
- Android iOS Web 多端互通,如果需要你的产品也可以这样实现。
- 音视频通话 功能
- 地理位置,位置共享功能。
- 随心的 消息自定义 , 功能模块自定义。
- 完整的好友体系代码示例。
- 完整的群组功能代码示例。
- 单聊,群组,聊天室多种社交场景满足你的需求,如果还想要 视频直播 都可以。
- 一行代码搞定 客服? 你没有听错,比你想象的还要简单。
运行 SealTalk-Android
- 替换 sealtalk 中 gradle.properties 中的 SEALTALK_SERVER 值为您所部署的 SealTalk 服务地址。
SEALTALK_SERVER="这里请替换为您所部署的 SealTalk Server 地址"
- 替换 sealtalk 中 gradle.properties 中的 SEALTALK_APP_KEY 替换为您所申请的融云 AppKey。
SEALTALK_APP_KEY="这里请替换为您的融云 AppKey"
- 若使用第三方推送，请参考 IMManager.java 中 initPush 方法，打开注释并在 sealtalk 中 gradle.properties 中各个平台参数替换成您申请的各平台的推送信息
/**
* 初始化推送
*/
private void initPush() {
/*
* 配置 融云 IM 消息推送
* 根据需求配置各个平台的推送
* 配置推送需要在初始化 融云 SDK 之前
*/
//PushConfig config = new PushConfig
// .Builder()
// .enableHWPush(true) // 在 AndroidManifest.xml 中搜索 com.huawei.hms.client.appid 进行设置
// .enableMiPush(BuildConfig.SEALTALK_MI_PUSH_APPID, BuildConfig.SEALTALK_MI_PUSH_APPKEY)
// .enableMeiZuPush(BuildConfig.SEALTALK_MIZU_PUSH_APPID, BuildConfig.SEALTALK_MIZU_PUSH_APPKEY)
// .enableVivoPush(true) // 在 AndroidManifest.xml 中搜索 com.vivo.push.api_key 和 com.vivo.push.app_id 进行设置
// .enableFCM(true) // 在 google-services.json 文件中进行配置
// .build();
//RongPushClient.setPushConfig(config);
}
- 若您要接入 FCM 推送，需要做以下几步工作:
- 打开 AndroidManifest.xml 解除掉以下注释。
<!-- [START firebase_service] -->
<!--
<service
android:name="io.rong.push.platform.google.RongFirebaseMessagingService"
android:stopWithTask="false">
<intent-filter>
<action android:name="com.google.firebase.MESSAGING_EVENT" />
</intent-filter>
</service>
<meta-data
android:name="firebase_messaging_auto_init_enabled"
android:value="false" />
<meta-data
android:name="firebase_analytics_collection_enabled"
android:value="false" />
-->
<!-- [END firebase_service] -->
- 在 build.gradle 中解除以下注释
//apply plugin: 'com.google.gms.google-services'
...
//api 'com.google.firebase:firebase-messaging:17.6.0'
...
*
- 编译 google-services.json 配置为您的 FCM 推送相关配置参数
- 若您要接入华为 4.0 推送，您需要做以下几步工作：
- 解除 sealtalk 中 build.gralde 中的注释
// apply plugin: 'com.huawei.agconnect'
- 解除工程跟目录下的 build.gradle 中的以下注释:
dependencies {
// 华为推送需要开启下面注释
// classpath 'com.huawei.agconnect:agcp:1.1.1.300'
- 登录华为开发者后台，在我的应⽤->开发->概览->下载 agconnect-servics.json, .将下载好的 agconnect-servics.json ⽂件放到 sealtalk 模块下的根⽬录。
- 若使用地图相关功能，在 AndroidManifest.xml 中搜索 com.amap.api.v2.apikey 修改为您的高德地图 ApiKey
<!-- 高德地图-->
<!--
<meta-data
android:name="com.amap.api.v2.apikey"
android:value="替换你申请的高德地图 ApiKey" />
-->
- 若使用微信相关功能，请替换 WXManager.java 中 APP_ID 为您申请的 AppId
public class WXManager {
private static final String TAG = "WXManager";
private static final String APP_ID = "替换为您的微信开放平台 AppId";
- 重要 由于JCenter已停止服务，在老版本中请替换项目主工程的 build.gradle中的maven仓库地址
//在项目主工程的 build.gradle 引入融云maven仓库
maven {url "http://maven.rongcloud.cn/repository/maven-releases/"}
备注：
SealTalk Server 源码可以参考这里
Gif
新增红包
强大的全局搜索
单人、多人音视频
客服/机器人服务
群组
APK
SDK 集成说明
请参考官网 SDK 集成说明指南
关于 SealTalk 2.0
SealTalk 2.0 重构了内部逻辑实现，整体代码将更清晰易读。使用 LiveData + ViewModel + Retrofit 2.0 + Room 等框架基于 MVVM 模式进行开发。
由于 DataBinding 存在调试难, 并要在 XML 编写等问题, 所以经过讨论之后, 决定弃用DataBinding.
架构图
Ativity/Fragment 作为 View 层, 负责界面显示和事件交互.
UserInfoViewModel 等为 ViewModel 层. 连接 View 和 Model 的桥梁, 数据通过 LiveData 返回. ViewModel 可通过调用不同的 Task 来获取不同的数据源.
Task 层即为 Repository . 根据不同的接口或数据属性, 分别封装了不同的 Task, 例如关于 User 的数据操作就封装在了 UserTask 中. 这样功能模块职能清晰并复用性高. 所有数据请求等只需编写一次即可.
Service 和 Dao 是分别请求网络数据和数据库数据操作. 分别使用了 Retrofit 和 Room 的依赖库.
数据请求流程
在新版中也对数据的请求机制做了信息设计处理. 请求数据分为三种.
- 网络请求需要缓存的
- 网络请求且不需要缓存的
- 数据库直接查询的
需要网络请求并需要缓存的
在 Task 层首先会查询数据库, 然后返回当前数据库中的缓存数据, 此数据用于请求网络时, 页面友好展示. 然后再请求服务器,获取最新数据, 获取数据成功后会把新数据保存至数据库, 最后再进行一次数据库查询, 获取数据库中的最新数据. 此机制虽然烦琐, 但极大的保证了界面展示的数据于最新数据的一致性.
网络请求且不需要缓存的
Task 直接进行网络请求并返回数据.
数据库直接查询的
运行环境
- Android Studio 3.2 以上版本 SealMic 适配了 Android X，所以需要 使用 3.2 以上版本的 Android Studio 才能保证可以正常编译和使用。代码中有地方可能报红色错误, 不影响编译运行. 推荐使用真实 Android 设备 部分模拟器会存在功能缺失或运行环境不稳定等情况影响使用体验。
- TargetVersion 版本需 26 及以上版本
支持
- 知识库
- 工单,需要登录融云开发者账号
- Android 视频教程