退出和结束会议

描述

普通与会者和主席均可在会议中主动退出会议，主席可以结束会议。

说明： 

若主席退出会议，则会议中无主席，预约会议时，原主席可以通过主席接入信息重新加入会议获取主席；当会议中无任何与会者时，会议也会自动结束。

与会者已在会议中。

业务流程

一、退出会议

图1 退出会议流程 

1. 普通与会者或主席侧UI调用tsdk_leave_conference()主动退出会议。
   说明： 

   在主动离开会议过程中，sdk层会主动挂断通话，然后才离开会议。

   代码示例：

   -(BOOL)confCtrlLeaveConference
   {    
       int result = tsdk_leave_conference(_confHandle);      
       return result == TSDK_SUCCESS ? YES : NO;
   }

    
2. 普通与会者或主席侧SDK在收到“退出会议”请求的响应后，向UI上报删除呼叫id事件TSDK_E_CALL_EVT_CALL_DESTROY。
   代码示例：

   case TSDK_E_CALL_EVT_CALL_DESTROY:        
   {                      
       [self respondsCallDelegateWithType:CALL_DESTROY result:nil];        
   }

    
3. 其他与会者侧SDK收到会议成员列表刷新通知，向UI上报会议成员列表刷新事件TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE，UI刷新会议成员列表。
   说明： 

   详细流程参见“更新会议状态信息和与会者列表”描述。

二、结束会议

图2 结束会议流程 

1. 主席侧UI调用tsdk_end_conference()结束会议。
   说明： 

   应用程序界面在关闭会议时应为主席提供“退出会议”和“结束会议”的选择入口。

   代码示例：

   -(BOOL)confCtrlEndConference
   {    
       int result = tsdk_end_conference(_confHandle);      
       return result == TSDK_SUCCESS ? YES : NO;
   }

    
2. 其他与会者侧SDK收到会议结束通知，向UI上报会议结束事件TSDK_E_CONF_EVT_CONF_END_IND，UI提示用户会议结束。

注意事项

无。

基础会控操作

描述

在会议中进行基础的会议控制操作。

业务流程

图3 基础会议控制流程 

1. UI调用会议基础控制接口（如表1），实现会议控制相关操作。

   表1 会议控制操作

   会控类型	接口	权限	说明
   闭音会场	tsdk_mute_conference	主席	设置会议闭音后，除主席外，其他所有与会者均不可说（只可听）。
   添加与会者	tsdk_add_attendee	主席	支持邀请一个或多个与会者。
   重拨与会者	tsdk_redial_attendee	主席	-
   挂断与会者	tsdk_hang_up_attendee	主席	挂断在会议中的与会者。
   删除与会者	tsdk_remove_attendee	主席	踢出与会者（正在会议中的）、移除已离会的与会者和取消正在邀请的与会者。
   闭音与会者	tsdk_mute_attendee	主席 普通与会者	设置闭音后，该与会者不可说(只听)。 会议主席在会议中设置或取消其他与会者闭音，普通与会者设置或取消自己闭音。
   举手	tsdk_set_handup	主席 普通与会者	会议主席在会议中取消其他与会者举手，所有与会者设置或取消自己举手。
   设置会议视频模式	tsdk_set_video_mode	主席	在CloudEC解决方案下，支持的视频会议模式有“广播与会者模式”、“声控模式”和“自由讨论模式”。
   观看与会者	tsdk_watch_attendee	主席 普通与会者	AVC 会议：只需要指定待选看的与会者号码，每次指定选看一个与会者。 SVC会议： 除指定待选看的与会者号码外，还应该指定"SVC Label"，以及待选看的分辨率(宽和高)，且“SVC Label”与“分辨率”必须与“绑定SVC视频窗口”时填写的参数相对应。 更新选看时，需要全量指定所有选看信息(一大多少)。 若指定的待选看与会者号码为空(仅支持大窗口)，则所选看的与会者由系统自动推送。
   广播与会者	tsdk_broadcast_attendee	主席	会议视频模式为“广播与会者模式”时主席可以指定广播与会者。
   申请主席	tsdk_request_chairman	普通与会者	-
   释放主席	tsdk_release_chairman	主席	-
   延长会议	tsdk_postpone_conference	主席	-
   设置主讲人	tsdk_set_presenter	主席 会议主讲人	会议类型为TSDK_E_CONF_MEDIA_VOICE_DATA或TSDK_E_CONF_MEDIA_VIDEO_DATA支持。
   申请主讲人	tsdk_request_presenter	与会者	会议类型为TSDK_E_CONF_MEDIA_VOICE_DATA或TSDK_E_CONF_MEDIA_VIDEO_DATA支持。
   设置会议录播	tsdk_set_record_broadcast	主席	-
   设置会议直播	tsdk_set_live_broadcast	主席	-

   代码示例：

   -(BOOL)confCtrlMuteConference:(BOOL)isMute
   {    
       TSDK_BOOL tupBool = isMute ? TSDK_TRUE : TSDK_FALSE;   
       int result = tsdk_mute_conference(_confHandle, tupBool);       
       return result == TSDK_SUCCESS ? YES : NO;
   }

    
2. SDK在收到会控请求的响应后，向UI上报会控操作结果事件TSDK_E_CONF_EVT_CONFCTRL_OPERATION_RESULT。
3. 主席侧和其他与会者侧SDK收到会议成员列表刷新通知，向UI上报会议成员列表刷新事件TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE，UI刷新会议页面。
   说明： 

   详细流程参见“更新会议状态信息和与会者列表”描述。

注意事项

无。

更新会议状态信息和与会者列表

描述

会议过程中，会议状态或与会者成员状态发生变化时，服务器会推送变更通知，应用程序界面应刷新相应的状态以提示用户。

说明： 

1. 会议状态当前包括锁定状态、闭音状态和是否录播状态；
2. 会议成员状态当前包括与会者加入、退出、挂断、闭音、举手和角色变更。

主席和与会者均已在会议中。

业务流程

图4 更新会议状态信息和与会者列表流程 

1. SDK在收到服务器的与会者列表更新通知后，向UI上报与会者列表更新事件TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE。
   说明： 

   事件对应的数据结构TSDK_S_CONF_STATUS_INFO中：

   • is_record，表示会场录音状态，为true时，应用程序界面应提示与会者当前处于录音状态；
   • is_all_mute，表示会场静音状态，为true时，应用程序界面应提示与会者当前处于会场闭音状态，除主席外，均可听不可说；
   • subject，会议主题，不为空时，应用程序界面应显示此主题，在会议创建时已确定，首次获取后，不会再有变更；
   • is_hd_conf，高清视频会议，为true时，会议视频为高清视频；
   • conf_media_type，会议媒体类型，参考结构体TSDK_E_CONF_MEDIA_TYPE；
   • conf_state，会议状态，参考结构体TSDK_E_CONF_STATE；
   • update_type，表示成员更新方式，支持无更新、全量更新、增量增加、增量修改和增量删除，目前以全量同步的方式进行更新；
   • attendee_num，当前会议中的与会者个数；
   • attendee_list，与会者的详细信息，包括用户标识、名称、号码、闭音状态、静音状态、举手状态、用户状态、角色和支持的媒体类型，应用程序界面需要根据相应字段显示与会者的信息和状态；
   • is_live_broadcast，表示会场直播状态，为true时，应用程序应提示与会者当前出于直播状态 ;
   • is_support_live_broadcast，表示会场是否支持直播 ;
   • is_support_record_broadcast，表示会场是否支持录播.
   代码示例：

   case TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE:        
   {            
       DDLogInfo(@"TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE");                        
       [self handleAttendeeUpdateNotify:notify];        
   }           
   break;

    

注意事项

无。

显示发言人

描述

会议过程中，应用程序显示服务器推送的当前发言人信息。

与会者均已在会议中。

业务流程

图5 显示发言人流程 

1. SDK在收到服务器的发言人通知后，向UI上报发言人通知事件TSDK_E_CONF_EVT_SPEAKER_IND，携带当前发言人的数量、发言人号码和发言音量信息。
   说明： 

   当存在多个发言人时，建议应用程序界面按音量大小，显示第一发言人和第二发言人。

注意事项

无。