1、音頻、視頻開(kāi)發(fā)說(shuō)明
? 說(shuō)明
（1）實(shí)時(shí)音頻、實(shí)時(shí)視頻均通過(guò)相同的接口進(jìn)行調(diào)用
遵循相同的業(yè)務(wù)流程。不同的業(yè)務(wù)通過(guò)呼叫接口參數(shù)callType進(jìn)行區(qū)分，1視頻、0音頻。
（2）接口邏輯
接口調(diào)用是采取異步調(diào)用的方式。所有的呼叫相關(guān)接口的調(diào)用結(jié)果通過(guò)回調(diào)接口RL_YTX.onCallMsgListener來(lái)接受服務(wù)端返回的各種狀態(tài)。
（3）業(yè)務(wù)流程
a、客戶A呼叫客戶B發(fā)起請(qǐng)求
b、云通訊服務(wù)端收到A請(qǐng)求并把請(qǐng)求轉(zhuǎn)發(fā)給B
c、客戶B收到請(qǐng)求并應(yīng)答
d、云通訊服務(wù)端收到B應(yīng)答并轉(zhuǎn)發(fā)A
e、A收到應(yīng)答，通話建立。
? 設(shè)置音視頻展示標(biāo)簽 — 假設(shè)Tony想要和John 進(jìn)行視頻通話，要考慮如何在本地展示對(duì)方影像和自己影像。那么就需要設(shè)置頁(yè)面Video句柄。（發(fā)起視頻呼叫和接受視頻呼叫之前需要先調(diào)用此方法），示例代碼如下：
//view 是展示對(duì)方的影像或聲音
// localView是展示自己的影像或聲音
//這里的 view 和 localView 根據(jù)實(shí)際需要選擇video標(biāo)簽或者audio標(biāo)簽，要求是dom元素
RL_YTX.setCallView(view,localView)；
? 發(fā)送音視頻請(qǐng)求 — 假設(shè)Tony對(duì)John發(fā)起呼叫，示例代碼如下：
var makeCallBuilder= new RL_YTX.MakeCallBuilder();
makeCallBuilder.setCalled(‘John的號(hào)碼’);
makeCallBuilder.setCallType(1);//呼叫的類型 0 音頻 1視頻
RL_YTX.setCallView(view,localView)； //呼叫類型1的時(shí)候這么傳
// RL_YTX.setCallView(view,null)；//呼叫類型是0的時(shí)候這么傳
RL_YTX.makeCall(makeCallBuilder,
function(){
//呼叫成功
}, function callback(obj){
obj.code //錯(cuò)誤碼
})
? 接收音視頻請(qǐng)求 — John接收Tony的呼叫請(qǐng)求，示例代碼如下：
var voipAcceptBuilder = new RL_YTX.AcceptCallBuilder();
voipAcceptBuilder.setCallId(callId);//請(qǐng)求的callId，
voipAcceptBuilder.setCaller(caller);//請(qǐng)求的主叫號(hào)碼，即Tony的號(hào)碼
//通過(guò)RL_YTX.onCallMsgListener(callback)中的callback.callId屬性獲得callId
//通過(guò)RL_YTX.onCallMsgListener(callback)中的callback.caller屬性獲得caller
RL_YTX.accetpCall(voipAcceptBuilder,
function(){
}, function callback(obj){
alert(obj. code) //錯(cuò)誤碼
})
? 拒絕音視頻請(qǐng)求 — John 拒絕Tony的請(qǐng)求，示例代碼如下：
var VoipRejectBuilder = new RL_YTX.RejectCallBuilder();
VoipRejectBuilder.setCallId(callId);//請(qǐng)求的callId
VoipRejectBuilder.setCaller(caller);//請(qǐng)求的主叫號(hào)碼，即Tony的號(hào)碼
//通過(guò)RL_YTX.onCallMsgListener(callback)中的callback.callId屬性獲得callId
//通過(guò)RL_YTX.onCallMsgListener(callback)中的callback.caller屬性獲得caller
//通過(guò)RL_YTX.onCallMsgListener(callback)中的callback.reason屬性獲得reason
RL_YTX.rejectCall(VoipRejectBuilder,function(){
}, function(obj){
alert(obj.code)
})
? 取消音視頻 — Tony 呼叫John后需要取消呼叫，示例代碼如下：
var VoipReleaseBuilder = new RL_YTX.ReleaseCallBuilder();
VoipReleaseBuilder.setCallId(callId);//請(qǐng)求的callId
VoipReleaseBuilder.setCaller(caller);//請(qǐng)求的主叫號(hào)碼，即Tony的號(hào)碼
VoipReleaseBuilder.setCalled(called);// 請(qǐng)求的被叫號(hào)碼，即John的號(hào)碼
//通過(guò)RL_YTX.onCallMsgListener(callback)中的callback.callId屬性獲得callId
//通過(guò)RL_YTX.onCallMsgListener(callback)中的callback.caller屬性獲得called
//通過(guò)RL_YTX.onCallMsgListener(callback)中的callback.called屬性獲得caller
RL_YTX.releaseCall(VoipReleaseBuilder,function(){
}, function(obj){
alert(obj.code)
})
? H5設(shè)置編碼 — 在調(diào)用音頻/視頻錄制之前調(diào)用。示例代碼如下：
RL_YTX.setRecordVideo();
? 音視頻消息通知 — 客戶端監(jiān)聽(tīng)sdk的呼叫事件，根據(jù)obj.state區(qū)分調(diào)用哪些回調(diào)參數(shù)并進(jìn)行相應(yīng)的頁(yè)面邏輯處理。（在登錄成功的方法里面設(shè)置）示例代碼如下：
RL_YTX.onCallMsgListener(function(obj){
obj.callId;//唯一消息標(biāo)識(shí)
obj.caller;//主叫號(hào)碼
obj.called; //被叫無(wú)值
obj.callType;//0 音頻 1 視頻
obj.state;
//1 對(duì)方振鈴（被叫的振鈴消息） 2 呼叫中（主叫呼叫發(fā)送成功返回該值） 3 呼叫建立（被叫接收后主叫監(jiān)聽(tīng)到該值）
//4 呼叫失敗（對(duì)主叫；對(duì)方拒絕或者忙） 5 結(jié)束通話（主叫取消成功和主、被叫掛機(jī)成功后得到該值）
//6 呼叫到達(dá)（被叫監(jiān)聽(tīng)到呼叫請(qǐng)求時(shí)獲得該值）
//7 媒體已正式建立連接（被叫獲取該值）
obj.code;// 200操作成功，非200代表因本地原因，導(dǎo)致無(wú)法接受音視頻邀請(qǐng)(例如不支持音視頻等)，具體原因請(qǐng)參照錯(cuò)誤碼
}
文檔更新時(shí)間：2017年12月12日