主頁（http://www.130131.com）：微網(wǎng)信通：天翼對講-云對講

項目概要 / Project Summary

本項目主要是開發(fā)QChat 5.2 視頻對講客戶端，本客戶端是集天翼對講功能和實時視頻功能為一體的客戶端產(chǎn)品。 客戶端和平臺解決方案主要用于政企行業(yè)用戶， 大眾用戶通過可下載的方式也可以使用。

天翼對講功能包括單呼、預(yù)定義組呼、臨時組呼與管理、聊天室呼叫、多媒體分享、集團(tuán)通訊錄、呼叫限制、狀態(tài)設(shè)置、其他對講相關(guān)的配置、數(shù)據(jù)更新等。

實時視頻功能包括視頻直播功能（向平臺或調(diào)度臺發(fā)起現(xiàn)場直播）、視頻電話、群組視頻

總體架構(gòu) / Overall structure

本項目軟件總體架構(gòu)圖如下圖所示。

如上圖所示， 紅色線框內(nèi)為客戶端產(chǎn)品的基本框架， 藍(lán)色線框內(nèi)為客戶端產(chǎn)品的開發(fā)內(nèi)容， 外圍是依賴的系統(tǒng)或平臺。 客戶端包括天翼對講、 通訊錄、 客戶端設(shè)置、后臺服務(wù)四塊內(nèi)容。

天翼對講 / Tianyi intercom

天翼對講功能由 QChat 5.2 SDK 提供接口支持，視頻方面由 Video SDK 提供支持。天翼對講可實現(xiàn)單呼、組呼、多媒體分享等功能， 這些功能已在 SDK 中實現(xiàn)，客戶端重點在UI 設(shè)計和業(yè)務(wù)邏輯設(shè)計。

撥號盤

用戶可以通過撥號發(fā)起一個對講。撥號盤應(yīng)有彈出撥號、關(guān)閉隱藏兩種狀態(tài)。隱藏時應(yīng)懸浮一個圖標(biāo)在天翼對講的選項卡主界面。撥號盤在用戶輸入號碼（號碼數(shù)大于 3 個）時應(yīng)從數(shù)據(jù)庫中搜索匹配的用戶并顯示匹配和推薦的號碼表（包括號碼對應(yīng)的姓名）。

用戶群組

通訊錄即是用戶群組。 這里說的通訊錄和手機(jī)自帶的聯(lián)系人是不一樣的，是單獨維護(hù)的集團(tuán)用戶和群組信息。

用戶群組數(shù)據(jù)是通過 QChat SDK 從天翼對講平臺獲取的，部分用戶信息如部門等屬性可以 從微信通平臺獲取。 用戶群組數(shù)據(jù)應(yīng)緩存在本地的數(shù)據(jù)庫中，以便于獲取數(shù)據(jù)后可以快速的加載、查找、展示用戶和群組信息。

用戶信息是不可手動編輯修改的，所以不用額外的管理工作。群組分預(yù)定義組和臨時組兩種， 預(yù)定義組是通過平臺管理的，本地不可手動編輯修改，也不用額外的管理功能。但臨時組完全是在客戶端上手動增刪改的，需要臨時組管理功能。 群組除了包括群組自身的信息外，還包括群組成員信息。 添加臨時組成員時，應(yīng)支持從現(xiàn)有的用戶中選擇添加。 一個用戶可以在多個群組中。

消息記錄

消息記錄包括通話記錄、多媒體分享記錄、聊天記錄。消息記錄 UI 應(yīng)以會話列表的形式呈現(xiàn)， 點擊一個會話可進(jìn)入一個類聊天的界面， 在該界面下可以選擇發(fā)起呼叫、發(fā)起視頻直播、發(fā)送文字、發(fā)送表情、發(fā)送圖片、發(fā)送語音/錄音、發(fā)送視頻、發(fā)送位置信息， 可以參考 QQ 消息設(shè)計。 該會話的另一方可以是單用戶，也可以是群組。長按一條會話，可彈出刪除菜單；向左滑動一條會話可顯示出呼叫（單呼或組呼）、視頻（如果對方是單用戶，則發(fā)起雙向視頻直播；如果是群組，則發(fā)起群組呼叫后，對其他群組成員進(jìn)行直播）兩個按鈕。

多媒體分享

多媒體分享實際上是發(fā)送文字、表情、照片、位置信息、 錄音片段、視頻片段、其他格式的文件（如 TXT、 Word 文檔等，格式不限）給其他單一用戶或群組。 多媒體分享不是一個獨立的功能，可以在會話中進(jìn)行多媒體分享，也可以在對講過程中進(jìn)行多媒體分享。 會話中的多媒體分享和 QQ 中的聊天很相似，可以參考。多媒體分享調(diào)用的是 QChat 5.2 SDK 提供的相關(guān)接口，需要注意的是，只能對 QChat客戶端為 5.2 版本的用戶進(jìn)行多媒體分享。

視頻直播

視頻直播指用戶可向調(diào)度臺、單一用戶、群組等對象發(fā)起現(xiàn)場實時視頻。 該功能需調(diào)用Video SDK、 QChat 5.2 SDK 等接口聯(lián)合實現(xiàn)，并需加入相應(yīng)的業(yè)務(wù)邏輯。Video SDK 視頻直播的原理是：首先客戶端連接到視頻服務(wù)器后，請求直播；服務(wù)器收到請求后返回允許直播，生成直播 ID，并生成可觀看的視頻源的 url；客戶端采集現(xiàn)場視頻，編碼打包后發(fā)給服務(wù)器；服務(wù)器解碼后更新視頻源。 直播方將服務(wù)器生成的直播源 url發(fā)送（通過 QChat 5.2 SDK 的多媒體分享接口） 給對方（單一用戶或群組）后，對方即可觀看直播。

視頻電話

視頻電話其實就是雙向的視頻直播。

群組視頻

群組視頻就是在一個群組對講中，其中一個成員向其他成員發(fā)起視頻直播的功能。 一個成員開始直播時，從服務(wù)器獲取直播源 url，然后通過 QChat SDK 將該 url 發(fā)送給群組其他成員，其他成員收到后進(jìn)行播放；直播結(jié)束后也應(yīng)通知其他成員。群組內(nèi)一次只能進(jìn)行一個直播， 當(dāng)一個成員正在直播時，其他成員不能發(fā)起直播；只有當(dāng)前直播的成員結(jié)束直播后，其他成員才可以繼續(xù)發(fā)起直播。組呼時，因為一些原因，部分成員在群組對講進(jìn)行了一段時間后才加入到對講中（稱為遲后加入），如果當(dāng)前有成員正在直播，則發(fā)起直播的成員應(yīng)自動將直播源 url發(fā)送給剛剛加入的成員。

臨時組管理

臨時組是在客戶端上用戶全權(quán)管理的（平臺臨時組除外）， 包括臨時組自身的增刪改查，包括臨時組組成員的增刪改查。平臺臨時組表示在微信通平臺上創(chuàng)建的臨時組， 這種臨時組從微網(wǎng)信通平臺下載，用戶可以從本地刪除該群組，但是不能修改名其稱，不能管理其成員。 所以臨時組有兩種類型：添加臨時組成員時，應(yīng)支持從現(xiàn)有的用戶中選擇添加、支持從其他預(yù)定義組或臨時組中選擇添加。一個用戶可以在多個群組中，但一個群組中同一個用戶只能有一個。臨時組屬性：臨時組 ID，臨時組名稱， 臨時組類型， 其他開發(fā)者認(rèn)為所需的屬性。臨時組成員屬性：成員號碼或 ID，成員名稱， 成員類型（ 包括用戶， 預(yù)定義組、 聊天室、 臨時組， 即一個臨時組可以包含其他群組）， 其他開發(fā)者認(rèn)為所需的屬性。不同群組中的同一個成員（ 成員號碼或 ID相同），顯示名稱可以是不一樣的。

狀態(tài)設(shè)置

天翼對講狀態(tài)有很多中，常見的有在線、免打擾、離開、忙碌、離線退出 5 種。 通過QChat SDK 提供的接口可設(shè)置用戶 QChat 的狀態(tài)。 天翼對講狀態(tài)和 QQ 的狀態(tài)（我在線上、隱身、離線等）是非常相似的。