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

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

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

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

msgServer：單聊(如文字聊天)，私信，信令

chatDBServer：離線消息存儲

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

chatRoomServer：多人聊天室

liveSrcServer：多人視頻會議 RTMP推流

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

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

videoRecServer：錄制錄像功能

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

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

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

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

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

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

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

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

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

voip服務(wù)端部署

后臺啟動：nohup ./voipServer > voipServer.log 2>&1 &剛開始為了驗證是否啟動成功，可以不后臺啟動，而是通過運行 ./voipServer 直接看輸出日志是否成功，成功了以后就可以后臺啟動。

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

IM服務(wù)端部署

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

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

只需要單聊的，不需要啟動groupServer。

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

 后臺啟動：nohup ./msgServer > msgServer.log 2>&1 &nohup ./chatDBServer > chatDBServer.log 2>&1 &nohup ./groupServer > groupServer.log 2>&1 &

chatRoom服務(wù)端部署

后臺啟動：nohup ./chatRoomServer > chatRoomServer.log 2>&1 &

  liveSrc服務(wù)端部署

后臺啟動：nohup ./liveSrcServer > liveSrcServer.log 2>&1 &

RTMP推流測試:可打開安卓客戶端，新建一個會議室，點擊RTMP推流，填上RTMP URL后，點擊推流即可。然后用其它第3方播放器如VLC就可以打開該RTMP URL觀看會議畫面了。

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

liveVdn服務(wù)端部署

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

 后臺啟動：nohup ./liveVdnServer > liveVdnServer.log 2>&1 &

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

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

videoRecServer默認是切片模式，30s一片，若不切片，請在程序同級目錄中新建starrtc.conf文本文件，寫入recSegMode=off，即關(guān)閉切片模式，不切片的時候切片序號一直為0。

文件目錄格式為：

在線會議或互動直播:

./RECFOLDER/liveChannels/用戶名/resSessionId_用戶名_切片序號.ts，如./RECFOLDER/liveChannels/tom/1573119917990_tom_0.ts

一對一視頻通話(VOIP):

./RECFOLDER/voips/用戶名/resSessionId_用戶名_切片序號.ts，如./RECFOLDER/voips/tom/1573119917990_tom_0.ts

其中，sessionId在移動端SDK中獲取得到，詳見android文檔。

后臺啟動：nohup ./videoRecServer > videoRecServer.log 2>&1 &

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

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

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

push系統(tǒng)消息:toUsers：需要發(fā)送消息的所有用戶，用逗號隔開msg： 需要發(fā)送的文本內(nèi)容digest： 需要發(fā)送的文本內(nèi)容的摘要，用于用戶不在線時的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

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

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

拉流服務(wù)端部署

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

后臺啟動：nohup ./liveProxyServer > liveProxyServer.log 2>&1 &

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

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

1 創(chuàng)建channelId并拉流(streamType暫時只支持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 停止拉流，同時刪除channelId：

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

測試方法

下載客戶端示例程序，

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