实时对讲         

1、实时对讲开发说明     

实时对讲功能是语音会议的一种特殊形式,默认最大支持5方,专有云根据选定套餐进行扩展。发言人必须抢麦才能发言,只能有人放麦以后,其他人才能抢麦。                

注意:5.0以上的SDK集成的客户端,测试点对点音视频,音视频会议,群组等功能,建议先将在我们控制台创建的应用上线,才可测试(控制台提供的测试demo中的应用id和应用token,不能用来测试,需要使用自己在官网控制台创建的应用的id和应用token)。                

1.1、接口逻辑

                

接口调用是采取“请求回调”和“通知回调”的方式和服务端交互。用户发出创建对讲、抢麦等操作时,在对应的sdk的方法参数中有“请求回调”方法,请求的结果直接在参数的回调方法中处理。会议中的成员收到服务端发送过来的消息通过“通知回调”方法onReceiveInterPhoneMeetingMsg(ECInterPhoneMeetingMsg  msg)来接收并进行处理。               

1.2、业务流程                

  • 用户A创建实时对讲,创建的同时选择用户B、用户C加入                
  • 用户A先被加入到实时对讲会议室中              
  • 用户B和用户C收到请求并同意加入,同时用户A收到用户B和用户C加入的通知消息              
  • 通过退出接口可以退出实时对讲              
  • 实时对讲只要有一个人,实时对讲就不会结束,直到所有人对出实时对讲,会议室自动关闭                    
  • 2、实时对讲操作代码示例                              

    创建实时对讲

    我们假设Tony要和John、Smith建立实时对讲,则Tony创建实时会议的代码如下:                                       

  • //要邀请的成员数组String members[]= [”John的账号”,”Smith的账号”];
  • ECDevice.getECMeetingManager().createInterphoneMeeting(
  •                                 members,
  •                                 new OnCreateOrJoinMeetingListener () {
  •                                         @Override
  •                  //reason创建实时对讲回调状态码
  •                  //meetingNo 创建实时对讲回调的会议号
  •                                         public void onCreateOrJoinMeeting (ECError reason,
  •                                                         String meetingNo) {
  •                                                 if(reason.errorCode == SdkErrorCode.REQUEST_SUCCESS)
  •                                                 {        
  •                          log(“创建实时对讲成功,跳转到实时对讲界面”);
  •                                                 }else{
  •                        log(“创建实时对讲失败”);} 
  •                                         }
  •                                 });                    
  • 接收到实时对讲通知回调消息

    John和Smith收到实时对讲的邀请(在通知消息中同时上报了已经加入会议的成员),或者当有人加入实时对讲时,sdk都通过onReceiveInterphoneMeetingMsg上报相关信息,其代码如下:

                       

  • public void onReceiveInterPhoneMeetingMsg(ECInterPhoneMeetingMsg msg){
  •    ECInterPhoneMeetingMsgType type = msg.getMsgType();if (type==INVITE){
  •       //如果同意加入需要调用加入实时对讲接口。不加入就忽略此邀请
  •        Log(@"被邀请加入实时对讲");
  •     }
  •     else if(type==OVER)
  •     {
  •        Log(@实时对讲会议被解散");
  • }else if(type== JOIN){
  •  Log(@有人加入实时对讲");} else if(type== CONTROL_MIC){Log(@有人控麦");
  • } else if(type== RELEASE_MIC){
  • Log(@有人放麦");}else if(type== EXIT){
  •  Log(@有人退出实时对讲");
  • }
  • }                                                            
  • 加入实时对讲

    代码如下:                                      

  • void joinMeetingByType(java.lang.String meetingNo,
  •         java.lang.String meetingPwd,
  •         ECMeetingManager.ECMeetingType meetingType,
  •         ECMeetingManager.OnCreateOrJoinMeetingListener listener)                                            
  • 退出实时对讲

    在实时对讲中,Tony、John、Smith三人任何人都可以随时退出实时对讲,代码如下:                                

  • ECDevice.getECMeetingManager().exitMeeting(ECMeetingManager.ECMeetingType.MEETING_INTERCOM);        
  • 实时对讲抢麦

    抢麦只有在实时对讲中才起作用,在语音会议中无效。我们假设Tony在语音会议中抢麦,其示例代码如下:  

  • String meetingNo = “所在的实时对讲的会议号 ”;ECDevice.getECMeetingManager().controlMicInInterPhoneMeeting (
  •                                                 meetingNo, new OnControlMicInInterPhoneListener () {

  •                                                         @Override
  •                         // reason抢麦的状态码
  •                         // speaker当前在麦
  •                                                         public void onControlMicState(ECError reason,
  •                                                                         String speaker) {
  •                       if(reason.errorCode == SdkErrorCode.REQUEST_SUCCESS )
  •                                    {
  •                          //抢麦成功
  •                                      }else{
  •                          //抢麦失败} 
  •               });                                  
  • 实时对讲放麦

    放麦只有在实时对讲中才起作用,在语音会议中无效。我们假设Tony在语音会议中放麦,其示例代码如下:                

                            

  • String meetingNo = “所在的实时对讲的会议号 ”;ECDevice.getECMeetingManager().releaseMicInInterPhoneMeeting (
  •                                                 meetingNo, new OnReleaseMicInInterPhoneListener () {

  •               @Override
  •               // reason 放麦的回调状态
  •               public void onReleaseMicState(ECError reason) {
  •                    if(reason.errorCode == SdkErrorCode.REQUEST_SUCCESS )             {
  •                          //放麦成功
  •                           }
  •                    else
  •                    {
  •                  //放麦失败
  •                     }} });                 
  •