开发者在集成融云即时通信、实时网络能力前,需前往融云官方网站注册创建融云开发者帐号。
您可以到融云官方网站下载融云 SDK。融云 SDK 各部分功能以插件化的形式独立提供,开发者可以根据自己的需要,自由组合下载。各组件的功能如下:
名称 | 功能介绍 | 支持的 CPU 架构 |
---|---|---|
IMKit |
融云 IM 界面组件 | —— |
IMLib |
融云 IM 通讯能力库 | armeabi, armeabi-v7a, arm64-v8a, x86 |
CallKit |
融云音视频界面组件 | —— |
CallLib |
融云音视频核心组件 | armeabi-v7a, arm64-v8a |
LocationLib |
融云位置相关库 | —— |
PushLib |
融云第三方推送库 | armeabi, armeabi-v7a, arm64-v8a, x86 |
RedPacket |
融云红包相关组件 | —— |
RCSticker |
融云表情相关组件 | -- |
您要进行应用开发之前,需要先在融云开发者平台创建应用。如果您已经注册了融云开发者帐号,请前往融云开发者平台创建应用。
您创建完应用后,首先需要了解的是 App Key / Secret,它们是融云 SDK 连接服务器所必须的标识,每一个 App 对应一套 App Key / Secret。针对开发者的生产环境和开发环境,我们提供两套 App Key / Secret,两套环境的功能完全一致。您在应用最终上线前,使用开发环境即可。
Token 称为用户令牌,App Key 是您的 App 的唯一标识,Token 则是您 App 上的每一个用户的身份授权象征。您可以通过提交 userId 等信息来获得一个该用户对应的 Token,并使用这个 Token 作为该用户的唯一身份凭证与其他用户进行通信。
Token 的主要作用是身份授权和安全,因此不能通过客户端直接访问融云服务器获取 Token,您必须通过 Server API 从融云服务器 获取 Token 返回给您的 App,并在之后连接时使用。详细描述请参考 Server 开发指南中的用户服务和获取 Token 方法小节。
通过 API 调试,您可以得到一个 Token 返回值。您就可以直接使用这个 Token 为这位用户进行发送和接受消息。
环境要求
在您集成融云 SDK 前环境要求如下:
我们建议初次集成 SDK 的用户,先创建一个空项目来集成融云的 SDK,然后再考虑加入您的工程。
以 Module 形式导入前面下载的融云 SDK 里面的各个组件。
打开您的工程, File -> New -> Import Module
打开您从官网下载的融云 SDK,选择 IMLib。如图:
根据您的需要,以同样的步骤导入 SDK 里的其它组件: IMKit,CallKit,CallLib,RedPacket,RCSticker。
将 LocationLib 里的 jar 包拷贝到您应用的 libs 目录下(如果不需要位置功能,可跳过此步骤)。
注意
音视频通话组件 CallLib 仅支持 armeabi-v7a 和 arm64-v8a 架构 CPU (组件功能),如果您使用了我们的音视频通话功能,注意需要把 IMLib 和 PushLib 组件中其它 CPU 架构的 so 删除。或者您也可以在应用的 build.gradle 文件中增加如下配置来过滤 so :
defaultConfig {
applicationId "XXX"
...
ndk {
abiFilters "armeabi-v7a", "arm64-v8a"
}
}
打开应用的 build.gradle,在 dependencies 中添加相应模块的依赖。如图:
打开 IMLib Module 的 AndroidManifest.xml 文件,把 meta-data RONG_CLOUD_APP_KEY 的值修改为您自己的 AppKey. 如图:
<meta-data
android:name="RONG_CLOUD_APP_KEY"
android:value="您的应用 AppKey" />
打开应用的 App Module 的 AndroidManifest.xml 文件, 把从高德官网获取的 AppKey 添加到 meta-data 里 (如果您不使用位置功能,可跳过此步骤)。
<meta-data
android:name="com.amap.api.v2.apikey"
android:value="高德地图的 AppKey" />
在应用的 App Module 的 AndroidManifest.xml 文件中,添加 FileProvider 相关配置,修改 android:authorities 为您的应用的 “ApplicationId”.FileProvider。
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="您的 ApplicationId.FileProvider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/rc_file_path" />
</provider>
在整个应用程序全局,您只需要调用一次 init
方法。对于快速集成,我们建议您在 App 主进程初始化,您只需要实现一句函数,以下为融云 Demo 代码示例:
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
RongIM.init(this);
}
}
关于初始化的注意事项
融云的 SDK 使用了跨进程机制来进行通信,运行后您的 App 后您会发现以下三个进程: 1、您的应用进程;2、您的应用进程:ipc,这是融云的通信进程;3、io.rong.push,这是融云的推送进程,如集成的是融云第三方推送,则不会存在此推送进程。
连接服务器前,确认已通过融云 Server API 接口获取 Token。
调用 connect() 方法连接融云服务器,该方法在整个应用的生命周期里只需要调用一次,且必须在主进程调用。如果连接失败,SDK 会自动启动重连机制,进行最多 10 次重连,分别是 1、2、4、8、16、32、64、128、256、512 秒后。如果仍然没有连接成功,还会在检测网络状态变化时再次重连。您不需要做额外的重连操作。
注意:当应用被杀死后,接受到推送通知,点击通知拉起应用时,此时应用被重新唤起,属于新的生命周期,所以需要再次调用 connect() 方法进行连接。
/**
* <p>连接服务器,在整个应用程序全局,只需要调用一次,需在 {@link #init(Context)} 之后调用。</p>
* <p>如果调用此接口遇到连接失败,SDK 会自动启动重连机制进行最多10次重连,分别是1, 2, 4, 8, 16, 32, 64, 128, 256, 512秒后。
* 在这之后如果仍没有连接成功,还会在当检测到设备网络状态变化时再次进行重连。</p>
*
* @param token 从服务端获取的用户身份令牌(Token)。
* @param callback 连接回调。
* @return RongIM 客户端核心类的实例。
*/
private void connect(String token) {
if (getApplicationInfo().packageName.equals(App.getCurProcessName(getApplicationContext()))) {
RongIM.connect(token, new RongIMClient.ConnectCallback() {
/**
* Token 错误。可以从下面两点检查 1. Token 是否过期,如果过期您需要向 App Server 重新请求一个新的 Token
* 2. token 对应的 appKey 和工程里设置的 appKey 是否一致
*/
@Override
public void onTokenIncorrect() {
}
/**
* 连接融云成功
* @param userid 当前 token 对应的用户 id
*/
@Override
public void onSuccess(String userid) {
Log.d("LoginActivity", "--onSuccess" + userid);
startActivity(new Intent(LoginActivity.this, MainActivity.class));
finish();
}
/**
* 连接融云失败
* @param errorCode 错误码,可到官网 查看错误码对应的注释
*/
@Override
public void onError(RongIMClient.ErrorCode errorCode) {
}
});
}
}
融云 IMKit SDK 使用了 Fragment 作为会话列表和会话界面的组件,其优点是支持各种嵌套方式,更符合您的定制化需求。 下面说明如何在 Activity 里以静态方式加载融云 Fragment.
这是您的会话列表 Activity 对应的布局文件:conversationlist.xml。注意 android:name 固定为融云的 ConversationListFragment。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical" android:layout_width="match_parent"
android:layout_height="match_parent">
<fragment
android:id="@+id/conversationlist"
android:name="io.rong.imkit.fragment.ConversationListFragment"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
public class ConversationListActivity extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.conversationlist);
FragmentManager fragmentManage = getSupportFragmentManager();
ConversationListFragment fragement = (ConversationListFragment) fragmentManage.findFragmentById(R.id.conversationlist);
Uri uri = Uri.parse("rong://" + getApplicationInfo().packageName).buildUpon()
.appendPath("conversationlist")
.appendQueryParameter(Conversation.ConversationType.PRIVATE.getName(), "false")
.appendQueryParameter(Conversation.ConversationType.GROUP.getName(), "false")
.appendQueryParameter(Conversation.ConversationType.PUBLIC_SERVICE.getName(), "false")
.appendQueryParameter(Conversation.ConversationType.APP_PUBLIC_SERVICE.getName(), "false")
.appendQueryParameter(Conversation.ConversationType.SYSTEM.getName(), "true")
.build();
fragement.setUri(uri);
}
}
融云 SDK 是通过隐式调用的方式来实现界面跳转的。因此您需要在 AndroidManifest.xml 中,您的会话列表 Activity 下面配置 intent-filter,其中,android:host 是您应用的 ApplicationId,需要手动修改,其他请保持不变。
<!--会话列表-->
<activity
android:name="io.rong.fast.activity.ConversationListActivity"
android:screenOrientation="portrait"
android:windowSoftInputMode="stateHidden|adjustResize">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="io.rong.fast"
android:pathPrefix="/conversationlist"
android:scheme="rong" />
</intent-filter>
</activity>
融云支持在会话列表页面自定义某种类型的会话以聚合形式展示,比如,定义所有私聊会话聚合显示,则在会话列表页所有私聊会话聚合显示为“我的私人会话”,点击“我的私人会话”,会进入所有私聊会话的展示页面,这个页面即为聚合会话列表,如图:
如果您的应用定义了聚合会话,请按照下面的说明进行相应配置,否则可以直接跳过此步骤。
自定义聚合会话列表请参考会话列表自定义。
配置布局文件
这是您的聚合会话列表 Activity 对应的布局文件:subconversationlist.xml。 注意 android:name 固定为融云的 SubConversationListFragment。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<fragment
android:id="@+id/subconversationlist"
android:name="io.rong.imkit.fragment.SubConversationListFragment"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
新建 Activity :
public class SubConversationListActivtiy extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.subconversationlist);
FragmentManager fragmentManage = getSupportFragmentManager();
SubConversationListFragment fragement = (SubConversationListFragment) fragmentManage.findFragmentById(R.id.conversationlist);
Uri uri = Uri.parse("rong://" + context.getApplicationInfo().packageName).buildUpon()
.appendPath("subconversationlist")
.appendQueryParameter("type", conversationType.getName())
.build();
fragement.setUri(uri);
}
}
配置 intent-filter
在 AndroidManifest.xml 中, 聚合会话 Activity 下面配置 intent-filter。 注意请修改 android:host 为您应用的 ApplicationId,其他保持不变。
<!--聚合会话列表-->
<activity
android:name="io.rong.fast.activity.SubConversationListActivtiy"
android:screenOrientation="portrait"
android:windowSoftInputMode="stateHidden|adjustResize">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="io.rong.fast"
android:pathPrefix="/subconversationlist"
android:scheme="rong" />
</intent-filter>
</activity>
会话 Fragment 跟会话列表是完全一致的,您可以用同样的方式快速的配置好。
配置布局文件
这是您的会话 Activity 对应的布局文件 conversation.xml,注意 android:name 固定为融云的 ConversationFragment。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<fragment
android:id="@+id/conversation"
android:name="io.rong.imkit.fragment.ConversationFragment"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
public class ConversationActivity extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.conversation);
FragmentManager fragmentManage = getSupportFragmentManager();
ConversationFragment fragement = (ConversationFragment) fragmentManage.findFragmentById(R.id.conversation);
Uri uri = Uri.parse("rong://" + getApplicationInfo().packageName).buildUpon()
.appendPath("conversation").appendPath(mConversationType.getName().toLowerCase())
.appendQueryParameter("targetId", mtargetId).build();
fragement.setUri(uri);
}
}
在 AndroidManifest.xml 中,会话 Activity 下面配置 intent-filter。 注意请修改 android:host 为您应用的 ApplicationId,其他保持不变。
<!--会话界面-->
<activity
android:name="io.rong.fast.activity.ConversationActivity"
android:screenOrientation="portrait"
android:windowSoftInputMode="stateHidden|adjustResize">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="io.rong.fast"
android:pathPrefix="/conversation/"
android:scheme="rong" />
</intent-filter>
</activity>
RongIM.getInstance().startConversationList();
去唤起会话列表。
完成以上配置后,即可启动会话及会话列表界面,启动界面操作必须在执行初始化 SDK 方法 init
及连接融云服务器 connect
之后进行,示例如下:
/**
* <p>启动会话界面。</p>
* <p>使用时,可以传入多种会话类型 {@link io.rong.imlib.model.Conversation.ConversationType} 对应不同的会话类型,开启不同的会话界面。
* 如果传入的是 {@link io.rong.imlib.model.Conversation.ConversationType#CHATROOM},sdk 会默认调用
* {@link RongIMClient#joinChatRoom(String, int, RongIMClient.OperationCallback)} 加入聊天室。
* 如果你的逻辑是,只允许加入已存在的聊天室,请使用接口 {@link #startChatRoomChat(Context, String, boolean)} 并且第三个参数为 true</p>
*
* @param context 应用上下文。
* @param conversationType 会话类型。
* @param targetId 根据不同的 conversationType,可能是用户 Id、群组 Id 或聊天室 Id。
* @param title 聊天的标题,开发者可以在聊天界面通过 intent.getData().getQueryParameter("title") 获取该值, 再手动设置为标题。
*/
public void startConversation(Context context, Conversation.ConversationType conversationType, String targetId, String title)
/**
* 启动会话列表界面。
*
* @param context 应用上下文。
* @param supportedConversation 定义会话列表支持显示的会话类型,及对应的会话类型是否聚合显示。
* 例如:supportedConversation.put(Conversation.ConversationType.PRIVATE.getName(), false) 非聚合式显示 private 类型的会话。
*/
public void startConversationList(Context context, Map<String, Boolean> supportedConversation)
/**
* 启动聚合后的某类型的会话列表。<br> 例如:如果设置了单聊会话为聚合,则通过该方法可以打开包含所有的单聊会话的列表。
*
* @param context 应用上下文。
* @param conversationType 会话类型。
*/
public void startSubConversationList(Context context, Conversation.ConversationType conversationType)
当您的应用处于后台运行或者和融云服务器 disconnect() 的时候,如果收到消息,融云 SDK 会以通知形式提醒您。所以您还需要自定义一个继承融云 PushMessageReceiver 的广播接收器,用来接收提醒通知。如图:
public class SealNotificationReceiver extends PushMessageReceiver {
@Override
public boolean onNotificationMessageArrived(Context context, PushNotificationMessage message) {
return false; // 返回 false, 会弹出融云 SDK 默认通知; 返回 true, 融云 SDK 不会弹通知, 通知需要由您自定义。
}
@Override
public boolean onNotificationMessageClicked(Context context, PushNotificationMessage message) {
return false; // 返回 false, 会走融云 SDK 默认处理逻辑, 即点击该通知会打开会话列表或会话界面; 返回 true, 则由您自定义处理逻辑。
}
}
在 AndroidMainfest.xml 中静态注册
示例代码:
<receiver
android:name=".SealNotificationReceiver"
android:exported="true">
<intent-filter>
<action android:name="io.rong.push.intent.MESSAGE_ARRIVED" />
<action android:name="io.rong.push.intent.MESSAGE_CLICKED" />
<action android:name="io.rong.push.intent.THIRD_PARTY_PUSH_STATE" />
</intent-filter>
</receiver>
具体可参考文档。
融云 SDK 提供以下两种断开连接的方法:
如果您想在断开和融云的连接后,有新消息时,仍然能够收到推送通知,调用 disconnect() 方法。
/**
* <p>断开与融云服务器的连接。当调用此接口断开连接后,仍然可以接收 Push 消息。</p>
* <p>若想断开连接后不接受 Push 消息,可以调用{@link #logout()}</p>
*/
public void disconnect()
如果断开连接后,有新消息时,不想收到任何推送通知,调用 logout() 方法。
/**
* <p>断开与融云服务器的连接,并且不再接收 Push 消息。</p>
* <p>若想断开连接后仍然接受 Push 消息,可以调用 {@link #disconnect()}</p>
*/
public void logout()
通过以上步骤,您即完成了融云 SDK 的集成。
如果您基于 IMKit SDK 进行开发,那在初始化 SDK 之后,请通过 RongIM.getInstance() 方法获取实例,然后调用相应的 api 方法。示例:
RongIM.getInstance().setOnReceiveMessageListener(new OnReceiveMessageListener())
注意
不要使用 RongIMClient 实例去调用相关接口,否则会导致 UI 显示异常。
设计原理说明:
融云认为,每一个设计良好且功能健全的 App 都应该能够在本地获取、缓存并更新用户信息。所以,融云不维护用户基本信息(用户 Id
、昵称
、头像
)。此外,App 提供用户信息也避免了由于缓存导致的用户信息更新不及时,App 中不同界面上的用户信息不统一(比如:一部分 App 从 App 服务器上获取并显示,一部分由融云服务器获取并显示),能够获得更好的用户体验。
融云提供了两种方式从 App 的数据源显示用户昵称和头像
。
1、设置用户信息提供者:
调用 RongIM.setUserInfoProvider
方法设置 UserInfoProvider
。用户信息提供者采用 Provider
模式,即您提供给融云的 IMKit 一个 UserInfoProvider
,当融云的 IMKit 需要使用用户信息的时候,调用您传入的 UserInfoProvider.getUserInfo
方法,向您获取用户信息。所以您在 UserInfoProvider.getUserInfo
方法中,需要根据传入的 userId 参数,向我们返回对应的用户信息。
/**
* 设置用户信息的提供者,供 RongIM 调用获取用户名称和头像信息。
*
* @param userInfoProvider 用户信息提供者。
* @param isCacheUserInfo 设置是否由 IMKit 来缓存用户信息。<br>
* 如果 App 提供的 UserInfoProvider
* 每次都需要通过网络请求用户数据,而不是将用户数据缓存到本地内存,会影响用户信息的加载速度;<br>
* 此时最好将本参数设置为 true,由 IMKit 将用户信息缓存到本地内存中。
* @see UserInfoProvider
*/
RongIM.setUserInfoProvider(new RongIM.UserInfoProvider() {
@Override
public UserInfo getUserInfo(String userId) {
return findUserById(userId);//根据 userId 去你的用户系统里查询对应的用户信息返回给融云 SDK。
}
}, true);
很多时候 getUserInfo 这个方法会去 App 服务器异步获取用户信息,不能实时返回用户信息。这种情况下,请在成功获取到用户信息的异步回调中使用下面方法来刷新信息。
刷新用户信息:
/**
* 刷新用户缓存数据。
*
* @param userInfo 需要更新的用户缓存数据。
*/
RongIM.getInstance().refreshUserInfoCache(new UserInfo("userId", "啊明", Uri.parse("http://rongcloud-web.qiniudn.com/docs_demo_rongcloud_logo.png")));
刷新群组信息
/**
* 刷新群组缓存数据。
*
* @param group 需要更新的群组缓存数据。
*/
public void refreshGroupInfoCache(Group group)
2、使用消息携带用户信息
当 App 本身没有用户系统或者因为某些原因不方便使用上述用户信息提供者的时候,可以使用消息携带用户信息来发送给消息接收方。
请注意这种方式不要和用户信息提供者混用。并且,这种方式会在每条发送的消息里都携带当前登陆用户的信息,增加消息的长度。
首先,需要使用 setCurrentUserInfo
方法来设置当前的用户信息。
/**
* 设置当前用户信息,
*
* @param userInfo 当前用户信息
*/
RongIM.getInstance().setCurrentUserInfo(userInfo);
接下来,在 init
之后调用下面方法设置消息携带用户信息。
/**
* 设置消息体内是否携带用户信息。
*
* @param state 是否携带用户信息,true 携带,false 不携带。
*/
RongIM.getInstance().setMessageAttachedUserInfo(true);
接收方在接收到消息后,SDK 会自动从消息中取出用户信息,并显示到 UI 上。
常见问题:
以下视频主要讲解融云 IMKit
中用户信息的实现包括头像及昵称。
单聊是最基本的聊天界面,提供文字、表情、语音片段、图片、实时音视频等多种输入内容,解决 App 内用户的沟通瓶颈。会话关系由融云负责建立并保持,退出聊天界面或者离线后可以收到推送通知。
前提条件:
打开单聊窗口:
/**
* 启动单聊界面。
*
* @param context 应用上下文。
* @param targetUserId 要与之聊天的用户 Id。
* @param title 聊天的标题,开发者需要在聊天界面通过 intent.getData().getQueryParameter("title")
* 获取该值, 再手动设置为聊天界面的标题。
*/
RongIM.getInstance().startPrivateChat(getActivity(), "9527", "标题");
常见问题:
群组业务的描述,请参见新手指南中的说明。
群组信息与群成员信息是由 App 自己提供并进行维护管理,融云只是同步群组关系数据,并不保存群组的具体信息,融云会根据开发者同步的群组数据,计算群组的成员信息并群发消息。所以,当界面组件创建会话需要显示群组信息时,需要向 App 获取。App 需要设置一个群组信息提供者给 IMKit,以便 IMKit 读取好友关系。
前提条件:
启动群组聊天界面:
/**
* 启动群组聊天界面。
*
* @param context 应用上下文。
* @param targetGroupId 要聊天的群组 Id。
* @param title 聊天的标题,开发者可以在聊天界面通过 intent.getData().getQueryParameter("title") 获取该值, 再手动设置为标题。
*/
RongIM.getInstance().startGroupChat(getActivity(), "9527", "标题");
客户端的所有群组操作都需要请求您的 App Server, 您的 App Server 可以根据自己的逻辑进行管理和控制,然后通过 Server API 接口进行群组操作,并将结果返回给客户端。
详请见 Server API 群组服务接口。
以下展示了客户端进行群组操作的流程:
创建群组
加入群组
退出群组
解散群组
设置群组信息
获取群组成员列表
获取群组列表
聊天室业务的描述,请参见新手指南中的说明。
聊天室与群组最大的不同在于,聊天室的消息没有 Push 通知,也没有成员的概念。想参与聊天室聊天,接收聊天室消息,加入聊天室即可;不参与聊天室聊天,不接收消息,退出聊天室即可。IMKit 组件中已经内置了加入和退出聊天室的接口调用,您直接启动即可:
前提条件:
启动聊天室界面:
/**
* <p>启动聊天室会话。</p>
* <p>设置参数 createIfNotExist 为 true,对应到 kit 中调用的接口是
* {@link RongIMClient#joinChatRoom(String, int, RongIMClient.OperationCallback)}.
* 如果聊天室不存在,则自动创建并加入,如果回调失败,则弹出 warning。</p>
* <p>设置参数 createIfNotExist 为 false,对应到 kit 中调用的接口是
* {@link RongIMClient#joinExistChatRoom(String, int, RongIMClient.OperationCallback)}.
* 如果聊天室不存在,则返回错误 {@link io.rong.imlib.RongIMClient.ErrorCode#RC_CHATROOM_NOT_EXIST},并且会话界面会弹出 warning.
* </p>
*
* @param context 应用上下文。
* @param chatRoomId 聊天室 id。
* @param createIfNotExist 如果聊天室不存在,是否创建。
*/
public void startChatRoomChat(Context context, String chatRoomId, boolean createIfNotExist);
加入聊天室
加入聊天室,如果聊天室不存在,则创建聊天室并加入;如果已经存在,则直接加入。
/**
* 加入聊天室。
* <p>如果聊天室不存在,sdk 会创建聊天室并加入,如果已存在,则直接加入</p>
* <p>加入聊天室时,可以选择拉取聊天室消息数目。</p>
*
* @param chatroomId 聊天室 Id。
* @param defMessageCount 进入聊天室拉取消息数目,-1 时不拉取任何消息,0 时拉取 10 条消息,最多只能拉取 50 条。
* @param callback 状态回调。
*/
public void joinChatRoom(final String chatroomId, final int defMessageCount, final RongIMClient.OperationCallback callback)
加入已经存在的聊天室
/**
* 加入已存在的聊天室。
* <p>如果聊天室不存在,则加入失败</p>
* <p>加入聊天室时,可以选择拉取聊天室消息数目。</p>
*
* @param chatroomId 聊天室 Id。
* @param defMessageCount 进入聊天室拉取消息数目,-1 时不拉取任何消息,0 时拉取 10 条消息,最多只能拉取 50 条。
* @param callback 状态回调。
*/
public void joinExistChatRoom(final String chatroomId, final int defMessageCount, final RongIMClient.OperationCallback callback)
聊天室拉取消息数设置:
进入聊天室时默认拉取消息数为 10 条,根据需求可通过配置文件修改拉取消息条数,建议拉取消息数不超过 50 条,请在 res/values/rc_config.xml 文件中修改,为 -1 表示不获取任何历史消息,0 表示不特殊设置而使用 SDK 默认的设置(默认为获取10条),最大值为50。 xml 文件如下:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<integer name="rc_chatroom_first_pull_message_count">10</integer>
</resources>
前提条件:
打开系统会话聊天界面:
/**
* 启动系统会话聊天界面。
*
* @param context 应用上下文。
* @param conversationType 开启会话类型。
* @param targetId 目标 Id;
* @param title 聊天的标题,开发者可以在聊天界面通过 intent.getData().getQueryParameter("title") 获取该值, 再手动设置为标题。
*/
RongIM.getInstance().startConversation(getActivity(), Conversation.ConversationType.SYSTEM, "9527", "标题");
详细请参见客服集成文档。
融云公众服务
是为应用开发者和公众帐号运营者提供的连接服务产品,通过融云公众服务,App 可以具备为自己的用户提供公众帐号服务的能力和资源。
公众服务包括
:应用公众服务
和公众服务平台
。
应用公众服务
:是为应用开发者提供的 App 内建公众服务能力,通过在融云开发者站点创建 App 公众号,实现应用内的公众服务。
公众服务平台
:是在应用开发者和公众帐号运营者之间建立的对接平台,应用开发者可以通过平台引入公众服务资源,帮助 App 快速覆盖用户需求,公众帐号持有者通过平台可以有机会向所有集成融云 SDK 的 App 提供服务,进而获得更加精准更加丰富的受众渠道。
开发者可在 融云开发者平台 的公众服务模块中,通过添加公众服务
或应用公众服务
中的公众号到自己的应用中。
IMKit
组件中已经内置了订阅和取消订阅公众号的接口调用,您直接启动即可:
前提条件:
打开应用公众服务会话界面:
/**
* 启动应用公众服务会话界面。
*
* @param context 应用上下文。
* @param conversationType 开启会话类型。
* @param targetId 目标 Id。
* @param title 聊天的标题,开发者可以在聊天界面通过 intent.getData().getQueryParameter("title") 获取该值, 再手动设置为标题。
*/
RongIM.getInstance().startConversation(getActivity(), Conversation.ConversationType.APP_PUBLIC_SERVICE, "9527", "公众帐号标题");
打开公众服务号会话界面:
/**
* 启动公众服务号会话界面。
*
* @param context 应用上下文。
* @param conversationType 开启会话类型。
* @param targetId 目标 Id。
* @param title 聊天的标题,开发者可以在聊天界面通过 intent.getData().getQueryParameter("title") 获取该值, 再手动设置为标题。
*/
RongIM.getInstance().startConversation(getActivity(), Conversation.ConversationType.PUBLIC_SERVICE, "9527", "公众帐号标题");
打开应用公众服务信息界面:
/**
* 启动应用公众服务信息界面。
*
* @param context 应用上下文。
* @param conversationType 会话类型。
* @param targetId 目标 Id。
*/
RongIM.getInstance().startPublicServiceProfile(getActivity(), Conversation.ConversationType.APP_PUBLIC_SERVICE, "9527");
打开公共服务号信息界面:
/**
* 启动公共服务号信息界面。
*
* @param context 应用上下文。
* @param conversationType 会话类型。
* @param targetId 目标 Id。
*/
RongIM.getInstance().startPublicServiceProfile(getActivity(), Conversation.ConversationType.PUBLIC_SERVICE, "9527");
搜索公众号
通过 searchPublicService
或 searchPublicServiceByType
方法搜索已经添加的公众号列表,可以按关键字精确匹配或模糊匹配方式进行搜索。
/**
* 搜索全部公众服务。
*
* @param searchType 搜索类型枚举。
* @param keywords 搜索关键字。
*/
RongIM.getInstance().searchPublicService(RongIMClient.SearchType.EXACT, keywords, new RongIMClient.SearchPublicServiceCallback() {
@Override
public void onError(RongIMClient.ErrorCode e) {
//错误回调处理
}
@Override
public void onSuccess(PublicServiceProfileList publicServiceProfileList) {
//成功回调处理
}
});
/**
* 按公众服务类型搜索公众服务。
*
* @param conversationType 会话类型。
* @param searchType 搜索类型枚举。
* @param keywords 搜索关键字。
*/
RongIM.getInstance().searchPublicServicebyType(Conversation.PublicServiceType.PUBLIC_SERVICE, RongIMClient.SearchType.EXACT, keywords, new RongIMClient.SearchPublicServiceCallback() {
@Override
public void onError(RongIMClient.ErrorCode e) {
//错误回调处理
}
@Override
public void onSuccess(PublicServiceProfileList publicServiceProfileList) {
//成功回调处理
}
});
获取己关注公共账号列表:
在应用中需要展示已关注公共账号列表时,可通过 getPublicServiceList
方法获取己关注公共账号列表信息。
RongIM.getInstance().getPublicServiceList(new RongIMClient.SearchPublicServiceCallback() {
@Override
public void onSuccess(PublicServiceProfileList publicServiceProfileList) {
//成功回调处理
}
@Override
public void onError(RongIMClient.ErrorCode e) {
//错误回调处理
}
});
获取某公众号信息
/**
* 按公众服务类型搜索公众服务。
*
* @param publicServiceType 公众服务类型。
* @param publicServiceId 公众号 Id。
*/
RongIM.getInstance().getPublicServiceProfile(Conversation.PublicServiceType.PUBLIC_SERVICE, publicServiceId, new RongIMClient.ResultCallback<PublicServiceProfile>() {
@Override
public void onSuccess(PublicServiceProfile profile) {
//成功后返回公众号信息
}
@Override
public void onError(RongIMClient.ErrorCode e) {
//错误回调处理
}
});
保存草稿至某一会话
/**
* 根据消息类型,targetId 保存某一会话的文字消息草稿。用于暂存用户输入但未发送的消息。
*
* @param conversationType 会话类型。
* @param targetId 目标 Id。根据不同的 conversationType,可能是用户 Id、群组 Id 或聊天室 Id。
* @param content 草稿的文字内容。
* @param callback 是否保存成功的回调。
*/
public void saveTextMessageDraft(Conversation.ConversationType conversationType, String targetId, final String content, final ResultCallback<Boolean> callback)
获取某会话里的草稿信息
/**
* 根据消息类型,targetId 获取某一会话的文字消息草稿。用于获取用户输入但未发送的暂存消息。
*
* @param conversationType 会话类型。
* @param targetId 目标 Id。根据不同的 conversationType,可能是用户 Id、群组 Id 或聊天室 Id。
* @param callback 获取草稿文字内容的回调。
*/
public void getTextMessageDraft(final Conversation.ConversationType conversationType, final String targetId, final ResultCallback<String> callback)
注:这些草稿信息仅存储于本地数据库中,不会上传服务器。
发送文本消息如下:
// 构造 TextMessage 实例
TextMessage myTextMessage = TextMessage.obtain("我是消息内容");
/* 生成 Message 对象。
* "7127" 为目标 Id。根据不同的 conversationType,可能是用户 Id、群组 Id 或聊天室 Id。
* Conversation.ConversationType.PRIVATE 为私聊会话类型,根据需要,也可以传入其它会话类型,如群组。
*/
Message myMessage = Message.obtain("7127", Conversation.ConversationType.PRIVATE, myTextMessage);
/**
* <p>发送消息。
* 通过 {@link io.rong.imlib.IRongCallback.ISendMessageCallback}
* 中的方法回调发送的消息状态及消息体。</p>
*
* @param message 将要发送的消息体。
* @param pushContent 当下发 push 消息时,在通知栏里会显示这个字段。
* 如果发送的是自定义消息,该字段必须填写,否则无法收到 push 消息。
* 如果发送 sdk 中默认的消息类型,例如 RC:TxtMsg, RC:VcMsg, RC:ImgMsg,则不需要填写,默认已经指定。
* @param pushData push 附加信息。如果设置该字段,用户在收到 push 消息时,能通过 {@link io.rong.push.notification.PushNotificationMessage#getPushData()} 方法获取。
* @param callback 发送消息的回调,参考 {@link io.rong.imlib.IRongCallback.ISendMessageCallback}。
*/
RongIM.getInstance().sendMessage(myMessage, null, null, new IRongCallback.ISendMessageCallback() {
@Override
public void onAttached(Message message) {
//消息本地数据库存储成功的回调
}
@Override
public void onSuccess(Message message) {
//消息通过网络发送成功的回调
}
@Override
public void onError(Message message, RongIMClient.ErrorCode errorCode) {
//消息发送失败的回调
}
});
构造位置消息:
/**
* 生成LocationMessage对象。
*
* @param lat 纬度。
* @param lng 经度。
* @param poi poi信息。
* @param imgUri 地图缩率图地址。
* @return LocationMessage实例对象。
*/
public static LocationMessage obtain(double lat, double lng, String poi, Uri imgUri)
根据位置消息生成 Message 实例,如下:
LocationMessage locationMessage = LocationMessage.obtain(lat, lng, poi, thumb);
io.rong.imlib.model.Message message = io.rong.imlib.model.Message.obtain(mTargetId, mConversationType, locationMessage);
发送位置消息:
/**
* <p>发送地理位置消息。并同时更新界面。</p>
* <p>发送前构造 {@link Message} 消息实体,消息实体中的 content 必须为 {@link LocationMessage}, 否则返回失败。</p>
* <p>其中的缩略图地址 scheme 只支持 file:// 和 http:// 其他暂不支持。</p>
*
* @param message 消息实体。
* @param pushContent 当下发 push 消息时,在通知栏里会显示这个字段。
* 如果发送的是自定义消息,该字段必须填写,否则无法收到 push 消息。
* 如果发送 sdk 中默认的消息类型,例如 RC:TxtMsg, RC:VcMsg, RC:ImgMsg,则不需要填写,默认已经指定。
* @param pushData push 附加信息。如果设置该字段,用户在收到 push 消息时,能通过 {@link io.rong.push.notification.PushNotificationMessage#getPushData()} 方法获取。
* @param sendMessageCallback 发送消息的回调,参考 {@link io.rong.imlib.IRongCallback.ISendMessageCallback}。
*/
public void sendLocationMessage(Message message, String pushContent, final String pushData, final IRongCallback.ISendMessageCallback sendMessageCallback)
融云 SDK 默认使用的是高德地图,您也可以基于其它第三方实现位置功能,请参考基于百度地图实现融云 SDK 文档。
默认图片消息发送
获取 ImageMessage 实例
/**
* 生成ImageMessage对象。
*
* @param thumUri 缩略图地址。
* @param localUri 大图地址。
* @param isFull 是否发送原图。
* @return ImageMessage对象实例。
*/
public static ImageMessage obtain(Uri thumUri, Uri localUri, boolean isFull)
发送图片消息
/**
* <p>根据会话类型,发送图片消息。</p>
*
* @param type 会话类型。
* @param targetId 目标 Id。根据不同的 conversationType,可能是用户 Id、群组 Id 或聊天室 Id。
* @param content 消息内容,例如 {@link TextMessage}, {@link ImageMessage}。
* @param pushContent 当下发 push 消息时,在通知栏里会显示这个字段。
* 如果发送的是自定义消息,该字段必须填写,否则无法收到 push 消息。
* 如果发送 sdk 中默认的消息类型,例如 RC:TxtMsg, RC:VcMsg, RC:ImgMsg,则不需要填写,默认已经指定。
* @param pushData push 附加信息。如果设置该字段,用户在收到 push 消息时,能通过 {@link io.rong.push.notification.PushNotificationMessage#getPushData()} 方法获取。
* @param callback 发送消息的回调。
*/
RongIM.getInstance().sendImageMessage(Conversation.ConversationType.PRIVATE, "9517", imgMsg, null, null, new RongIMClient.SendImageMessageCallback() {
@Override
public void onAttached(Message message) {
//保存数据库成功
}
@Override
public void onError(Message message, RongIMClient.ErrorCode code) {
//发送失败
}
@Override
public void onSuccess(Message message) {
//发送成功
}
@Override
public void onProgress(Message message, int progress) {
//发送进度
}
});
content
中,大图首先上传到文件服务器,然后将云存储上的大图地址放入消息体中。存储有效期为 6 个月
,不支持文件迁移。
发送图片消息并且上传到自己的服务器
构造消息实例
ImageMessage imageMessage = ImageMessage.obtain(thumbPathUri, localPathUri);
Message message = Message.obtain(targetId, conversationType, imageMessage);
调用下面的方法发送图片消息
/**
* <p>发送图片消息,可以使用该方法将图片上传到自己的服务器发送,同时更新图片状态。</p>
* <p>使用该方法在上传图片时,会回调 {@link io.rong.imlib.RongIMClient.SendImageMessageWithUploadListenerCallback}
* 此回调中会携带 {@link RongIMClient.UploadImageStatusListener} 对象,使用者只需要调用其中的
* {@link RongIMClient.UploadImageStatusListener#update(int)} 更新进度
* {@link RongIMClient.UploadImageStatusListener#success(Uri)} 更新成功状态,并告知上传成功后的图片地址
* {@link RongIMClient.UploadImageStatusListener#error()} 更新失败状态 </p>
*
* @param message 发送消息的实体。
* @param pushContent 当下发 push 消息时,在通知栏里会显示这个字段。
* 如果发送的是自定义消息,该字段必须填写,否则无法收到 push 消息。
* 如果发送 sdk 中默认的消息类型,例如 RC:TxtMsg, RC:VcMsg, RC:ImgMsg,则不需要填写,默认已经指定。
* @param pushData push 附加信息。如果设置该字段,用户在收到 push 消息时,能通过 {@link io.rong.push.notification.PushNotificationMessage#getPushData()} 方法获取。
* @param callback 发送消息的回调,回调中携带 {@link RongIMClient.UploadImageStatusListener} 对象,用户调用该对象中的方法更新状态。
* {@link #sendImageMessage(Message, String, String, RongIMClient.SendImageMessageCallback)}
*/
RongIM.getInstance().sendImageMessage(message, pushContent, pushData, new RongIMClient.SendImageMessageWithUploadListenerCallback() {
@Override
public void onAttached(Message message, final RongIMClient.UploadImageStatusListener uploadImageStatusListener) {
/*上传图片到自己的服务器*/
uploadImg(imgMsg.getPicFilePath(), new UploadListener() {
@Override
public void onSuccess(String url) {
// 上传成功,回调 SDK 的 success 方法,传递回图片的远端地址
uploadImageStatusListener.success(Uri.parse(url));
}
@Override
public void onProgress(float progress) {
//刷新上传进度
uploadImageStatusListener.update((int) progress);
}
@Override
public void onFail() {
// 上传图片失败,回调 error 方法。
uploadImageStatusListener.error();
}
});
}
@Override
public void onError(Message message, RongIMClient.ErrorCode errorCode) {
//发送失败
}
@Override
public void onSuccess(Message message) {
//发送成功
}
@Override
public void onProgress(Message message, int progress) {
//发送进度
}
});
图片缩略图机制:
缩略图尺寸为:240 x 240 像素,以宽度和高度中较长的边不超过 240 像素等比压缩。
大图尺寸为:960 x 960 像素,以宽度和高度中较长的边不超过 960 像素等比压缩。
基本原理:录制语音,本地存储转换为 AMR 格式,获取语音时长,构造语音消息并发送。
/**
* 获取语音消息实体。
*
* @param Uri 语音 Uri 。
* @param duration 语音时长(单位:秒)。
*/
VoiceMessage vocMsg = VoiceMessage.obtain(Uri.fromFile(voiceFile), 10);
/**
* <p>发送消息。
* 通过 {@link io.rong.imlib.IRongCallback.ISendMessageCallback}
* 中的方法回调发送的消息状态及消息体。</p>
*
* @param message 将要发送的消息体。
* @param pushContent 当下发 push 消息时,在通知栏里会显示这个字段。
* 如果发送的是自定义消息,该字段必须填写,否则无法收到 push 消息。
* 如果发送 sdk 中默认的消息类型,例如 RC:TxtMsg, RC:VcMsg, RC:ImgMsg,则不需要填写,默认已经指定。
* @param pushData push 附加信息。如果设置该字段,用户在收到 push 消息时,能通过 {@link io.rong.push.notification.PushNotificationMessage#getPushData()} 方法获取。
* @param callback 发送消息的回调,参考 {@link io.rong.imlib.IRongCallback.ISendMessageCallback}。
*/
RongIM.getInstance().sendMessage(myMessage, null, null, new IRongCallback.ISendMessageCallback() {
@Override
public void onAttached(Message message) {
//消息本地数据库存储成功的回调
}
@Override
public void onSuccess(Message message) {
//消息通过网络发送成功的回调
}
@Override
public void onError(Message message, RongIMClient.ErrorCode errorCode) {
//消息发送失败的回调
}
});
消息定义:
高质量语音消息 HQVoiceMessage
和旧版本语音消息 VoiceMessage
不同的是将录制的音频数据存储到服务端,而消息体内只保存 URL。摆脱了消息体 128K 的大小限制,所以拥有更高音质。
接口说明:
1、通过以下接口可以设置发送高质量语音消息还是普通的语音消息,默认为普通语音消息。
**
* 设置语音消息类型,必须在 connect()之前调用
* @param voiceMessageType 消息类型{@link VoiceMessageType}
*/
public void setVoiceMessageType(VoiceMessageType voiceMessageType) {
this.voiceMessageType = voiceMessageType;
}
2、通过 rc_config 配置文件设置以下内容可以控制用户在线时,收到高质量语音消息后是否自动下载,默认为自动下载,设置为 false 时,只有在打开会话界面情况下才自动下载当前会话的语音消息文件。
<!--在线时是否自动下载高质量语音消息-->
<bool name="rc_enable_automatic_download_voice_msg">true</bool>
集成步骤:
在程序启动时调用以下方式即可,需要注意必须在 connect()之前调用。
public void setVoiceMessageType(VoiceMessageType voiceMessageType)
生成图文消息实例:
/**
* 生成RichContentMessage对象。
*
* @param title 消息标题。
* @param content 消息内容。
* @param imageUrl 消息图片url.
* @return 生成RichContentMessage对象。
*/
public static RichContentMessage obtain(String title, String content, String imageUrl)
发送消息
RichContentMessage richContentMessage = RichContentMessage.obtain("标题", "内容", "http://rongcloud.cn/images/logo.png");
//"9517" 为目标 Id。根据不同的 conversationType,可能是用户 Id、群组 Id 或聊天室 Id。
//Conversation.ConversationType.PRIVATE 为会话类型。
Message myMessage = Message.obtain("9517", Conversation.ConversationType.PRIVATE, richContentMessage);
/**
* <p>发送消息。
* 通过 {@link io.rong.imlib.IRongCallback.ISendMessageCallback}
* 中的方法回调发送的消息状态及消息体。</p>
*
* @param message 将要发送的消息体。
* @param pushContent 当下发 push 消息时,在通知栏里会显示这个字段。
* 如果发送的是自定义消息,该字段必须填写,否则无法收到 push 消息。
* 如果发送 sdk 中默认的消息类型,例如 RC:TxtMsg, RC:VcMsg, RC:ImgMsg,则不需要填写,默认已经指定。
* @param pushData push 附加信息。如果设置该字段,用户在收到 push 消息时,能通过 {@link io.rong.push.notification.PushNotificationMessage#getPushData()} 方法获取。
* @param callback 发送消息的回调,参考 {@link io.rong.imlib.IRongCallback.ISendMessageCallback}。
*/
RongIM.getInstance().sendMessage(myMessage, null, null, new IRongCallback.ISendMessageCallback() {
@Override
public void onAttached(Message message) {
//消息本地数据库存储成功的回调
}
@Override
public void onSuccess(Message message) {
//消息通过网络发送成功的回调
}
@Override
public void onError(Message message, RongIMClient.ErrorCode errorCode) {
//消息发送失败的回调
}
});
融云 SDK 默认支持文件发送功能,点击查看文件消息产品介绍。
存储有效期为 6 个月
,不支持文件迁移。
1. 自定义文件保存位置
接受到文件消息,并点击下载后,该文件默认保存在 SD 卡的 /RongCloud/Media/
下。
您可以通过更改 SDK 的 res/values/rc_configuration.xml
里面的 rc_media_message_default_save_path
的值,来自定义文件的存储路径。
2. 文件消息相关功能说明
发送文件消息:
/**
* <p>发送多媒体消息</p>
* <p>发送前构造 {@link Message} 消息实体</p>
* @param message 发送消息的实体。
* @param pushContent 当下发 push 消息时,在通知栏里会显示这个字段。
* 发送文件消息时,此字段必须填写,否则会收不到 push 推送。
* @param pushData push 附加信息。如果设置该字段,用户在收到 push 消息时,能通过 {@link io.rong.push.notification.PushNotificationMessage#getPushData()} 方法获取。
* @param callback 发送消息的回调 {@link io.rong.imlib.RongIMClient.SendMediaMessageCallback}。
*/
public void sendMediaMessage(Message message, String pushContent, final String pushData, final IRongCallback.ISendMediaMessageCallback callback)
下载文件消息:
/**
* 下载多媒体消息。
* 用来获取媒体原文件时调用。如果本地缓存中包含此文件,则从本地缓存中直接获取,否则将从服务器端下载。
*
* @param message 文件消息。
* @param callback 下载文件的回调。
*/
public void downloadMediaMessage(Message message, final IRongCallback.IDownloadMediaMessageCallback callback)
取消文件下载:
/**
* 取消多媒体消息下载。
* @param message 包含多媒体文件的消息,
* @param callback 取消下载多媒体文件时的回调。
* */
public void cancelDownloadMediaMessage(Message message, RongIMClient.OperationCallback callback)
如果您使用的是 IMLib SDK 集成,可参考 IMLib 文件消息文档。
融云推送服务及集成第三方推送服务,详细请查看推送服务开发指南。
注意:部分 Android 手机系统在黑屏待机后自动清理后台运行的软件,这样影响了应用正常接收新的消息,需要将应用设置为后台运行应用。查看各类机型的设置说明。
设置自己发出消息的监听器,在 init() 之后即可设置。
注意:如果在 Activity 里设置,需要在 Activity 销毁时,将监听设置为 null,防止内存泄露。
/**
* 设置发送消息的监听。
*
* @param listener 发送消息的监听。
*/
public void setSendMessageListener(OnSendMessageListener listener)
设置后实现消息发送监听接口 OnSendMessageListener
,消息发送失败可在 onSent
方法中根据 SentMessageErrorCode
返回的状态码实现自己的逻辑处理。onSent
返回 true
表示走自己的处理方式,否则走融云默认处理方式。
RongIM.getInstance().setSendMessageListener(new MySendMessageListener());
private class MySendMessageListener implements RongIM.OnSendMessageListener {
/**
* 消息发送前监听器处理接口(是否发送成功可以从 SentStatus 属性获取)。
*
* @param message 发送的消息实例。
* @return 处理后的消息实例。
*/
@Override
public Message onSend(Message message) {
//开发者根据自己需求自行处理逻辑
return message;
}
/**
* 消息在 UI 展示后执行/自己的消息发出后执行,无论成功或失败。
*
* @param message 消息实例。
* @param sentMessageErrorCode 发送消息失败的状态码,消息发送成功 SentMessageErrorCode 为 null。
* @return true 表示走自己的处理方式,false 走融云默认处理方式。
*/
@Override
public boolean onSent(Message message,RongIM.SentMessageErrorCode sentMessageErrorCode) {
if(message.getSentStatus()== Message.SentStatus.FAILED){
if(sentMessageErrorCode== RongIM.SentMessageErrorCode.NOT_IN_CHATROOM){
//不在聊天室
}else if(sentMessageErrorCode== RongIM.SentMessageErrorCode.NOT_IN_DISCUSSION){
//不在讨论组
}else if(sentMessageErrorCode== RongIM.SentMessageErrorCode.NOT_IN_GROUP){
//不在群组
}else if(sentMessageErrorCode== RongIM.SentMessageErrorCode.REJECTED_BY_BLACKLIST){
//你在他的黑名单中
}
}
MessageContent messageContent = message.getContent();
if (messageContent instanceof TextMessage) {//文本消息
TextMessage textMessage = (TextMessage) messageContent;
Log.d(TAG, "onSent-TextMessage:" + textMessage.getContent());
} else if (messageContent instanceof ImageMessage) {//图片消息
ImageMessage imageMessage = (ImageMessage) messageContent;
Log.d(TAG, "onSent-ImageMessage:" + imageMessage.getRemoteUri());
} else if (messageContent instanceof VoiceMessage) {//语音消息
VoiceMessage voiceMessage = (VoiceMessage) messageContent;
Log.d(TAG, "onSent-voiceMessage:" + voiceMessage.getUri().toString());
} else if (messageContent instanceof RichContentMessage) {//图文消息
RichContentMessage richContentMessage = (RichContentMessage) messageContent;
Log.d(TAG, "onSent-RichContentMessage:" + richContentMessage.getContent());
} else {
Log.d(TAG, "onSent-其他消息,自己来判断处理");
}
return false;
}
}
接收消息的监听器,在 init() 之后即可设置。注意,建议设置在 Application 里面,这样才能在整个应用的生命周期,都能监听到接收消息事件。
/**
* 设置接收消息的监听器。
* <p/>
* 所有接收到的消息、通知、状态都经由此处设置的监听器处理。包括私聊消息、群组消息、聊天室消息以及各种状态。
*
* @param listener 接收消息的监听器。
*/
public static void setOnReceiveMessageListener(RongIMClient.OnReceiveMessageListener listener)
接收消息监听器的实现,所有接收到的消息、通知、状态都经由此处设置的监听器处理。包括私聊消息、群组消息、聊天室消息以及各种状态。
RongIM.setOnReceiveMessageListener(new MyReceiveMessageListener());
private class MyReceiveMessageListener implements RongIMClient.OnReceiveMessageListener {
/**
* 收到消息的处理。
*
* @param message 收到的消息实体。
* @param left 剩余未拉取消息数目。
* @return 收到消息是否处理完成,true 表示自己处理铃声和后台通知,false 走融云默认处理方式。
*/
@Override
public boolean onReceived(Message message, int left) {
//开发者根据自己需求自行处理
return false;
}
}
您可以在自定义的继承融云 PushMessageReceiver 的广播接收器里面监听到 push 事件。
public class SealNotificationReceiver extends PushMessageReceiver {
/* push 通知到达事件*/
@Override
public boolean onNotificationMessageArrived(Context context, PushNotificationMessage message) {
return false; // 返回 false, 会弹出融云 SDK 默认通知; 返回 true, 融云 SDK 不会弹通知, 通知需要由您自定义。
}
/* push 通知点击事件 */
@Override
public boolean onNotificationMessageClicked(Context context, PushNotificationMessage message) {
return false; // 返回 false, 会走融云 SDK 默认处理逻辑, 即点击该通知会打开会话列表或会话界面; 返回 true, 则由您自定义处理逻辑。
}
}
关于融云推送的详细机制和功能,您可以参考推送服务开发指南。
设置连接状态监听,必须在 init
后进行调用。 注意:建议设置在 Application 里面,这样才能在整个应用的生命周期,都能监听到状态变化。
/**
* 设置连接状态变化的监听器。
*
* @param listener 连接状态变化的监听器。
*/
public static void setConnectionStatusListener(final RongIMClient.ConnectionStatusListener listener)
实现连接状态监听器,以获取当前连接相关状态。
RongIM.setConnectionStatusListener(new MyConnectionStatusListener());
private class MyConnectionStatusListener implements RongIMClient.ConnectionStatusListener {
@Override
public void onChanged(ConnectionStatus connectionStatus) {
switch (connectionStatus){
case CONNECTED://连接成功。
break;
case DISCONNECTED://断开连接。
break;
case CONNECTING://连接中。
break;
case NETWORK_UNAVAILABLE://网络不可用。
break;
case KICKED_OFFLINE_BY_OTHER_CLIENT://用户账户在其他设备登录,本机会被踢掉线
break;
}
}
}
会话列表操作监听,在调用 init
之后即可进行设置。
/**
* 设置会话列表界面操作的监听器。
*/
RongIM.setConversationListBehaviorListener(new MyConversationListBehaviorListener());
实现会话列表操作监听接口 ConversationListBehaviorListener
。
private class MyConversationListBehaviorListener implements RongIM.ConversationListBehaviorListener{
/**
* 当点击会话头像后执行。
*
* @param context 上下文。
* @param conversationType 会话类型。
* @param targetId 被点击的用户id。
* @return 如果用户自己处理了点击后的逻辑处理,则返回 true,否则返回 false,false 走融云默认处理方式。
*/
boolean onConversationPortraitClick(Context context, Conversation.ConversationType conversationType, String targetId){
}
/**
* 当长按会话头像后执行。
*
* @param context 上下文。
* @param conversationType 会话类型。
* @param targetId 被点击的用户id。
* @return 如果用户自己处理了点击后的逻辑处理,则返回 true,否则返回 false,false 走融云默认处理方式。
*/
boolean onConversationPortraitLongClick(Context context, Conversation.ConversationType conversationType, String targetId){
return false;
}
/**
* 长按会话列表中的 item 时执行。
*
* @param context 上下文。
* @param view 触发点击的 View。
* @param uiConversation 长按时的会话条目。
* @return 如果用户自己处理了长按会话后的逻辑处理,则返回 true, 否则返回 false,false 走融云默认处理方式。
*/
@Override
public boolean onConversationLongClick(Context context, View view, UIConversation uiConversation) {
return false;
}
/**
* 点击会话列表中的 item 时执行。
*
* @param context 上下文。
* @param view 触发点击的 View。
* @param uiConversation 会话条目。
* @return 如果用户自己处理了点击会话后的逻辑处理,则返回 true, 否则返回 false,false 走融云默认处理方式。
*/
@Override
public boolean onConversationClick(Context context, View view, UIConversation uiConversation) {
return false;
}
}
会话界面操作的监听器,在调用 init 后即可进行设置
RongIM.getInstance().setConversationClickListener(new MyConversationClickListener());
实现会话界面操作的监听接口 ConversationClickListener 。会话界面中点击用户头像、长按用户头像、点击消息、长按消息、点击消息链接的操作都在此处理。
private class MyConversationClickListener implements RongIM.ConversationClickListener {
/**
* 当点击用户头像后执行。
*
* @param context 上下文。
* @param conversationType 会话类型。
* @param user 被点击的用户的信息。
* @param targetId 会话 id
* @return 如果用户自己处理了点击后的逻辑处理,则返回 true,否则返回 false,false 走融云默认处理方式。
*/
@Override
public boolean onUserPortraitClick(Context context, Conversation.ConversationType conversationType, UserInfo user, String targetId) {
return false;
}
/**
* 当长按用户头像后执行。
*
* @param context 上下文。
* @param conversationType 会话类型。
* @param user 被点击的用户的信息。
* @param targetId 会话 id
* @return 如果用户自己处理了点击后的逻辑处理,则返回 true,否则返回 false,false 走融云默认处理方式。
*/
@Override
public boolean onUserPortraitLongClick(Context context, Conversation.ConversationType conversationType, UserInfo user, String targetId) {
return false;
}
/**
* 当点击消息时执行。
*
* @param context 上下文。
* @param view 触发点击的 View。
* @param message 被点击的消息的实体信息。
* @return 如果用户自己处理了点击后的逻辑处理,则返回 true, 否则返回 false, false 走融云默认处理方式。
*/
@Override
public boolean onMessageClick(Context context, View view, Message message) {
return false;
}
/**
* 当点击链接消息时执行。
*
* @param context 上下文。
* @param link 被点击的链接。
* @param message 被点击的消息的实体信息
* @return 如果用户自己处理了点击后的逻辑处理,则返回 true, 否则返回 false, false 走融云默认处理方式。
*/
@Override
public boolean onMessageLinkClick(Context context, String link, Message message) {
return false;
}
/**
* 当长按消息时执行。
*
* @param context 上下文。
* @param view 触发点击的 View。
* @param message 被长按的消息的实体信息。
* @return 如果用户自己处理了长按后的逻辑处理,则返回 true,否则返回 false,false 走融云默认处理方式。
*/
@Override
public boolean onMessageLongClick(Context context, View view, Message message) {
return false;
}
}
未读消息数监听器,必须在 init
之后即可调用。
/**
* 设置未读消息数变化监听器。
* 注意:如果是在 activity 中设置,那么要在 activity 销毁时,调用 {@link #removeUnReadMessageCountChangedObserver(IUnReadMessageObserver)}
* 否则会造成内存泄漏。
*
* @param observer 接收未读消息消息的监听器。
* @param conversationTypes 接收未读消息的会话类型。
*/
public void addUnReadMessageCountChangedObserver(final IUnReadMessageObserver observer, Conversation.ConversationType... conversationTypes)
}
Activity 销毁时,移除监听。
/**
* 注销已注册的未读消息数变化监听器。
*
* @param observer 接收未读消息消息的监听器。
*/
public void removeUnReadMessageCountChangedObserver(final IUnReadMessageObserver observer)
rc_fr_conversationlist.xml 会话列表布局文件
rc_item_conversation.xml 会话列表各个 item 对应的布局文件
可以通过修改这些布局文件修改背景或字体颜色等。
可以根据会话类型,限制会话列表只显示某几个类型的会话,以及这些会话是否以聚合形式显示。
下面以自定义会话列表只显示单聊和群组会话为例,说明如何自定义:
a. 配置 Uri
b. 把自定义的 Uri 赋值给 ConversationListFragment
listFragment.setUri(uri);
对于会话列表中每种会话类型的会话,开发者都可以自定义头像位置的显示方式,显示方式有:靠左显示、靠右显示、不显示。
自定义步骤:
1、新建一类继承要改变的会话提供者类,然后重写注解,修改 portraitPosition 的值以完成显示方式。
注解名称:ConversationProviderTag。属性:conversationType ,portraitPosition 。
conversationType 的值不能重复不可修改,它是会话提供者的唯一标识;portraitPosition 用来控制头像的显示方式,它的值可以修改,它的值有:1:靠左显示, 2:靠右显示, 3:不显示。
提供者名称 | 类名 | 注解 conversationType 值 (不可修改) |
注解 portraitPosition 初始值 (可修改) |
---|---|---|---|
二人会话提供者 | PrivateConversationProvider.java |
private | 1 |
群聊会话提供者 | GroupConversationProvider.java |
group | 1 |
客服会话提供者 | CustomerServiceConversationProvider.java |
customer_service | 1 |
系统会话提供者 | SystemConversationProvider.java |
system | 1 |
应用公众服务会话提供者 | AppServiceConversationProvider.java |
app_public_service | 1 |
公众服务平台会话提供者 | PublicServiceConversationProvider.java |
public_service | 1 |
2、重新注册该会话模板,注册方法应在 init 后调用
RongIM.getInstance().registerConversationTemplate;
自定义示例:
如何在会话列表中让所单聊会话头像都靠右显示?
第一步:
@ConversationProviderTag(conversationType = "private", portraitPosition = 2)
public class MyPrivateConversationProvider extends PrivateConversationProvider {
...
}
第二步:
RongIM.getInstance().registerConversationTemplate(new MyPrivateConversationProvider());
rc_fr_conversation.xml 会话页面布局
rc_item_message.xml 消息列表单个 item 对应的布局
您可以通过修改上述布局文件来更改字体大小颜色及背景色等。
融云 IMKit SDK 中每一种消息类型(要在 UI 展示的)都对应一个 UI 展示的 Provider,开发者可以修改 Provider 的注解属性来完成消息显示的自定义。
1、新建一类并继承要修改的消息提供者类,然后重写注解。
注解名称:ProviderTag。
注解属性:
属性 | 描述 |
---|---|
messageContent |
对应的消息类型 ( 如:TextMessage.class )。 |
showPortrait |
设置是否显示头像,默认为 true。 |
centerInHorizontal |
消息内容是否横向居中,默认 false。 |
hide |
是否隐藏消息, 默认 false。 |
showProgress |
是否显示发送进度,默认 true。 |
showSummaryWithName |
是否在会话的内容体里显示发送者名字,默认 true。 |
自定义示例:
如何在会话中让 TextMessage 不显示头像且消息内容横向居中显示?
第一步:
自定义 TextMessage 的展示模板
@ProviderTag ( messageContent = TextMessage.class , showPortrait = false , centerInHorizontal = true )
public class MyTextMessageItemProvider extends TextMessageItemProvider
{...}
第二步:
重新注册该消息模板,注册方法应在 init 后调用
RongIM.getInstance().registerMessageTemplate(new MyTextMessageItemProvider());
未读消息数目和新消息气泡在 IMKit 中默认不显示,如需要显示新消息提醒和未读消息数目可以在连接成功后通过下面方法设置。
RongIM.getInstance().enableNewComingMessageIcon(true);//显示新消息提醒
RongIM.getInstance().enableUnreadMessageIcon(true);//显示未读消息数目
新消息大于 1 条即展示,超过 99 条显示为 "99+",未读消息大于 10 条即展示,超过 150 条显示为 "150+条新消息"。另外,控件的样式可以在 layout/rc_fr_messagelist.xml
中进行调整。
可以通过自定义会话列表或者会话界面的适配器,来自定义界面的展示。
下面以自定义会话界面消息列表的适配器为例,说明如何自定义:
3.1 自定义会话 fragment 继承自 ConversationFragment,复写 onResolveAdapter() 方法,返回自定义的 adapter。
另外您的 activity 布局文件中也需要配置成自定义的 fragment。
3.2 自定义继承 MessageListAdapter 的消息列表适配器,根据需要复写其中的 newView() 或者 bindView() 方法
输入区域相关概念:
1、输入区域扩展栏对外接口类为 RongExtension。如图 1
2、Plugin 是开发者自定义 “+” 号区域展开后的 item,如图 1
3、EmoticonTab 是开发者自定义 表情 tab 页。如图 2
一、布局自定义
部分布局文件如下,您可以通过修改对应的布局文件来调整界面布局,修改背景,更改字体等。
1、rc_ext_extension_bar.xml 输入框布局文件。它是整个输入框的容器,内部有对各部分组件功能描述。
2、rc_ext_input_edit_text.xml EditText 布局文件。如果想要替换背景,直接修改即可。
3、rc_ext_voice_input.xml 语音输入布局文件。
4、输入框模式自定义。
另外,在会界面中可以设置输入框的模式。针对聊天会话的语音/文本切换功能、内容输入功能、扩展功能,融云目前提供了 5 种排列组合模式:
style | 组合模式 |
---|---|
SCE |
语音/文本切换功能+内容输入功能+扩展功能 |
SC |
语音/文本切换功能+内容输入功能 |
EC |
扩展功能+内容输入功能 |
CE |
内容输入功能+扩展功能 |
C |
内容输入功能 |
用户可以通过更改 rc_fr_conversation.xml
里 app:RCStyle="SCE"
,更改默认输入显示形式。
二、“+”号扩展区域自定义
SDK 里默认定义了如下 Plugin,各 Plugin 的功能说明如下:
名称 | 功能 |
---|---|
LocationPlugin | 位置信息组件,需要用户自己集成第三方地图实现定位 |
RealTimeLocationPlugin | 实时位置共享组件,内置了高德地图的界面,可直接使用 |
DefaultLocationPlugin | 位置信息组件,已经内置了高德地图,实现了定位功能,可直接使用 |
CombineLocationPlugin | 上面 DefaultLocationPlugin + RealTimeLocationPlugin 的综合组件 |
FilePlugin | 文件组件 |
ImagePlugin | 图片组件 |
自定义 Plugin
1、自定义 Plugin 并实现 IPluginModule。 如:
public class MyPlugin implements IPluginModule {
…
}
2、自定义一个 ExtensionModule 继承自 DefaultExtensionModule,复写其中的 getPluginModules() 方法,返回需要展示的 plugin 列表。如:
public class MyExtensionModule extends DefaultExtensionModule {
private MyPlugin myPlugin;
@Override
public List<IPluginModule> getPluginModules(Conversation.ConversationType conversationType) {
List<IPluginModule> pluginModules = super.getPluginModules(conversationType);
pluginModules.add(myPlugin);
return pluginModules;
}
}
3、在初始化之后,取消 SDK 默认的 ExtensionModule,注册自定义的 ExtensionModule, 如下:
public void setMyExtensionModule() {
List<IExtensionModule> moduleList = RongExtensionManager.getInstance().getExtensionModules();
IExtensionModule defaultModule = null;
if (moduleList != null) {
for (IExtensionModule module : moduleList) {
if (module instanceof DefaultExtensionModule) {
defaultModule = module;
break;
}
}
if (defaultModule != null) {
RongExtensionManager.getInstance().unregisterExtensionModule(defaultModule);
RongExtensionManager.getInstance().registerExtensionModule(new MyExtensionModule());
}
}
}
自定义 EmoticonTab
1、自定义 EmoticonTab 实现 IEmoticonTab。 如:
public class MyEmoticon implements IEmoticonTab {
…
}
2、自定义一个 ExtensionModule 继承自 DefaultExtensionModule,复写其中的 getEmoticonTabs() 方法,返回需要展示的 EmoticonTab 列表。如:
public class MyExtensionModule extends DefaultExtensionModule {
private MyEmoticon myEmoticon;
@Override
public List<IEmoticonTab> getEmoticonTabs() {
List<IEmoticonTab> emoticonTabs = super.getEmoticonTabs();
emoticonTabs.add(myEmoticon);
return emoticonTabs;
}
}
3、在初始化之后,取消 SDK 默认的 ExtensionModule,注册自定义的 ExtensionModule, 如下:
public void setMyExtensionModule() {
List<IExtensionModule> moduleList = RongExtensionManager.getInstance().getExtensionModules();
IExtensionModule defaultModule = null;
if (moduleList != null) {
for (IExtensionModule module : moduleList) {
if (module instanceof DefaultExtensionModule) {
defaultModule = module;
break;
}
}
if (defaultModule != null) {
RongExtensionManager.getInstance().unregisterExtensionModule(defaultModule);
RongExtensionManager.getInstance().registerExtensionModule(new MyExtensionModule());
}
}
}
三、输入区事件监听
自定义 fragment 继承 ConversationFragment, 即可获取或者复写 ConversationFragment 里的各个事件,如输入文本内容的变化,发送按钮或者语音按钮的点击事件等。
详细请参考融云 Android Extension 开发文档。
1、继承 MessageContent
新建一自定义消息类,继承 MessageContent 如下面示例代码:
public class CustomizeMessage extends MessageContent {
private String content;//消息属性,可随意定义
}
2、重写和实现方法
实现 encode()
方法,该方法的功能是将消息属性封装成 json
串,再将 json
串转成 byte
数组,该方法会在发消息时调用,如下面示例代码:
@Override
public byte[] encode() {
JSONObject jsonObj = new JSONObject();
try {
jsonObj.put("content", "这是一条消息内容");
} catch (JSONException e) {
Log.e("JSONException", e.getMessage());
}
try {
return jsonObj.toString().getBytes("UTF-8");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
return null;
}
覆盖父类的 MessageContent(byte[] data)
构造方法,该方法将对收到的消息进行解析,先由 byte
转成 json
字符串,再将 json
中内容取出赋值给消息属性。
public CustomizeMessage(byte[] data) {
String jsonStr = null;
try {
jsonStr = new String(data, "UTF-8");
} catch (UnsupportedEncodingException e1) {
}
try {
JSONObject jsonObj = new JSONObject(jsonStr);
if (jsonObj.has("content"))
content = jsonObj.optString("content");
} catch (JSONException e) {
RLog.e(this, "JSONException", e.getMessage());
}
}
MessageContent
已实现 Parcelable
接口,下面需要实现 Parcelable
中的方法:
//给消息赋值。
public CustomizeMessage(Parcel in) {
content=ParcelUtils.readFromParcel(in);//该类为工具类,消息属性
...
//这里可继续增加你消息的属性
}
/**
* 读取接口,目的是要从Parcel中构造一个实现了Parcelable的类的实例处理。
*/
public static final Creator<CustomizeMessage> CREATOR = new Creator<CustomizeMessage>() {
@Override
public CustomizeMessage createFromParcel(Parcel source) {
return new CustomizeMessage(source);
}
@Override
public CustomizeMessage[] newArray(int size) {
return new CustomizeMessage[size];
}
};
/**
* 描述了包含在 Parcelable 对象排列信息中的特殊对象的类型。
*
* @return 一个标志位,表明Parcelable对象特殊对象类型集合的排列。
*/
public int describeContents() {
return 0;
}
/**
* 将类的数据写入外部提供的 Parcel 中。
*
* @param dest 对象被写入的 Parcel。
* @param flags 对象如何被写入的附加标志。
*/
@Override
public void writeToParcel(Parcel dest, int flags) {
ParcelUtils.writeToParcel(dest, content);//该类为工具类,对消息中属性进行序列化
...
//这里可继续增加你消息的属性
}
3、增加注解信息
注解名:MessageTag ;属性:value ,flag; value 即 ObjectName 是消息的唯一标识不可以重复,开发者命名时不能以 RC 开头,避免和融云内置消息冲突;flag 是用来定义消息的可操作状态。
如下面代码段,自定义消息名称 CustomizeMessage
,vaule 是 app:custom
,flag 是 MessageTag.ISCOUNTED
| MessageTag.ISPERSISTED
表示消息计数且存库。
@MessageTag(value = "app:custom", flag = MessageTag.ISCOUNTED | MessageTag.ISPERSISTED)
public class CustomizeMessage extends MessageContent {
...
}
flag
值如下表:
枚举值 | 说明 |
---|---|
MessageTag.NONE |
为空值,不表示任何意义,发送的自定义消息不会在会话页面和会话列表中展示。 |
MessageTag.ISCOUNTED |
表示客户端收到消息后,要进行未读消息计数(未读消息数增加 1),所有内容型消息都应该设置此值。非内容类消息暂不支持消息计数。 |
MessageTag.ISPERSISTED |
表示客户端收到消息后,要进行存储,并在之后可以通过接口查询,存储后会在会话界面中显示。 |
MessageTag.STATUS |
在本地不存储,不计入未读数,并且如果对方不在线,服务器会直接丢弃该消息,对方如果之后再上线也不会再收到此消息(聊天室类型除外,此类消息聊天室会视为普通消息)。 |
4、注册自定义消息
自定义消息应在 init
后注册,代码如下:
RongIM.registerMessageType(CustomizeMessage.class);
自定义消息在会话列表和会话页面显示。
步骤:
1、创建消息提供者
新建一个消息类继承 IContainerItemProvider.MessageProvider
类,实现对应接口方法,接口方法如下表:
方法名 | 描述 | |
---|---|---|
newView |
初始化 View。 | |
bindView |
将数据填充 View 上。 | |
getContentSummary |
该条消息为该会话的最后一条消息时,会话列表要显示的内容,通过该方法进行定义。 | |
onItemClick |
点击该类型消息触发。 | |
onItemLongClick |
长按该类型消息触发。 |
代码片段如下:
@ProviderTag(messageContent = CustomizeMessage.class)
public class CustomizeMessageItemProvider extends IContainerItemProvider.MessageProvider<CustomizeMessage> {
class ViewHolder {
TextView message;
}
@Override
public View newView(Context context, ViewGroup group) {
View view = LayoutInflater.from(context).inflate(io.rong.imkit.R.layout.item_customize_message, null);
ViewHolder holder = new ViewHolder();
holder.message = (TextView) view.findViewById(android.R.id.text1);
view.setTag(holder);
return view;
}
@Override
public void bindView(View v, int position, CustomizeMessage content, Message message) {
ViewHolder holder = (ViewHolder) v.getTag();
if (message.getMessageDirection() == Message.MessageDirection.SEND) {//消息方向,自己发送的
holder.message.setBackgroundResource(io.rong.imkit.R.drawable.rc_ic_bubble_right);
} else {
holder.message.setBackgroundResource(io.rong.imkit.R.drawable.rc_ic_bubble_left);
}
holder.message.setText(content.getContent());
AndroidEmoji.ensure((Spannable) holder.message.getText());//显示消息中的 Emoji 表情。
}
@Override
public Spannable getContentSummary(CustomizeMessage data) {
return new SpannableString("这是一条自定义消息CustomizeMessage");
}
@Override
public void onItemClick(View view, int position, CustomizeMessage content, Message message) {
}
@Override
public void onItemLongClick(View view, int position, CustomizeMessage content, Message message) {
}
}
2、注册消息模板
RongIM.getInstance().registerMessageTemplate(new CustomizeMessageItemProvider);
调用 RongIM.getInstance().sendMessage()
发送自定义消息。需要注意的是,该方法有两个参数 pushContent 和 pushData 。 说明如下:
pushContent:当客户端离线,接受推送通知时,通知的内容会显示为 pushContent 的内容。如果发送的是自定义消息,该字段必须填写,否则会无法收到该消息的推送
。
pushData:收到该消息的推送时的附加信息。如果设置该字段,用户在收到该消息的推送时,能通过推送监听 onNotificationMessageArrived() 里的参数 PushNotificationMessage 的 getPushData() 方法获取。
对连接的几点特殊说明:
connect() 方法在整个应用的生命周期里只需要调用一次。 但是当应用被杀死后,接受到推送通知,点击通知拉起应用时,此时应用被重新唤起,属于新的生命周期,所以需要再次调用 connect() 方法进行连接。
connect() 方法的回调仅在调用时回调一次,后续 SDK 的连接状态发生变化时,不会再通过 connect() 的回调返回,而是 通过您设置的连接状态监听器获得。详细请参考连接状态监听。
重连机制:
10
次重新连接服务器,首次断开 1
秒后会重新连接,如果仍然连接不成功,会在 2
秒后(重连间隔时间为上次重连间隔时间乘 2
)尝试重新连接服务器,以此类推当尝试重连 10
次后,仍然连不上服务器将不再尝试重新连接,但是在网络情况发生变化或重新打开应用时仍然会再次尝试重连。通过 connect() 的 onError() 回调,或者通过 setConnectionStatusListener() 设置的监听器监听到错误码时, 开发者仅需要关注以下几种连接错误码,其余错误码 SDK 均会进行自动重连,开发者无须处理。
App Key 错误,请检查您使用的 App Key 是否正确。
RC_CONN_ID_REJECT = 31002
Token 无效
RC_CONN_USER_OR_PASSWD_ERROR = 31004
Token 无效一般有以下两种原因。
1、Token 错误,请您检查客户端初始化使用的 App Key 和您服务器获取 Token 使用的 App Key 是否一致;
2、Token 过期,是因为您在开发者后台设置了 Token 过期时间,您需要请求您的服务器重新获取 Token 并再次用新的 Token 建立连接。
BundleID 不正确
RC_CONN_PACKAGE_NAME_INVALID = 31007
请检查您 App 的 BundleID 是否正确。
App Key 被封禁或已删除
RC_CONN_APP_BLOCKED_OR_DELETED = 31008
请检查您使用的 App Key 是否正确。
用户被封禁
RC_CONN_USER_BLOCKED = 31009
请检查您使用的 Token 是否正确,以及对应的 UserId 是否被封禁。
当前用户在其他设备上登录,此设备被踢下线
RC_DISCONN_KICK = 31010
SDK 没有初始化**
BIZ_ERROR_CLIENT_NOT_INIT = 33001
在使用SDK任何功能之前,必须先 Init。
开发者接口调用时传入的参数错误
BIZ_ERROR_INVALID_PARAMETER = 33003
请检查接口调用时传入的参数类型和值。
融云 SDK 的 IM 红包功能是由一路魔方科技提供的服务,集成方式请查看红包服务集成指南
到融云官网下载融云动态表情 SDK,将 RCSticker 模块添加到项目中,然后在 app/build.gradle 添加对 RCSticker 模块的依赖:
compile project(':rcsticker')
注意 RCSticker 依赖 IMKit。
关于表情自定义
如果您想自定义其它表情,可以通过自定义 EmoticonTab 的方式来实现,详细查看输入区域自定义。
从 SDK 2.8.29 版本开始支持小视频功能,详细查看小视频服务开发指南
如果聊天的用户正在输入文字或者正在录制语音消息,SDK 可以在聊天界面的标题栏中显示对方正在输入
和对方正在讲话
的提示。
您可以通过 rc_configuration.xml
里的开关开启输入状态提醒的功能,目前仅支持单聊。默认 true
是开启,设置为 false
为关闭。
<!-- 设置发送输入状态 -->
<bool name="rc_typing_status">true</bool>
融云 SDK 内部已经处理好逻辑,开发者不需要关心如何发送输入状态,什么时候取消输入状态等细节。只需要注册监听,在回调里更新标题栏即可。
由于融云只提供 fragment
,所以标题栏的处理需要开发者自己添加。请在集成了 ConversationFragment的activity
里注册输入状态的监听,您可以在 activity
的 onCreate()
里添加如下代码。
RongIMClient.setTypingStatusListener(new RongIMClient.TypingStatusListener() {
@Override
public void onTypingStatusChanged(Conversation.ConversationType type, String targetId, Collection<TypingStatus> typingStatusSet) {
//当输入状态的会话类型和targetID与当前会话一致时,才需要显示
if (type.equals(mConversationType) && targetId.equals(mTargetId)) {
//count表示当前会话中正在输入的用户数量,目前只支持单聊,所以判断大于0就可以给予显示了
int count = typingStatusSet.size();
if (count > 0) {
Iterator iterator = typingStatusSet.iterator();
TypingStatus status = (TypingStatus) iterator.next();
String objectName = status.getTypingContentType();
MessageTag textTag = TextMessage.class.getAnnotation(MessageTag.class);
MessageTag voiceTag = VoiceMessage.class.getAnnotation(MessageTag.class);
//匹配对方正在输入的是文本消息还是语音消息
if (objectName.equals(textTag.value())) {
//显示“对方正在输入”
mHandler.sendEmptyMessage(SET_TEXT_TYPING_TITLE);
} else if (objectName.equals(voiceTag.value())) {
//显示"对方正在讲话"
mHandler.sendEmptyMessage(SET_VOICE_TYPING_TITLE);
}
} else {
//当前会话没有用户正在输入,标题栏仍显示原来标题
mHandler.sendEmptyMessage(SET_TARGETID_TITLE);
}
}
}
});
当前会话正在输入的用户有变化时,会触发 onTypingStatusChanged()
,回调里携带有当前正在输入的用户列表。对于单聊而言,当对方正在输入时,监听会触发一次;当对方不处于输入状态时,该监听还会触发一次,但是回调里上来的输入用户列表为空,开发者需要在此时取消正在输入的显示,显示原有的标题。
您可以通过 rc_config.xml 里的开关,开启消息的阅读回执功能。默认 false 为关闭状态,设置成 true 为开启。
<!-- 设置已读回执 -->
<bool name="rc_read_receipt">true</bool>
另外,请在 init 之后调用下面方法来设置支持消息回执的会话类型。目前只支持 PRIVATE、GROUP 和 DISCUSSION 三种类型。
Conversation.ConversationType[] types = new Conversation.ConversationType[] {
Conversation.ConversationType.PRIVATE,
Conversation.ConversationType.GROUP,
Conversation.ConversationType.DISCUSSION
};
RongIM.getInstance().setReadReceiptConversationTypeList(types);
如果不设置的话,默认只有 PRIVATE 类型的会话支持消息回执。
群消息阅读状态功能,在文本消息发送成功后,可以选择查看消息的阅读状态,用户退出会话界面再次进入时,如文本消息默认发送已超过 2 分钟,将不能再查看该消息的阅读状态,可通过 rc_config.xml 修改默认时间,如下:
<!-- 设置群已读回执有效时间(单位:秒)-->
<integer name="rc_read_receipt_request_interval">120</integer>
从 2.6.8 版本开始支持在群组中实现 @ 功能,您可以 @ 指定用户或 @ 所有人。
1、开启 @ 功能
@ 功能默认为关闭状态,可以在 rc_config.xml 设置 rc_enable_mentioned_message 为 true 开启 @ 功能。
2、设置 @ 成员信息提供者
在会话 activity,通过 RongIM.getInstance().setGroupMembersProvider(String groupId, RongIM.IGroupMemberCallback) 来设置 @ 成员信息提供者。
您可以参考我们 SealTalk 中的 ConversationActivity 来实现。
在 activity 的 onCreate 里设置 @ 群组信息提供者:
RongIM.getInstance().setGroupMembersProvider(new RongIM.IGroupMembersProvider() {
@Override
public void getGroupMembers(String groupId, RongIM.IGroupMemberCallback callback) {
... //获取群组成员信息列表
callback.onGetGroupMembersResult(list); // 调用 callback 的 onGetGroupMembersResult 回传群组信息
}
});
3、@ 成员列表界面自定义
经过第一步打开功能开关后,您就可以长按头像 @ 某人或者输入 @ 字符,弹出成员列表。该成员列表界面您可以自定义。
自定义步骤如下:
a. RongMentionManager.setMentionedInputListener(IMentionedInputListener listener) 设置 @ 字符输入监听器。
b. 在监听器的回调 onMentionedInput() 里跳转到您自定义的 @ 成员选择界面,并返回 true 。
c. 在成员选择界面,选择成员后,调用下面的方法返回所选成员信息。
RongMentionManager.getInstance().mentionMember(item.userInfo);
d. IMentionedInputListener 说明:
public interface IMentionedInputListener {
/**
* 当启动@功能,即在rc_config.xml中设置rc_enable_mentioned_message 为true后,该方法用于设置在群组中,输入@时的监听。
* 如果{@link IMentionedInputListener#onMentionedInput(Conversation.ConversationType, String)}返回true, 则您自己处理显示@成员
* 的选择界面;如果返回false, 则会显示融云SDK默认@成员选择界面。
*
* @param conversationType 会话类型
* @param targetId 会话 id
* @return 返回true, 则您自己处理显示 @ 成员的选择界面;如果返回false, 则会显示融云SDK默认@成员选择界面。
*/
boolean onMentionedInput(Conversation.ConversationType conversationType, String targetId);
}
4、@ 所有人功能
@ 所有人时需要新建一个 MentionedType 为 MentionedType.ALL的MentionedInfo ,并把它设置到 MessageContent中,例:
MentionedInfo mentionedInfo = new MentionedInfo(MentionedInfo.MentionedType.ALL, null, null);
textMessage.setMentionedInfo(mentionedInfo);
RongIM.getInstance().sendMessage(…);
您也可以参考 SealTalk 中的 GroupNoticeActivity 来实现。
如果您使用的是 IMLib SDK 集成,可参考 IMLib @ 功能文档。
从 2.6.8 版本开始 IMKit 中集成了消息撤回功能,默认为关闭状态。开启后,用户在消息发送成功后的有效时间内长按消息,在弹出菜单中选择“撤回消息”来将这条消息撤回。这条消息将在发送端删除,并提示“你撤回了一条消息”,同时发送撤回指令给接收端,接收端收到撤回指令后,也会把同一条消息删除,提示“XX撤回了一条消息”。
请在 rc_config.xml 中将 rc_enable_message_recall 置为 true 来开启消息撤回功能。
rc_message_recall_interval 用来设置撤回消息的有效时间,以秒为单位。当消息发送成功后,只有在有效时间内方能撤回,超过有效时间将不能再执行撤回操作。
<!-- 设置是否支持消息撤回-->
<bool name="rc_enable_message_recall">true</bool>
<!-- 消息撤回有效时间(单位:秒)-->
<integer name="rc_message_recall_interval">120</integer>
您可以通过 rc_config.xml 里的开关,开启多端同步阅读状态功能。默认 false 为关闭状态,设置成 true 为开启。
<!-- 开启之后,用户在其他端上阅读过的消息,当前客户端会清掉该消息的未读数。目前仅支持单聊、群聊。-->
<bool name="rc_enable_sync_read_status">true</bool>
从 IMKit SDK 2.9.0 版本开始,支持会话中长按消息后,显示消息多选功能,可以自定义点击事件。
1、开发者想在长按消息出现更多选项,能够多选消息,需要继承ConversationFragment
,重写下面的方法:
/**
* 是否在长按时显示更多选项
*
* @return true 显示,false 不显示。
*/
public boolean showMoreClickItem()
2、进入多选状态后,开发者需要继承 MessageListAdapter,重写下面的方法判断某条消息能否被选中。
/**
* 多选状态时是否显示checkBox,开发者需要重写此方法,根据消息类型判断是否显示。
*
* @param message 消息类型
* @return true 显示,false 不显示
*/
protected boolean allowShowCheckButton(Message message)
3、之后开发者需要自定义底部的点击事件,开发者实现 IClickActions
,实现自己的点击事件
public interface IClickActions {
/**
* 获取点击按钮的图标
*
* @param context
* @return 图片的Drawable, 如需高亮或者置灰,则返回类型为selector, 分别显示enable或者disable状态下的drawable
*/
Drawable obtainDrawable(Context context);
/**
* 图标按钮点击事件
*
* @param curFragment
*/
void onClick(Fragment curFragment);
}
4、最后,继承 ConversationFragment
,重写下面的方法,将开发者自己的点击事件设置到底部布局,底部点击事件的排序和返回的点击事件列表顺序一致
/**
* 获取点击更多时,底部的动作
* 开发者重写此方法,返回自定义的点击动作
*
* @return 点击动作
*/
public List<IClickActions> getMoreClickActions() {
5、另外,ConversationFragment
还提供公开方法来设置进入多选状态和退出多选状态以及获取选中的消息:
/**
* 显示多选状态
*
* @param message 当前选中的消息
*/
public void setMoreActionState(UIMessage message)
/**
* 重置多选状态,隐藏多选框,隐藏底部点击事件
*/
public void resetMoreActionState()
/**
* 获取选中的消息
*
* @return 选中的消息列表
*/
public List<io.rong.imlib.model.Message> getCheckedMessages()
如果想设置进入和退出多选状态监听,开发者需要设置监听回调,需要调用 ConversationFragment
的 setMoreActionStateListener
方法并重写相关方法。
public interface OnMoreActionStateListener {
/**
* 进入多选状态
*/
void onShownMoreActionLayout();
/**
* 退出多选状态
*/
void onHidenMoreActionLayout();
}
从 SDK 2.9.21 版本开始支持单聊消息快捷回复功能,按以下方式集成即可使用。
1、创建一个 List<String>
将需要快捷回复的消息内容放进去
2、在初始化 SDK 后立刻调用以下方法,将创建的回复消息 List 作为参数传入。
RongExtensionManager.getInstance().addPhraseList()
注意事项:
从 SDK 2.9.21 版本开始支持发送 GIF 图片消息,默认可选择发送的 GIF 图片大小为 2M,接收于小于 1M 的消息时自动下载显示,大于 1M 时需要手动点击下载。
可通过修改 IMKit Module 中 res/values 下 rong_config.xml 文件中的 rc_gifmsg_auto_download_size 的值进行调整。
<!--gif 自动下载的最大值, 超过就需点击手动下载(单位 KB)-->
<integer name="rc_gifmsg_auto_download_size">1024</integer>
为满足客户发送个人名片的功能需求,融云实现了个人名片的开源插件,开发者可下载插件直接集成使用。
GitHub 项目:plugin-contactcard-android
融云提供了集成科大讯飞语音功能转文本发送消息的开源项目插件,开发者可下载插件直接集成使用:
GitHub 项目:plugin-ifly-ext-android
从 2.9.25 版本开始 IMKit SDK 支持合并转发功能,目前只支持单聊、群组会话类型,默认此功能为关闭状态,需要在 kit/res/values/rc_config.xml
文件下,将 rc_enable_send_combine_message 设为 true,即可开启合并转发功能。
从 2.9.25 版本开始 IMKit SDK 支持阅后即焚功能,目前只支持单聊会话类型,默认此功能为关闭状态,需要在 src/kit/res/values/rc_config.xml
配置中将 rc_open_destruct_plugin
属性设为 true
即可,默认为 false
。
阅后即焚支持文本、语音、图片、小视频消息类型。
分别介绍这三个 fragment 的使用方式:
静态集成:
在 AndroidManifest.xml 会话列表Activity 下面配置 intent-filter。此处会话列表 Activity 以 ConversationListActivity 为例,ApplicationId 以 io.rong.fast 为例:
<activity android:name="io.rong.fast.activity.ConversationListActivity"
android:screenOrientation="portrait"
android:windowSoftInputMode="stateHidden|adjustResize">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="io.rong.fast"
android:pathPrefix="/conversationlist"
android:scheme="rong" />
</intent-filter>
</activity>
在 ConversationActivity 的布局文件 conversationlis.xml 中静态集成 ConversationListFragment :
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<fragment
android:id="@+id/conversationlist"
android:name="io.rong.imkit.fragment.ConversationListFragment" //静态方式集成 ConversationListFragment
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
会话列表 Activity 配置对应的布局文件。
public class ConversationListActivity extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.conversationlist);
}
}
启动会话列表 Activity :
/**
* 启动会话列表界面。
*
* @param context 应用上下文。
* @param supportedConversation 定义会话列表支持显示的会话类型,及对应的会话类型是否聚合显示。
* 例如:supportedConversation.put(Conversation.ConversationType.PRIVATE.getName(), false) 非聚合式显示 private 类型的会话。
*/
public void startConversationList(Context context, Map<String, Boolean> supportedConversation)
注意,这个方法里的参数 supportedConversation 是指您的会话列表需要显示的会话类型,以及对应的会话是否聚合显示属性。示例:
private void startConversationList() {
Map<String, Boolean> map = new HashMap<>();
map.put(Conversation.ConversationType.PRIVATE.getName(), true); // 会话列表需要显示私聊会话, 第二个参数 true 代表私聊会话需要聚合显示
map.put(Conversation.ConversationType.GROUP.getName(), false); // 会话列表需要显示群组会话, 第二个参数 false 代表群组会话不需要聚合显示
RongIM.getInstance().startConversationList(this.getApplicationContext(), map);
}
动态集成:
在 AndroidManifest.xml 中会话列表 Activity 下面配置 intent-filter,以 ConversationListDynamicActivtiy 为例,ApplicationId 以 io.rong.fast 为例:
<!--会话列表-->
<activity
android:name="io.rong.fast.test.ConversationListDynamicActivtiy"
android:screenOrientation="portrait"
android:windowSoftInputMode="stateHidden|adjustResize">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="io.rong.fast"
android:pathPrefix="/conversationlist"
android:scheme="rong" />
</intent-filter>
</activity>
会话列表布局文件 rong_activity.xml,代码示例:
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent" android:layout_height="match_parent">
<FrameLayout
android:id="@+id/rong_content"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</FrameLayout>
动态加载 ConversationListFragment,并配置其显示属性
注意: 动态方式加载 ConversationListFragment 的时候,必须调用 setUri() 方法设置 Fragment 的显示属性,比如需要显示哪些类型的会话,会话是否聚合显示等。 具体的使用方法请参考下面示例:
public class ConversationListDynamicActivtiy extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.rong_activity);
ConversationListFragment fragment = new ConversationListFragment();
Uri uri = Uri.parse("rong://" + getApplicationInfo().packageName).buildUpon()
.appendPath("conversationlist")
.appendQueryParameter(Conversation.ConversationType.PRIVATE.getName(), "true") //设置私聊会话,该会话聚合显示
.appendQueryParameter(Conversation.ConversationType.GROUP.getName(), "false")//设置群组会话,该会话非聚合显示
.build();
fragment.setUri(uri); //设置 ConverssationListFragment 的显示属性
FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();
transaction.add(R.id.rong_content, fragment);
transaction.commit();
}
}
启动包含会话列表页的 Activity :
startActivity(new Intent(MainActivity.this, ConversationListDynamicActivtiy.class));
静态集成:
在 AndroidManifest.xml 聚合会话列表 Activity 下面配置 intent-filter,以 SubConversationListActivtiy 为例,ApplicationId 以 io.rong.fast 为例:
<activity
android:name="io.rong.fast.activity.SubConversationListActivtiy"
android:screenOrientation="portrait"
android:windowSoftInputMode="stateHidden|adjustResize">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="io.rong.fast"
android:pathPrefix="/subconversationlist"
android:scheme="rong" />
</intent-filter>
</activity>
在 subconversationlist.xml 中集成 fragment,subconversationlist.xml 代码示例:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<fragment
android:id="@+id/subconversationlist"
android:name="io.rong.imkit.fragment.SubConversationListFragment"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
在 SubConversationListActivtiy 中加载 subconversationlist.xml 即可:
public class SubConversationListActivtiy extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.subconversationlist);
}
}
启动聚合会话列表 Activity:
/**
* 启动聚合后的某类型的会话列表。<br> 例如:如果设置了单聊会话为聚合,则通过该方法可以打开包含所有的单聊会话的列表。
*
* @param context 应用上下文。
* @param conversationType 会话类型。
*/
public void startSubConversationList(Context context, Conversation.ConversationType conversationType)
动态集成:
在 AndroidManifest.xml 聚合会话列表 Activity 下面配置 intent-filter,以 SubConversationListDynamicActivtiy 为例,ApplicationId 以 io.rong.fast 为例:
<activity
android:name="io.rong.fast.test.subconversationlist.SubConversationListDynamicActivtiy"
android:screenOrientation="portrait"
android:windowSoftInputMode="stateHidden|adjustResize">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="io.rong.fast"
android:pathPrefix="/subconversationlist"
android:scheme="rong" />
</intent-filter>
</activity>
加载 subconversationlist.xml 配置文件,代码示例:
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent" android:layout_height="match_parent">
<FrameLayout
android:id="@+id/rong_content"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</FrameLayout>
public class SubConversationListDynamicActivtiy extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.rong_activity);
SubConversationListFragment fragment = new SubConversationListFragment();
FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();
transaction.add(R.id.rong_content, fragment);
transaction.commit();
}
}
静态集成:
在 AndroidManifest.xml 会话 Activity 下面配置 intent-filter,以 ConversationActivity 为例,ApplicationId 以 io.rong.fast 为例:
<activity
android:name="io.rong.fast.activity.ConversationActivity"
android:screenOrientation="portrait"
android:windowSoftInputMode="stateHidden|adjustResize">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="io.rong.fast"
android:pathPrefix="/conversation/"
android:scheme="rong" />
</intent-filter>
</activity>
在会话 Activity 的布局文件 conversation.xml 中静态集成 ConversationFragment. 代码示例:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<fragment
android:id="@+id/conversation"
android:name="io.rong.imkit.fragment.ConversationFragment"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
您的会话界面 Activity。
public class ConversationActivity extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.conversation);
}
}
启动会话页面:
/**
* <p>启动会话界面。</p>
* <p>使用时,可以传入多种会话类型 {@link io.rong.imlib.model.Conversation.ConversationType} 对应不同的会话类型,开启不同的会话界面。
* 如果传入的是 {@link io.rong.imlib.model.Conversation.ConversationType#CHATROOM},sdk 会默认调用
* {@link RongIMClient#joinChatRoom(String, int, RongIMClient.OperationCallback)} 加入聊天室。
* 如果你的逻辑是,只允许加入已存在的聊天室,请使用接口 {@link #startChatRoomChat(Context, String, boolean)} 并且第三个参数为 true</p>
*
* @param context 应用上下文。
* @param conversationType 会话类型。
* @param targetId 根据不同的 conversationType,可能是用户 Id、群组 Id 或聊天室 Id。
* @param title 聊天的标题,开发者可以在聊天界面通过 intent.getData().getQueryParameter("title") 获取该值, 再手动设置为标题。
*/
public void startConversation(Context context, Conversation.ConversationType conversationType, String targetId, String title)
动态集成:
在 AndroidManifest.xml 会话 Activity 下面配置 intent-filter,以 ConversationDynamicActivity 为例,ApplicationId 以 io.rong.fast 为例:
<!--会话页面-->
<activity
android:name="io.rong.fast.test.conversation.ConversationDynamicActivity"
android:screenOrientation="portrait"
android:windowSoftInputMode="stateHidden|adjustResize">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="io.rong.fast"
android:pathPrefix="/conversation/"
android:scheme="rong" />
</intent-filter>
</activity>
动态加载 ConversationFragment,根据 intent 里面传来的参数,通过 setUri() 设置 ConversationFragment 相关属性。 示例:
public class ConversationDynamicActivity extends FragmentActivity {
private String mTargetId; //目标 Id
private Conversation.ConversationType mConversationType; //会话类型
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.rong_activity);
/* 从 intent 携带的数据里获取 targetId 和会话类型*/
Intent intent = getIntent();
mTargetId = intent.getData().getQueryParameter("targetId");
mTargetIds = intent.getData().getQueryParameter("targetIds");
mConversationType = Conversation.ConversationType.valueOf(intent.getData().getLastPathSegment().toUpperCase(Locale.US()));
/* 新建 ConversationFragment 实例,通过 setUri() 设置相关属性*/
ConversationFragment fragment = new ConversationFragment();
Uri uri = Uri.parse("rong://" + getApplicationInfo().packageName).buildUpon()
.appendPath("conversation").appendPath(mConversationType.getName().toLowerCase())
.appendQueryParameter("targetId", mTargetId).build();
fragment.setUri(uri);
/* 加载 ConversationFragment */
FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();
transaction.add(R.id.rong_content, fragment);
transaction.commit();
}
}
融云 IMKit SDK 使用 Fragment 方式实现组件的自定义和嵌入功能,提供 Fragment 能力的组件包括:
Fragment 的启动参数是通过获取所在 Activity 开启时候所携带的 Intent 中的 Data(即 Uri )来实现的。
以会话页面的启动 Uri 为例说明:
rong://{packagename:应用 ApplicationId}/conversation/[private|group]?targetId={目标Id}&[title={开启会话名称}]
如果您的 ApplicationId 为 io.rong.imkit.demo,Id 为 12345 的群组的 Uri 就是 rong://io.rong.imkit.demo/conversation/group?targetId=12345
,那么配置 AndroidManifest.xml 文件如下:
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="io.rong.imkit.demo"
android:pathPrefix="/conversation/"
android:scheme="rong" />
</intent-filter>
然后,在配置的 Activity 所属的 Layout 布局文件上加入相应的 ConversationFragment。 这样在 Intent 带有如上 Uri 后就会唤起 Activity 且 Layout 中的 ConversationFragment 就可以启动并获得参数。 各个 Fragment 的开启 Uri 和 Intent-filter 参数配置如下:
会话列表 ConversationListFragment
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="你的 ApplicationId"
android:pathPrefix="/conversationlist"
android:scheme="rong" />
</intent-filter>
聚合后的会话列表 SubConversationListFragment
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="你的 ApplicationId"
android:path="/subconversationlist"
android:scheme="rong" />
</intent-filter>
会话页面 ConversationFragment
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="你的 ApplicationId"
android:pathPrefix="/conversation/"
android:scheme="rong" />
</intent-filter>
公众账号页面
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="你的 ApplicationId"
android:pathPrefix="/publicServiceProfile"
android:scheme="rong" />
</intent-filter>
融云 SDK 中已经为开发者做了断网重连的机制处理,开发者不必在断网后做连融云服务器的操作。
在网络连接断开后,融云会尝试 5
次重新连接服务器,首次断网 2
秒后会重新连接,如果仍然连接不成功,会在 4
秒后(重连间隔时间为上次重连间隔时间乘 2
)尝度重新连接服务器,以此类推当尝试重连 5
次后,仍然连不上服务器将不在尝试重新连接,只有在网络情况发生变化或重新打开应用时才会再次尝试重连。
在获取到以下错误状态码时,会进行重连:
code | 描述 |
---|---|
30001 | 进行通信操作过程中,当前 Socket 失效。 |
30002 | Socket 连接不可用。应该是您当前网络连接不可用。 |
30003 | 进行各种信令的通信操作过程中,信令 ACK 返回超时。 |
30004 | 导航操作时,Http 请求失败。 |
30005 | HTTP 请求失败。 |
30006 | HTTP 接收失败。 |
30007 | 通过 HTTP 获取连接网络必须的配置数据时,服务器返回的不是 200 OK,而是 HTTP 的其它错误码。 |
30008 | 通过 HTTP 获取配置数据时,成功获得数据,但得到的内容体部分是空。可能是您所在的网络被劫持,HTTP 被修改。 |
30009 | 导航数据解析后,其中不存在有效 IP 地址。 |
30010 | 创建 Socket 失败。 |
30011 | Socket 连接被断开,主要有两种情况,一是用户主动调用 disconnect 之后,Socket 被服务器断开;二是中间路由原因导致 Socket 断开。 |
30013 | PING 超时。 |
31000 | 做 connect 连接时,收到的 ACK 超时。 |
融云为了客户隐私考虑,既不同步又不保存用户的好友关系。所以,所有用户的好友关系都需要开发者自己实现、管理维护,会话及好友列表中显示好友的昵称及头像信息,需要 App 设置一个用户信息提供者给 IMKit,以便 IMKit 通过用户信息提供者, 来实现在聊天界面和会话列表页中显示好友的昵称和头像。详细请参见用户信息提供者参考文档及好友关系实现示例。
陌生人发送加好友邀请,可通过 ContactNotificationMessage
消息类实现。详情请参见 内置通知类消息
中的联系人(好友)通知消息。
startPrivateChat
方法启动会话界面。传入要与之聊天的 targetUserId
后即可进行陌生人会话。
-keepattributes Exceptions,InnerClasses
-keepattributes Signature
# RongCloud SDK
-keep class io.rong.** {*;}
-keep class cn.rongcloud.** {*;}
-keep class * implements io.rong.imlib.model.MessageContent {*;}
-dontwarn io.rong.push.**
-dontnote com.xiaomi.**
-dontnote com.google.android.gms.gcm.**
-dontnote io.rong.**
# VoIP
-keep class io.agora.rtc.** {*;}
# Location
-keep class com.amap.api.**{*;}
-keep class com.amap.api.services.**{*;}
# 红包
-keep class com.google.gson.** { *; }
-keep class com.uuhelper.Application.** {*;}
-keep class net.sourceforge.zbar.** { *; }
-keep class com.google.android.gms.** { *; }
-keep class com.alipay.** {*;}
-keep class com.jrmf360.rylib.** {*;}
-ignorewarnings
另外,您需要 keep 自定义的 BroadcastReceiver 。自定义的 BroadcastReceiver 继承PushMessageReceiver,使用下面的代码是不行的。
-keep public class * extends android.content.BroadcastReceiver
您需要使用下面的代码 keep 自定义的 BroadcastReceiver。
这里 io.rong.app.DemoNotificationReceiver
改成您的应用自定义的完整类名
-keep class io.rong.app.DemoNotificationReceiver {*;}
集成融云 SDK 过程中,如遇到问题可查看常见状态码及处理表。
部分 Android 手机系统在黑屏待机后自动清理后台运行的软件,这样影响了应用正常接收新的消息,需要将应用设置为后台运行应用。查看各类机型的设置说明。
集成配置:
连接异常:
个别机型出现连接失败问题,导航请求失败 java.net.SocketTimeoutException: SSL handshake timed out。
如何适配 Android 9.0(在 Android 9.0 上发生 SSL handshake timed out 异常怎么解决)
通知和推送问题:
用户信息问题: