1、聊天室接口開發說明
從v5.3.2開始、sdk增加直播聊天室功能、推出直播領域消息解決方案。
聊天室跟普通的IM群（微信群，QQ群等）相比最大的不同點在于它是一個比較開放的虛擬組織。我們可以將直播聊天室比喻成一個廣場，廣場是開放無邊界的，所有的人都可以隨進隨出，而群就像一個房間，是一個有邊界有容量上限的私密組織，并且進入這個房間需要一定條件，一般是主動申請加入或被邀請加入。
1.1、相關接口：
直播sdk相關接口分2大類別：
1.1.1 后臺Rest提供接口。具體參考文檔地址：//www.hvjhxrn.cn/doc/sdk/server/2_5_1_8.html
(1) 創建聊天室,參考demo中的CreateRoomUI 類。
(2) 切換聊天室狀態（開啟/關閉）,參考demo中的ECLIveChatRoomListUI 類。
1.1.2 SDK接口文檔（本頁面提供）
安卓sdk內部提供的接口: 進入聊天室、聊天室內發送消息、獲取聊天室信息、獲取聊天室成員列表、獲取成員信息、對成員進行禁言/拉黑、踢出、修改個人信息、修改聊天室信息、退出聊天室等接口。
1.2、直播聊天室三種成員角色：創建者(權限最高)>管理員>普通成員(權限高的能對權限低的做相應處理)。
(1) 創建者:可以對所有成員進行管理，包括禁言/解除禁言/拉黑/從黑名單移除/踢出/修改聊天室信息。
(2) 管理員:只能對成員進行管理，禁言/解除禁言/拉黑/從黑名單移除/踢出。
(3) 普通成員:無權限
2、聊天室操作代碼示例：
? 進入聊天室 — 用戶要在聊天室內說話，必須先調用接口進入此聊天室，之后便可以進行溝通。代碼如下：
/**構建進入聊天室透傳信息對象、設置昵稱與透傳信息、別的用戶可以通過調用查詢聊天室成員信息接口進行獲取*/
ECLiveChatRoomMemberInfoBuilder infoBuilder =
new ECLiveChatRoomMemberInfoBuilder(CCPAppManager.getUserId(),
CCPAppManager.getUserId()+":infoext");
ECLiveChatRoomManager roomManager = ECDevice.getECLiveChatRoomManager();
if(roomManager==null){
return;
}
roomManager.joinLiveChatRoom(room.roomId, infoBuilder, SDKCoreHelper.buildNotify(),
new ECLiveCallBack.OnEnterLiveChatRoomListener() {
@Override
public void onEnterResult(ECError error, ECLiveChatRoom liveChatRoom,
ECLiveChatRoomMember member) {
if (error.errorCode == SdkErrorCode.REQUEST_SUCCESS) {
//進入房間成功
// do 業務邏輯
} else {
//進入房間失敗
// do 業務邏輯
}
}
});
? 聊天室內發送消息 — 目前只支持發送文本消息,其他消息暫不支持,用戶如果想發送其他消息,可以用userdata發送自定義消息。代碼如下：
ECMessage msg = ECMessage.createECMessage(ECMessage.Type.TXT);
// 創建一個文本消息體，并添加到消息對象中
ECTextMessageBody msgBody = new ECTextMessageBody(text.toString());
msg.setBody(msgBody);
ECLiveChatRoomManager roomManager = ECDevice.getECLiveChatRoomManager();
if(roomManager==null){
return;
}
roomManager.sendLiveChatRoomMessage(msg, new OnSendLiveChatRoomMessageListener() {
@Override
public void onSendResult(ECError error, ECMessage message){
if (error.errorCode == SdkErrorCode.REQUEST_SUCCESS){
}
}
});
? 獲取聊天室信息 — 通過查詢聊天室信息、獲取當前在線人數、聊天室名稱等信息用于界面UI展示。代碼如下：
ECLiveChatRoomManager roomManager = ECDevice.getECLiveChatRoomManager();
if(roomManager==null){
return;
}
roomManager.queryLiveChatRoomInfo(房間id, new ECLiveCallBack.OnQueryLiveChatRoomInfoListener() {
@Override
public void onQueryLiveChatRoom(ECError error, ECLiveChatRoom liveChatRoom) {
if (error.errorCode == SdkErrorCode.REQUEST_SUCCESS) {
//查詢成功
} else {
//查詢失敗
}
}
});
? 修改聊天室信息 — 創建者可以修改當前聊天室的展示信息。代碼如下：
//構建修改聊天室對象
ECLiveChatRoomModifyBuilder builder = new ECLiveChatRoomModifyBuilder(聊天室id,
聊天室昵稱, 聊天室描述, 聊天室透傳展示信息, 聲音模式);
ECLiveChatRoomManager roomManager = ECDevice.getECLiveChatRoomManager();
if(roomManager==null)
{
return;
}
ECLiveNotifyWrapper notifyWrapper = new ECLiveNotifyWrapper(設置通知透傳信息, 是否通知其他人);
roomManager.modifyLiveChatRoomInfo(builder, notifyWrapper,
new ECLiveCallBack.OnUpdateLiveChatRoomListener() {
@Override
public void onResult(ECError ecError) {
}
});
? 獲取聊天室成員列表 — 此接口可以遠程獲取聊天室成員列表,SDK不會緩存聊天室成員列表和查詢單個成員信息,開發者需要根據業務自己做好緩存。代碼如下：
ECLiveChatRoomManager roomManager = ECDevice.getECLiveChatRoomManager();
if(roomManager==null){
return;
}
ECLiveSearchMembersConditionBuilder builder = new ECLiveSearchMembersConditionBuilder(room.roomId,"",
ECLiveEnums.ECRole.ECRole_CREATE,10);
roomManager.queryLiveChatRoomMembers(builder,new ECLiveCallBack.OnQueryLiveChatRoomMembersListener(){
@Override
public void onQueryResult(ECError error, ArrayList list){
if(error.errorCode==SdkErrorCode.REQUEST_SUCCESS){
}else{
}
}
});
}
? 獲取成員信息 — 當用戶需要查看自己或者其他成員信息時,可以調用此接口,訪問其他人的信息。代碼如下：
ECLiveChatRoomManager roomManager = ECDevice.getECLiveChatRoomManager();
if(roomManager==null){
return;
}
roomManager.queryLiveChatRoomMember(room.roomId, member.userId,
new ECLiveCallBack.OnQuerySingleLiveChatRoomMembersListener() {
@Override
public void onQueryResult(ECError error, ECLiveChatRoomMember member){
}
});
? 修改個人信息 — 在當前聊天室房間中設置昵稱、透傳信息。代碼如下：
ECLiveChatRoomMemberInfoBuilder modifySelfInfo = new ECLiveChatRoomMemberInfoBuilder(昵稱,透傳信息);
ECLiveChatRoomManager roomManager = ECDevice.getECLiveChatRoomManager();
if(roomManager==null){
return;
}
roomManager.modifyLiveChatRoomSelfInfo(聊天室id, modifySelfInfo,
new ECLiveCallBack.OnUpdateSelfInfoListener() {
@Override
public void onResult(ECError error) {
if (error.errorCode == SdkErrorCode.REQUEST_SUCCESS) {
// do 業務邏輯
} else {
// do 業務邏輯
}
}
});
? 對聊天室成員進行禁言/解除禁言 — 創建者、管理員可以對成員進行禁言/解除禁言/加入黑名單/從黑名單移除處理。代碼如下：
ECLiveChatRoomManager roomManager = ECDevice.getECLiveChatRoomManager();
if(roomManager==null){
return;
}
ECLiveControlOption option = new ECLiveControlOption(時長[在禁言狀態有效],state);
roomManager.forbidLiveChatRoomMember(room.roomId, userId, option, wrapper,
new ECLiveCallBack.OnControlMemberStateListener() {
@Override
public void onResult(ECError ecError) {
}
});
? 拉黑/移除黑名單 — 角色權限高的用戶可以對角色權限低的用戶設置拉黑狀態,設置拉黑后的用戶將不能發送消息,不能接收消息，并且若被移除聊天室,被拉黑的用戶將不能加入此房間。代碼如下：
ECLiveChatRoomManager roomManager = ECDevice.getECLiveChatRoomManager();
if(roomManager==null){
return;
}
roomManager.dfriendLiveChatRoomMember(room.roomId, userId, 拉黑/移除黑名單,
wrapper, new ECLiveCallBack.OnControlMemberStateListener() {
@Override
public void onResult(ECError ecError) {
if (ecError.errorCode == SdkErrorCode.REQUEST_SUCCESS) {
}
}
});
? 踢出 — 創建者/管理員可以將成員從該聊天室中踢出。代碼如下：
ECLiveChatRoomManager roomManager = ECDevice.getECLiveChatRoomManager();
if(roomManager==null){
return;
}
ECLiveNotifyWrapper notifyWrapper = new ECLiveNotifyWrapper(設置通知透傳信息, 是否通知其他人);
roomManager.kickLiveChatRoomMember(聊天室id, 被踢的成員userid,
notifyWrapper, new ECLiveCallBack.OnLiveChatRoomKickMemberListener() {
@Override
public void onResult(ECError ecError) {
}
});
? 退出聊天室 — 用戶主動退出聊天室,調用此接口。代碼如下：
ECLiveChatRoomManager roomManager = ECDevice.getECLiveChatRoomManager();
if(roomManager==null){
return;
}
ECLiveNotifyWrapper notifyWrapper = new ECLiveNotifyWrapper(設置通知透傳信息, 是否通知其他人);
roomManager.exitLiveChatRoom(room.roomId, notifyWrapper,
new ECLiveCallBack.OnExitLiveChatRoomListener() {
@Override
public void onResult(ECError ecError) {
if (ecError.errorCode == SdkErrorCode.REQUEST_SUCCESS) {
} else {
}
}
});
? 接收聊天室消息及通知接口 — 當用戶加入,退出,被禁言,被踢出,被拉黑,變更角色等,聊天室內的成員都會收到通知消息。
public interface OnLiveChatRoomListener{
/**
* 接收聊天室消息
* @param message
*/
void OnReceiveLiveChatRoomMessage(ECMessage message);
/**
* 接收聊天室通知消息
* @param notice
*/
void OnReceiveLiveChatRoomNotification(ECLiveChatRoomNotification notice);
///**通知類型*/ 根據type獲取不同的通知類型
//public ECLiveEnums.ECNoticeType noticeType;
}
文檔更新時間：2017年7月10日