入門使用
會(huì)議控制
更新時(shí)間：2019-11-20
退出和結(jié)束會(huì)議
描述
普通與會(huì)者和主席均可在會(huì)議中主動(dòng)退出會(huì)議，主席可以結(jié)束會(huì)議。
說明：
若主席退出會(huì)議，則會(huì)議中無主席，預(yù)約會(huì)議時(shí)，原主席可以通過主席接入信息重新加入會(huì)議獲取主席；當(dāng)會(huì)議中無任何與會(huì)者時(shí)，會(huì)議也會(huì)自動(dòng)結(jié)束。
與會(huì)者已在會(huì)議中。
業(yè)務(wù)流程
一、退出會(huì)議
-
普通與會(huì)者或主席側(cè)UI調(diào)用tsdk_leave_conference()主動(dòng)退出會(huì)議。
說明：
在主動(dòng)離開會(huì)議過程中，sdk層會(huì)主動(dòng)掛斷通話，然后才離開會(huì)議。
代碼示例：-(BOOL)confCtrlLeaveConference { int result = tsdk_leave_conference(_confHandle); return result == TSDK_SUCCESS ? YES : NO; } -
普通與會(huì)者或主席側(cè)SDK在收到“退出會(huì)議”請(qǐng)求的響應(yīng)后，向UI上報(bào)刪除呼叫id事件TSDK_E_CALL_EVT_CALL_DESTROY。
代碼示例：
case TSDK_E_CALL_EVT_CALL_DESTROY: { [self respondsCallDelegateWithType:CALL_DESTROY result:nil]; } - 其他與會(huì)者側(cè)SDK收到會(huì)議成員列表刷新通知，向UI上報(bào)會(huì)議成員列表刷新事件TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE，UI刷新會(huì)議成員列表。
二、結(jié)束會(huì)議
-
主席側(cè)UI調(diào)用tsdk_end_conference()結(jié)束會(huì)議。
說明：
應(yīng)用程序界面在關(guān)閉會(huì)議時(shí)應(yīng)為主席提供“退出會(huì)議”和“結(jié)束會(huì)議”的選擇入口。
代碼示例：-(BOOL)confCtrlEndConference { int result = tsdk_end_conference(_confHandle); return result == TSDK_SUCCESS ? YES : NO; } - 其他與會(huì)者側(cè)SDK收到會(huì)議結(jié)束通知，向UI上報(bào)會(huì)議結(jié)束事件TSDK_E_CONF_EVT_CONF_END_IND，UI提示用戶會(huì)議結(jié)束。
注意事項(xiàng)
無。
基礎(chǔ)會(huì)控操作
描述
在會(huì)議中進(jìn)行基礎(chǔ)的會(huì)議控制操作。
業(yè)務(wù)流程
-
UI調(diào)用會(huì)議基礎(chǔ)控制接口（如表1），實(shí)現(xiàn)會(huì)議控制相關(guān)操作。
表1 會(huì)議控制操作 會(huì)控類型
接口
權(quán)限
說明
閉音會(huì)場(chǎng)
tsdk_mute_conference
主席
設(shè)置會(huì)議閉音后，除主席外，其他所有與會(huì)者均不可說（只可聽）。
添加與會(huì)者
tsdk_add_attendee
主席
支持邀請(qǐng)一個(gè)或多個(gè)與會(huì)者。
重?fù)芘c會(huì)者
tsdk_redial_attendee
主席
-
掛斷與會(huì)者
tsdk_hang_up_attendee
主席
掛斷在會(huì)議中的與會(huì)者。
刪除與會(huì)者
tsdk_remove_attendee
主席
踢出與會(huì)者（正在會(huì)議中的）、移除已離會(huì)的與會(huì)者和取消正在邀請(qǐng)的與會(huì)者。
閉音與會(huì)者
tsdk_mute_attendee
主席
普通與會(huì)者
設(shè)置閉音后，該與會(huì)者不可說(只聽)。
會(huì)議主席在會(huì)議中設(shè)置或取消其他與會(huì)者閉音，普通與會(huì)者設(shè)置或取消自己閉音。
舉手
tsdk_set_handup
主席
普通與會(huì)者
會(huì)議主席在會(huì)議中取消其他與會(huì)者舉手，所有與會(huì)者設(shè)置或取消自己舉手。
設(shè)置會(huì)議視頻模式
tsdk_set_video_mode
主席
在CloudEC解決方案下，支持的視頻會(huì)議模式有“廣播與會(huì)者模式”、“聲控模式”和“自由討論模式”。
觀看與會(huì)者
tsdk_watch_attendee
主席
普通與會(huì)者
AVC 會(huì)議：只需要指定待選看的與會(huì)者號(hào)碼，每次指定選看一個(gè)與會(huì)者。
SVC會(huì)議：
- 除指定待選看的與會(huì)者號(hào)碼外，還應(yīng)該指定"SVC Label"，以及待選看的分辨率(寬和高)，且“SVC Label”與“分辨率”必須與“綁定SVC視頻窗口”時(shí)填寫的參數(shù)相對(duì)應(yīng)。
- 更新選看時(shí)，需要全量指定所有選看信息(一大多少)。
- 若指定的待選看與會(huì)者號(hào)碼為空(僅支持大窗口)，則所選看的與會(huì)者由系統(tǒng)自動(dòng)推送。
廣播與會(huì)者
tsdk_broadcast_attendee
主席
會(huì)議視頻模式為“廣播與會(huì)者模式”時(shí)主席可以指定廣播與會(huì)者。
申請(qǐng)主席
tsdk_request_chairman
普通與會(huì)者
-
釋放主席
tsdk_release_chairman
主席
-
延長(zhǎng)會(huì)議
tsdk_postpone_conference
主席
-
設(shè)置主講人
tsdk_set_presenter
主席
會(huì)議主講人
會(huì)議類型為TSDK_E_CONF_MEDIA_VOICE_DATA或TSDK_E_CONF_MEDIA_VIDEO_DATA支持。
申請(qǐng)主講人
tsdk_request_presenter
與會(huì)者
會(huì)議類型為TSDK_E_CONF_MEDIA_VOICE_DATA或TSDK_E_CONF_MEDIA_VIDEO_DATA支持。
設(shè)置會(huì)議錄播
tsdk_set_record_broadcast
主席
-
設(shè)置會(huì)議直播
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; } - SDK在收到會(huì)控請(qǐng)求的響應(yīng)后，向UI上報(bào)會(huì)控操作結(jié)果事件TSDK_E_CONF_EVT_CONFCTRL_OPERATION_RESULT。
- 主席側(cè)和其他與會(huì)者側(cè)SDK收到會(huì)議成員列表刷新通知，向UI上報(bào)會(huì)議成員列表刷新事件TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE，UI刷新會(huì)議頁面。
注意事項(xiàng)
無。
更新會(huì)議狀態(tài)信息和與會(huì)者列表
描述
會(huì)議過程中，會(huì)議狀態(tài)或與會(huì)者成員狀態(tài)發(fā)生變化時(shí)，服務(wù)器會(huì)推送變更通知，應(yīng)用程序界面應(yīng)刷新相應(yīng)的狀態(tài)以提示用戶。
說明：
- 會(huì)議狀態(tài)當(dāng)前包括鎖定狀態(tài)、閉音狀態(tài)和是否錄播狀態(tài)；
- 會(huì)議成員狀態(tài)當(dāng)前包括與會(huì)者加入、退出、掛斷、閉音、舉手和角色變更。
主席和與會(huì)者均已在會(huì)議中。
業(yè)務(wù)流程
-
SDK在收到服務(wù)器的與會(huì)者列表更新通知后，向UI上報(bào)與會(huì)者列表更新事件TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE。
說明：
事件對(duì)應(yīng)的數(shù)據(jù)結(jié)構(gòu)TSDK_S_CONF_STATUS_INFO中：
- is_record，表示會(huì)場(chǎng)錄音狀態(tài)，為true時(shí)，應(yīng)用程序界面應(yīng)提示與會(huì)者當(dāng)前處于錄音狀態(tài)；
- is_all_mute，表示會(huì)場(chǎng)靜音狀態(tài)，為true時(shí)，應(yīng)用程序界面應(yīng)提示與會(huì)者當(dāng)前處于會(huì)場(chǎng)閉音狀態(tài)，除主席外，均可聽不可說；
- subject，會(huì)議主題，不為空時(shí)，應(yīng)用程序界面應(yīng)顯示此主題，在會(huì)議創(chuàng)建時(shí)已確定，首次獲取后，不會(huì)再有變更；
- is_hd_conf，高清視頻會(huì)議，為true時(shí)，會(huì)議視頻為高清視頻；
- conf_media_type，會(huì)議媒體類型，參考結(jié)構(gòu)體TSDK_E_CONF_MEDIA_TYPE；
- conf_state，會(huì)議狀態(tài)，參考結(jié)構(gòu)體TSDK_E_CONF_STATE；
- update_type，表示成員更新方式，支持無更新、全量更新、增量增加、增量修改和增量刪除，目前以全量同步的方式進(jìn)行更新；
- attendee_num，當(dāng)前會(huì)議中的與會(huì)者個(gè)數(shù)；
- attendee_list，與會(huì)者的詳細(xì)信息，包括用戶標(biāo)識(shí)、名稱、號(hào)碼、閉音狀態(tài)、靜音狀態(tài)、舉手狀態(tài)、用戶狀態(tài)、角色和支持的媒體類型，應(yīng)用程序界面需要根據(jù)相應(yīng)字段顯示與會(huì)者的信息和狀態(tài)；
- is_live_broadcast，表示會(huì)場(chǎng)直播狀態(tài)，為true時(shí)，應(yīng)用程序應(yīng)提示與會(huì)者當(dāng)前出于直播狀態(tài) ;
- is_support_live_broadcast，表示會(huì)場(chǎng)是否支持直播 ;
- is_support_record_broadcast，表示會(huì)場(chǎng)是否支持錄播.
代碼示例：case TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE: { DDLogInfo(@"TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE"); [self handleAttendeeUpdateNotify:notify]; } break;
注意事項(xiàng)
無。
顯示發(fā)言人
描述
會(huì)議過程中，應(yīng)用程序顯示服務(wù)器推送的當(dāng)前發(fā)言人信息。
與會(huì)者均已在會(huì)議中。
業(yè)務(wù)流程
-
SDK在收到服務(wù)器的發(fā)言人通知后，向UI上報(bào)發(fā)言人通知事件TSDK_E_CONF_EVT_SPEAKER_IND，攜帶當(dāng)前發(fā)言人的數(shù)量、發(fā)言人號(hào)碼和發(fā)言音量信息。
說明：
當(dāng)存在多個(gè)發(fā)言人時(shí)，建議應(yīng)用程序界面按音量大小，顯示第一發(fā)言人和第二發(fā)言人。
注意事項(xiàng)
無。
