体育万博app下载_manbetx客户端网页版_bet万博网站

单聊指的是一对一的收发消息。云通讯SDK支持一对一发送文本消息、图片消息、文件消息、位置消息、富文本消息。代码示例详细介绍如下,参考Demo中IMChattingHelper类和ChattingFragment类)。

API介绍

1、ECMessage是消息基类,ECMessageBody是抽象的消息内容类,可查看Android消息类结构

参考类:ECMessage查看API

2、发送消息。

  • java.lang.String sendMessage(ECMessage message,
  •                              ECChatManager.OnSendMessageListener l)
  • 发送IM消息
  • 参数:message - 待发送的IM消息l - 发送结果回调
  • 参考类:ECChatManager查看API

    发送文本

    代码示例

  • try{
  • //创建一个待发送的消息ECmessage消息体
  • ECMessage msg = ECMessage.createECMessage(ECMessage.Type.TXT);
  • //设置消息接收者,如果是发送群组消息,则接收者设置群组ID
  • msg.setTo("John的账号")
  • //创建一个文本消息体,并添加到消息对象中
  •  ECTextMessageBody msgBody = new ECTextMessageBody(text.toString());
  • //将消息体存放到ECMessage中
  •  msg.setBody(msgBody);
  • //调用SDK发送接口发送消息到服务器
  •  ECChatManager manager = ECDevice.getECChatManager();
  •     manager.sendMessage(msg, new ECChatManager.OnSendMessageListener() {
  •         @Override
  •         public void onSendMessageComplete(ECError error, ECMessage message) {
  •             // 处理消息发送结果
  •             if(message == null) {
  •                 return ;
  •             }
  •             // 将发送的消息更新到本地数据库并刷新UI
  •         }
  •         @Override
  •         public void onProgress(String msgId, int totalByte, int progressByte) {
  •             // 处理文件发送上传进度(尽上传文件、图片时候SDK回调该方法)
  •         }
  •     });} catch (Exception e) {
  •     // 处理发送异常
  •     Log.e("ECSDK_Demo", "send message fail , e=" + e.getMessage());}
  • 发送图片

    代码示例

  • try{
  • //创建一个待发送的消息ECmessage消息体
  • ECMessage msg = ECMessage.createECMessage(ECMessage.Type.IMAGE);
  • //或者创建一个图片消息体 并且设置附件包体(其实图片也是相当于附件)比如我们发送SD卡里面的一张Tony_2015.jpg图片。
  • ECImageMessageBody msgBody  = new ECImageMessageBody();
  • //设置附件名
  • msgBody.setFileName("Tony_2015.jpg");
  • // 设置附件扩展名
  • msgBody.setFileExt("jpg");
  • //设置附件本地路径
  • msgBody.setLocalUrl("../Tony_2015.jpg");
  • //设置消息接收者,如果是发送群组消息,则接收者设置群组ID
  • msg.setTo("John的账号")
  • //将消息体存放到ECMessage中
  • msg.setBody(msgBody);
  • //调用SDK发送接口发送消息到服务器
  •  ECChatManager manager = ECDevice.getECChatManager();
  •     manager.sendMessage(msg, new ECChatManager.OnSendMessageListener() {
  •         @Override
  •         public void onSendMessageComplete(ECError error, ECMessage message) {
  •             // 处理消息发送结果
  •             if(message == null) {
  •                 return ;
  •             }
  •             // 将发送的消息更新到本地数据库并刷新UI
  •         }

  •         @Override
  •         public void onProgress(String msgId, int totalByte, int progressByte) {
  •             // 处理文件发送上传进度(尽上传文件、图片时候SDK回调该方法)
  •         }
  •     });} catch (Exception e) {
  •     // 处理发送异常
  •     Log.e("ECSDK_Demo", "send message fail , e=" + e.getMessage());}
  • 发送附件

    代码示例

  • //创建一个待发送的消息ECmessage消息体
  • ECMessage msg = ECMessage.createECMessage(ECMessage.Type.FILE);
  • //或者创建一个创建附件消息体,比如我们发送SD卡里面的一个Tony_2015.zip文件。
  • ECFileMessageBody msgBody  = new ECFileMessageBody();
  • //设置附件名
  • msgBody.setFileName("Tony_2015.zip");
  • //设置附件扩展名
  • msgBody.setFileExt("zip");
  • //设置附件本地路径
  • msgBody.setLocalUrl("../Tony_2015.zip");
  • //设置附件长度
  • msgBody.setLength("Tony_2015.zip文件大小");
  • //设置消息接收者,如果是发送群组消息,则接收者设置群组ID
  • msg.setTo("John的账号")
  • //将消息体存放到ECMessage中
  • msg.setBody(msgBody);
  • //调用SDK发送接口发送消息到服务器
  •  ECChatManager manager = ECDevice.getECChatManager();
  •     manager.sendMessage(msg, new ECChatManager.OnSendMessageListener() {
  •         @Override
  •         public void onSendMessageComplete(ECError error, ECMessage message) {
  •             // 处理消息发送结果
  •             if(message == null) {
  •                 return ;
  •             }
  •             // 将发送的消息更新到本地数据库并刷新UI
  •         }

  •         @Override
  •         public void onProgress(String msgId, int totalByte, int progressByte) {
  •             // 处理文件发送上传进度(尽上传文件、图片时候SDK回调该方法)
  •         }
  •     });} catch (Exception e) {
  •     // 处理发送异常
  •     Log.e("ECSDK_Demo", "send message fail , e=" + e.getMessage());}
  • 发送语音

    代码示例

  • try {
  •     // 组建一个待发送的ECMessage
  •     ECMessage msg= ECMessage.createECMessage(ECMessage.Type.VOICE);
  •     // 设置消息接收者,如果是发群组消息,则接收者设置群组ID
  •     msg.setTo("John的账号");
  •     // 扩张字段,应用可以自定义规则
  •     msg.setUserData("msgExt://amr");
  •     // 设置语音包体,语音录制文件需要保存的目录
  •     ECVoiceMessageBody messageBody = new ECVoiceMessageBody(new File("保存路径"), 0);
  •     msg.setBody(messageBody);
  •     // 仅录制语音消息,录制完成后需要调用发送接口发送消息
  •     ECChatManager manager = ECDevice.getECChatManager();
  •     manager.startVoiceRecording(message, 
  •             new ECChatManager.OnRecordTimeoutListener() {
  •  
  •         @Override
  •         public void onRecordingTimeOut(long duration) {
  •             // 如果语音录制超过最大60s长度,则发送
  •             // 同时SDK停止当前语音录制
  •         }
  •  
  •         @Override
  •         public void onRecordingAmplitude(
  •                 double amplitude) {
  •             // 显示声音振幅
  •         }
  •     });
  •     // 调用SDk接口停止当前录音
  •     manager.stopVoiceRecording(
  •             new ECChatManager.OnStopVoiceRecordingListener() {
  •         @Override
  •         public void onRecordingComplete() {
  •             // SDK停止录音完成,调用SDK接口发送语音消息           
  •       ECChatManager manager = ECDevice.getECChatManager();
  •         manager.sendMessage(msg, new ECChatManager.OnSendMessageListener() {
  •             @Override
  •             public void onSendMessageComplete(ECError error, ECMessage message) {
  •                 // 处理消息发送结果
  •                 if(message == null) {
  •                     return ;
  •                 }
  •             // 将发送的消息更新到本地数据库并刷新UI
  •          }
  •         }
  •     });} catch (Exception e) {
  •     e.printStackTrace();}
  •     //将ECMessage对象传入sendMessage方法进行发送。    
  • 发送地理位置

    代码示例

  •        try{
  •         //组建一个待发送的ECMessage
  •         ECMessage msg = ECMessage.createECMessage(ECMessage.Type.LOCATION);
  •         //设置消息接收者,如果是发送群组消息,则接收者设置群组ID
  •         msg.setTo(mRecipients);
  •         // 创建一个消息体,并添加到位置消息对象中
  •         ECLocationMessageBody msgBody = new ECLocationMessageBody("传入lat", "传入lon");
  •         //title标题
  •         msgBody.setTitle("位置信息");
  •         //将消息体存放到ECMessage中
  •         msg.setBody(msgBody);    
  •         //调用SDK发送接口发送消息到服务器
  •         ECChatManager manager = ECDevice.getECChatManager();
  •         manager.sendMessage(msg, new ECChatManager.OnSendMessageListener() {
  •         @Override
  •         public void onSendMessageComplete(ECError error, ECMessage message) {
  •             // 处理消息发送结果
  •             if(message == null) {
  •                 return ;
  •             }
  •             // 将发送的消息更新到本地数据库并刷新UI
  •         }
  •         @Override
  •         public void onProgress(String msgId, int totalByte, int progressByte) {
  •         }
  •     });} catch (Exception e) {
  •     // 处理发送异常
  •     Log.e("ECSDK_Demo", "send message fail , e=" + e.getMessage());}
  • 发送富文本消息

    代码示例                        

  • try{
  •  //创建一个待发送的消息ECmessage消息体
  •  ECMessage msg = ECMessage.createECMessage(ECMessage.Type.RICH_TEXT); 
  •  //设置消息接收者,如果是发送群组消息,则接收者设置群组ID
  •  msg.setTo("john的账号");  
  •  // 创建一个富文本消息体 
  •  ECPreviewMessageBody msgBody = new ECPreviewMessageBody(); 
  •  //title标题、设置富文本消息的标题
  •  msgBody.setTitle(title); 
  •  //desc设置大概的描述信息 
  •  msgBody.setDescContent(desc);
  •  //设置解析网页获取的图片的本地地址(apps需要将获取的图片保存到手机上)、sdk需要将图片进行上传。
  •  msgBody.setLocalUrl(xxx.jpg);
  •  //url设置富文本消息对应的网页的url、当对方点击时打开的网页网址
  •  msgBody.setUrl(url); 
  •  //解析网页图片的url地址、设置当前富文本消息的一张图片、解析网页获取该图片的过程由开发者实现、
  •  //也可以参考demo使用jsoup或其他实现。
  •  msgBody.setRemoteUrl(imgUrl); 
  •  //将msgBody设置给该富文本消息
  •  msg.setBody(msgBody); 
  •  //调用SDK发送接口发送消息到服务器
  •  ECChatManager manager = ECDevice.getECChatManager();
  •  manager.sendMessage(msg, new ECChatManager.OnSendMessageListener() {
  •         @Override
  •         public void onSendMessageComplete(ECError error, ECMessage message) {
  •             // 处理消息发送结果
  •             if(message == null) {
  •                 return ;
  •             }
  •             // 将发送的消息更新到本地数据库并刷新UI
  •         }

  •         @Override
  •         public void onProgress(String msgId, int totalByte, int progressByte) {
  •             // 处理文件发送上传进度
  •         }
  •     });} catch (Exception e) {
  •     // 处理发送异常
  •     Log.e("ECSDK_Demo", "send message fail , e=" + e.getMessage());}
  • 发送状态消息

     代码示例

  •    //组建一个待发送的ECMessage  
  •    ECMessage msg = ECMessage.createECMessage(ECMessage.Type.STATE);
  •    //设置消息接收者
  •    msg.setTo("john的账号"); 
  •    //创建一个状态消息体,并添加到消息对象中
  •    //state当前聊天过程中的输入状态
  •    ECUserStateMessageBody msgBody = new ECUserStateMessageBody(state);
  •    //将消息体存放到ECMessage中
  •    msg.setBody(msgBody);   
  •   //调用SDK发送接口发送消息到服务器
  •   ECChatManager manager = ECDevice.getECChatManager();
  •     manager.sendMessage(msg, new ECChatManager.OnSendMessageListener() {
  •         @Override
  •         public void onSendMessageComplete(ECError error, ECMessage message) {
  •             // 处理消息发送结果
  •             if(message == null) {
  •                 return ;
  •             }
  •             // 将发送的消息更新到本地数据库并刷新UI
  •         }
  •         @Override
  •         public void onProgress(String msgId, int totalByte, int progressByte) {
  •             // 处理文件发送上传进度(尽上传文件、图片时候SDK回调该方法)
  •         }
  •     });} catch (Exception e) {
  •     // 处理发送异常
  •     Log.e("ECSDK_Demo", "send message fail , e=" + e.getMessage());}
  • 自定义消息

    自定义消息通过发送文本消息接口扩展字段来实现,通过userData字段来设置自定义消息。

    代码示例

  • try {
  •     // 组建一个待发送的ECMessage
  •     ECMessage msg = ECMessage.createECMessage(ECMessage.Type.TXT);  
  •     // 设置消息接收者
  •     msg.setTo("John的账号");
  •     // 创建一个文本消息体,并添加到消息对象中
  •     // 文本消息由用户自定义组装,接收端按照规则解析
  •     ECTextMessageBody msgBody = new ECTextMessageBody("Location");
  •     msg.setBody(msgBody);  
  •     // 设置自定义消息类型如:(位置)
  •     msg.setUserData("msgType://Location");    
  •     //调用SDK发送接口发送消息到服务器
  •     ECChatManager manager = ECDevice.getECChatManager();
  •     manager.sendMessage(msg, new ECChatManager.OnSendMessageListener() {
  •         @Override
  •         public void onSendMessageComplete(ECError error, ECMessage message) {
  •             // 处理消息发送结果
  •             if(message == null) {
  •                 return ;
  •             }
  •             // 将发送的消息更新到本地数据库并刷新UI
  •         }
  •         @Override
  •         public void onProgress(String msgId, int totalByte, int progressByte) {
  •             // 处理文件发送上传进度(尽上传文件、图片时候SDK回调该方法)
  •         }
  •     });} catch (Exception e) {
  •     // 处理发送异常
  •     Log.e("ECSDK_Demo", "send message fail , e=" + e.getMessage());}
  • 取消发送消息

    仅支持voiceBody、videoBody、fileBody、imageBody、preViewBody消息body、取消的回调onSendMessageComplete回调中返回171259错误码)。

    代码示例

  • ECChatManager chatManager =ECDevice.getECChatManager();
  • if(chatManager ==null){
  •         return;}
  • //取消发送消息
  • chatManager.cancelSendMessage(message);
  • 接收消息

    接收到的IM消息,根据IM消息类型做不同的处理,接收消息的回调要在初始化成功的方法里面设置。参考文档:IM接收消息监听

    代码示例

  • //如果是跨应用消息,发送者为appkey+英文井号+用户帐号。
  • //例如:appkey=20150314000000110000000000000010 帐号ID=john  
  • //发送者=20150314000000110000000000000010#john  
  • @Override
  • public void OnReceivedMessage(ECMessage msg) {
  •         if(msg == null) {
  •                 return ;
  •         }
  •         // 接收到的IM消息,根据IM消息类型做不同的处理(IM消息类型:ECMessage.Type)
  •         ECMessage.Type type = msg.getType();
  •         if(type == ECMessage.Type.TXT) {
  •                 // 在这里处理文本消息
  •                 ECTextMessageBody textMessageBody = (ECTextMessageBody) msg.getBody();
  •         } else {
  •                 String thumbnailFileUrl = null;
  •                 String remoteUrl = null;
  •                 if (type == ECMessage.Type.FILE) {
  •                         // 在这里处理附件消息
  •                         ECFileMessageBody fileMsgBody = (ECFileMessageBody) msg.getBody();
  •                         // 获得下载地址
  •                         remoteUrl = fileMsgBody.getRemoteUrl();
  •                 } else if (type == ECMessage.Type.IMAGE) {
  •                         // 在这里处理图片消息
  •                         ECImageMessageBody imageMsgBody = (ECImageMessageBody) msg.getBody();
  •                         // 获得缩略图地址
  •                         thumbnailFileUrl = imageMsgBody.getThumbnailFileUrl();
  •                         // 获得原图地址
  •                         remoteUrl = imageMsgBody.getRemoteUrl();
  •                 } else if (type == ECMessage.Type.VOICE) {
  •                         // 在这里处理语音消息
  •                         ECVoiceMessageBody voiceMsgBody = (ECVoiceMessageBody) msg.getBody();
  •                         // 获得下载地址
  •                         remoteUrl = voiceMsgBody.getRemoteUrl();
  •                 } else if (type == ECMessage.Type.VIDEO) {
  •                         // 在这里处理视频消息
  •                         ECVideoMessageBody videoMessageBody = (ECVideoMessageBody) msg.getBody();
  •                         // 获得下载地址
  •                         remoteUrl = videoMessageBody.getRemoteUrl();
  •                 } else if (type == ECMessage.Type.LOCATION) {
  •                         // 在这里处理地理位置消息
  •                         ECLocationMessageBody locationMessageBody = (ECLocationMessageBody) msg.getBody();
  •                         // 获得下载地址
  •                         locationMessageBody.getLatitude(); // 纬度信息
  •                         locationMessageBody.getLongitude();// 经度信息
  •                 } else {
  •                         Log.e("ECSDK_Demo" , "Can't handle msgType=" + type.name()
  •                                         + " , then ignore.");
  •                         // 后续还会支持(自定义等消息类型)
  •                 }
  •                 if(TextUtils.isEmpty(remoteUrl)) {
  •                         return ;
  •                 }
  •                 if(!TextUtils.isEmpty(thumbnailFileUrl)) {
  •                         // 先下载缩略图
  •                 } else {
  •                         // 下载附件
  •                 }
  •         }
  •         // 根据不同类型处理完消息之后,将消息序列化到本地存储(sqlite)
  •         // 通知UI有新消息到达
  • }