starrtc-server是一款免費(fèi)IM系統(tǒng)，IM即時(shí)通信消息系統(tǒng)(含一對(duì)一文字聊天，群聊，聊天室)，免費(fèi)一對(duì)一voip實(shí)時(shí)通話，錄屏，webrtc服務(wù)端，免費(fèi)直播連麥，互動(dòng)直播，視頻直播，RTSP拉流，RTMP推流，語(yǔ)音對(duì)講，免費(fèi)在線會(huì)議，視頻會(huì)議等服務(wù)端程序，支持物聯(lián)網(wǎng)平臺(tái)。

服務(wù)端程序免費(fèi)私有部署

以下服務(wù)端均完全免費(fèi)(采用C語(yǔ)言開(kāi)發(fā))，無(wú)鑒權(quán)，可用于騰訊云，阿里云或局域網(wǎng)內(nèi)部署，現(xiàn)已開(kāi)放:

voipServer：一對(duì)一視頻通話(需要搭配msgServer使用)

msgServer：?jiǎn)瘟?如文字聊天)，私信，信令

chatDBServer：離線消息存儲(chǔ)

groupServer：群聊(如果只需要單聊，不需要群聊的話，不用啟動(dòng))

chatRoomServer：多人聊天室

liveSrcServer：多人視頻會(huì)議 RTMP推流

liveVdnServer：互動(dòng)連麥直播，vdn分發(fā)網(wǎng)絡(luò)

liveProxyServer：RTSP 拉流服務(wù)端

videoRecServer：錄制錄像功能

groupPushHttpProxy：系統(tǒng)消息及群操作功能

web-supported目錄里面是支持web端的服務(wù)端程序與自簽名證書(shū)。do-not-support-web目錄里面的服務(wù)端程序不支持web端。

支持CentOS 64bit，Ubuntu 64bit。Windows上請(qǐng)自行安裝虛擬機(jī)(請(qǐng)使用橋接)或docker測(cè)試。

部署步驟(請(qǐng)切換為root用戶或者用sudo執(zhí)行)：

第1步：下載服務(wù)端程序。

然后進(jìn)入相應(yīng)目錄，直接執(zhí)行chmod +x *.sh && ./start.sh 即部署成功!如果想單獨(dú)運(yùn)行，請(qǐng)繼續(xù)下面的步驟。

第2步：進(jìn)入相應(yīng)目錄，給所有服務(wù)端程序加可執(zhí)行權(quán)限: chmod +x *Server

第3步：部署各服務(wù)端程序，具體如下：

其中.log后綴文件為日志文件，可通過(guò)命令tail -f xxx.log查看相關(guān)日志。

voip服務(wù)端部署

后臺(tái)啟動(dòng)：nohup ./voipServer > voipServer.log 2>&1 &剛開(kāi)始為了驗(yàn)證是否啟動(dòng)成功，可以不后臺(tái)啟動(dòng)，而是通過(guò)運(yùn)行 ./voipServer 直接看輸出日志是否成功，成功了以后就可以后臺(tái)啟動(dòng)。

注：也需要部署msgServer,用于傳輸呼叫，接聽(tīng)等消息。

IM服務(wù)端部署

IM全套服務(wù)，分為3個(gè)服務(wù)端程序，分別是:

消息服務(wù)端msgServer、離線消息數(shù)據(jù)服務(wù)端chatDBServer，群管理服務(wù)端groupServer，分別啟動(dòng)即可。

只需要單聊的，不需要啟動(dòng)groupServer。

可以保持自己原有的im系統(tǒng)不變，用我們的im系統(tǒng)作為voip等服務(wù)的信令服務(wù)。

 后臺(tái)啟動(dòng)：nohup ./msgServer > msgServer.log 2>&1 &nohup ./chatDBServer > chatDBServer.log 2>&1 &nohup ./groupServer > groupServer.log 2>&1 &

chatRoom服務(wù)端部署

后臺(tái)啟動(dòng)：nohup ./chatRoomServer > chatRoomServer.log 2>&1 &

  liveSrc服務(wù)端部署

后臺(tái)啟動(dòng)：nohup ./liveSrcServer > liveSrcServer.log 2>&1 &

RTMP推流測(cè)試:可打開(kāi)安卓客戶端，新建一個(gè)會(huì)議室，點(diǎn)擊RTMP推流，填上RTMP URL后，點(diǎn)擊推流即可。然后用其它第3方播放器如VLC就可以打開(kāi)該RTMP URL觀看會(huì)議畫(huà)面了。

同理，可以在直播間推流，用vlc打開(kāi)就可以觀看直播了。

liveVdn服務(wù)端部署

互動(dòng)直播，觀眾不限人數(shù)

 后臺(tái)啟動(dòng)：nohup ./liveVdnServer > liveVdnServer.log 2>&1 &

錄制服務(wù)端(videoRecServer)部署

目前用于liveSrcServer和voipServer的視頻錄像功能，目前為測(cè)試版，輸出為ts文件，支持自定義切片或不切片，音頻只支持AAC格式。

videoRecServer默認(rèn)是切片模式，30s一片，若不切片，請(qǐng)?jiān)诔绦蛲?jí)目錄中新建starrtc.conf文本文件，寫(xiě)入recSegMode=off，即關(guān)閉切片模式，不切片的時(shí)候切片序號(hào)一直為0。

文件目錄格式為：

在線會(huì)議或互動(dòng)直播:

./RECFOLDER/liveChannels/用戶名/resSessionId_用戶名_切片序號(hào).ts，如./RECFOLDER/liveChannels/tom/1573119917990_tom_0.ts

一對(duì)一視頻通話(VOIP):

./RECFOLDER/voips/用戶名/resSessionId_用戶名_切片序號(hào).ts，如./RECFOLDER/voips/tom/1573119917990_tom_0.ts

其中，sessionId在移動(dòng)端SDK中獲取得到，詳見(jiàn)android文檔。

后臺(tái)啟動(dòng)：nohup ./videoRecServer > videoRecServer.log 2>&1 &

系統(tǒng)消息及群操作功能服務(wù)

用戶使用AEC高級(jí)模式的情況下使用，比如給某用戶發(fā)送系統(tǒng)消息(例如購(gòu)買(mǎi)消費(fèi)成功通知)，或給某個(gè)群的全部用戶發(fā)送群系統(tǒng)消息(例如某人進(jìn)群、退群)。

請(qǐng)注意該服務(wù)僅供內(nèi)網(wǎng)其他服務(wù)使用，不要將19922端口暴露到外網(wǎng)!

push系統(tǒng)消息:toUsers：需要發(fā)送消息的所有用戶，用逗號(hào)隔開(kāi)msg： 需要發(fā)送的文本內(nèi)容digest： 需要發(fā)送的文本內(nèi)容的摘要，用于用戶不在線時(shí)的push推送使用http://www.xxx.com:19922/pushSystemMsgToUsers?toUsers=userId1,userId2,userId3,...&msg=xxxx&digest=xxxxpush群消息(全員): http://www.xxx.com:19922/pushGroupMsg?groupId=xxx&msg=xxxx

下面五個(gè)和群有關(guān)的接口，在客戶端sdk同樣有實(shí)現(xiàn)，但通過(guò)這些接口，服務(wù)端可以主動(dòng)給群服務(wù)器同步群成員，或?qū)θ撼蓡T進(jìn)行其他操作，請(qǐng)您根據(jù)實(shí)際需求來(lái)選取合適的群成員同步策略。

同步群成員:groupId: 群idgroupList: 所有群成員，用逗號(hào)隔開(kāi)，不傳groupList表示清空這個(gè)群的成員ignoreList： 對(duì)該群設(shè)置了消息免打擾的群成員id，用逗號(hào)隔開(kāi)http://www.xxx.com:19922/syncGroupList?groupId=xxx&groupList=userId1,userId2,userId3,...&ignoreList=userId1,userIdx,...添加群成員: addedUsers: 要添加進(jìn)的群的所有用戶id，用逗號(hào)隔開(kāi)http://www.xxx.com:19922/addUsersToGroup?groupId=xxx&addedUsers=userId1,userId2,userId3,...刪除群成員: deledUsers: 需要從群內(nèi)刪除的所有用戶id，用逗號(hào)隔開(kāi)http://www.xxx.com:19922/delUsersFromGroup?groupId=xxx&deledUsers=userId1,userId2,userId3,...設(shè)置免打擾:ignoreList: 對(duì)該群設(shè)置消息免打擾(不接收群消息)的所有用戶id，用逗號(hào)隔開(kāi)http://www.xxx.com:19922/setPushIgnore?groupId=xxx&ignoreList=userId1,userIdx,...取消免打擾:ignoreList: 對(duì)該群取消免打擾(接收群消息)的所有用戶id，用逗號(hào)隔開(kāi)http://www.xxx.com:19922/unsetPushIgnore?groupId=xxx&ignoreList=userId1,userIdx,...

拉流服務(wù)端部署

用于拉取第三方rtsp流(RTMP流暫未開(kāi)放)，轉(zhuǎn)換為starRTC協(xié)議后轉(zhuǎn)發(fā)到liveSrcServer， 然后就可以在各終端(Android,iOS,PC和web)的在線會(huì)議或互動(dòng)直播中播放這個(gè)流了。

后臺(tái)啟動(dòng)：nohup ./liveProxyServer > liveProxyServer.log 2>&1 &

測(cè)試方法：首先找到一個(gè)可以正常播放的rtsp流(也可以使用示例程序里面的默認(rèn)測(cè)試流)， 然后可以打開(kāi)安卓示例程序，打開(kāi)設(shè)置-》第3方流測(cè)試-》新建一個(gè)流，填一下名字，和流的rstp地址(也可以不填直接使用默認(rèn)的測(cè)試流)， 同時(shí)選擇該流是在直播中播放，還是在會(huì)議中播放。 然后去直播間或會(huì)議室就可以看到拉的視頻流畫(huà)面了。

也可以自己使用HTTP方式調(diào)用：

1 創(chuàng)建channelId并拉流(streamType暫時(shí)只支持rtsp)，接口返回channelId：

http://www.xxx.com:19932/push?streamType=rtsp&streamUrl=rtsp://184.72.239.149/vod/mp4://BigBuckBunny_175k.mov&roomLiveType=0&roomId=xxxx&extra=xxxxx

其中roomId和extra為可選參數(shù)

2 拉流到指定的channelId：

http://www.xxx.com:19932/push?streamType=rtsp&streamUrl=rtsp://184.72.239.149/vod/mp4://BigBuckBunny_175k.mov&channelId=xxxx

3 停止拉流(不刪除channelId，仍在列表中存在)：

http://www.xxx.com:19932/close?channelId=xxxx

4 停止拉流，同時(shí)刪除channelId：

http://www.xxx.com:19932/delete?channelId=xxxx

測(cè)試方法

下載客戶端示例程序，

打開(kāi)"設(shè)置->服務(wù)器配置"，然后填寫(xiě)你自己的服務(wù)器ip即可(注意不要修改端口號(hào)，如果是域名不需要添加“http://”前綴)。