实时对讲

1、实时对讲开发说明               

实时对讲功能是语音会议的一种特殊形式，默认最大支持5方，专有云根据选定套餐进行扩展。发言人必须抢麦才能发言,只能有人放麦以后，其他人才能抢麦。                
注意：5.0以上的SDK集成的客户端，测试点对点音视频，音视频会议，群组等功能，建议先将在官网控制台创建的应用上线，才可测试（控制台提供的测试demo中的应用id和应用token，不能用来测试，需要使用自己在官网控制台创建的应用id和应用token）。                
1.1、接口逻辑                
接口调用是采取“请求回调”和“通知回调”的方式和服务端交互。用户发出创建对讲、抢麦等操作时，在对应的sdk的方法参数中有“请求回调”方法，请求的结果直接在参数的回调方法中处理。会议中的成员收到服务端发送过来的消息通过“通知回调”方法-(void)onReceiveInterphoneMeetingMsg:(ECInterphoneMeetingMsg  *)msg;来接收并进行处理。                
1.2、业务流程               
(1)用户A创建实时对讲，创建的同时选择用户B、用户C加入
(2)用户A先被加入到实时对讲会议室中
(3)用户B和用户C收到请求并同意加入,同时用户A收到用户B和用户C加入的通知消息
(4)通过退出接口可以退出实时对讲
(5)会议室内只要有一个人，实时对讲就不会结束，直到所有人退出实时对讲，会议室自动关闭
                    

2、实时对讲操作代码示例                                

创建实时对讲

我们假设Tony要和John、Smith建立实时对讲，则Tony创建实时会议的代码如下：                                        
  • //要邀请的成员数组
    • 

  • NSMutableArray * inviteArray = [[NSMutableArray alloc] initWithObjects:@" John的电话号",@" Smith的电话号", nil];
    • 

  • [[ECDevice sharedInstance].meetingManager createInterphoneMeetingWithMembers:inviteArray completion:^(ECError *error, NSString *meetingNumber) {  // error创建实时对讲回调状态码
    • 

  •                //meetingNo 创建实时对讲回调的会议号
    • 

  •                 if(error.errorCode==ECErrorType_NoError){
    • 

  •                  NSLog(@"创建实时对讲成功，跳转到实时对讲界面");
    • 

  •                 }else {
    • 

  •                   NSLog(@"创建实时对讲失败");
    • 

  •                 } }];                  

接收到实时对讲邀请

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

  •     ECInterphoneMeetingMsgType type=msg.type;
    • 

  •    if (type== Interphone_INVITE)
    • 

  •     {
    • 

  •        NSLog(@"邀请加入实时对讲");
    • 

  •     }
    • 

  •     else if(type== Interphone_OVER)
    • 

  •     {
    • 

  •        NSLog(@"退出实时对讲");
    • 

  •     }}                                                                   
注意：通常实时对讲为了实时的邀请不允许拒绝，可以先进入实时对讲，然后再退出。                                              

退出实时对讲

在实时对讲中，Tony、John、Smith三人中的任何人都可以随时退出实时对讲，代码如下：                                        
  • [[ECDevice sharedInstance].meetingManager exitMeeting];                                                     

实时对讲抢麦

抢麦只有在实时对讲中才起作用，在语音会议和视频会议中无效。我们假设Tony在实时对讲中抢麦，其示例代码如下：
                       
  • NSString* meetingNo =@”所在的实时对讲的会议号”;
    • 

  •  [[ECDevice sharedInstance].meetingManager controlMicInInterphoneMeeting: meetingNo completion:^(ECError *error,NSString *memberVoip ){
    • 

  •          // memberVoip当前在麦上的账号
    • 

  •         if (error.errorCode == ECErrorType_NoError)
    • 

  •            { 
    • 

  •                NSLog(@"控麦成功，请讲话"); 
    • 

  •            }
    • 

  •         else
    • 

  •           {
    • 

  •                NSLog(@"控麦失败，稍后重试"); 
    • 


    • 

  •           }
    • 

  •  }];                                                                                                    

实时对讲放麦

放麦只有在实时对讲中才起作用，在语音会议和视频会议中无效。我们假设Tony在语音会议中放麦，其示例代码如下：
                         
  • NSString* meetingNo =@”所在的实时对讲的会议号”;
    • 

  • [[ECDevice sharedInstance].meetingManager releaseMicInInterphoneMeeting: meetingNo completion:^(ECError *error,NSString *memberVoip ){
    • 

  •             // memberVoip当前在放麦人的账号
    • 

  •             if (error.errorCode == ECErrorType_NoError)
    • 

  •            { 
    • 

  •                NSLog(@"放麦成功"); 
    • 

  •            }
    • 

  •         else
    • 

  •           {
    • 

  •                NSLog(@"放麦失败，稍后重试"); 
    • 

  •           }
    • 

  •         }]