2、我们的语音通信形式

3.音频通话支持的平台有哪些？

支持的平台：Android iOS Windows。

4.如何开始?

我们为集成音频SDK提供了开发指南，此外我们针对SDK开发一个用于功能演示的Demo（下载地址）

目的是提供发送VoIP和互联网语音的能力接口。

1. 添加呼叫状态回调

原型：- ULSCall.addCallStateListener(CallStateListener listener)

功能：呼叫状态回调

返回：无

备注：每一发起新呼叫前调用函数,同时呼叫结束后系统会自动去除

参数：

2. 发起呼叫（不含回拨）

原型：- ULSCall.dial(Context mContext,ULSCallType callType,String calledNumner);

功能：发起VoIP语音(免费、直拨、智能)呼叫

返回：无

备注：

• 语音免费呼叫：SDK与SDK之间语音通话场景；
• 语音直拨呼叫：SDK与传统X手机（手机）语音通话场景；
• 语音智能呼叫：优先使用语音免费呼叫，呼叫失败自动转语音直拨呼叫场景；

参数：

3. 发起呼叫（透传参数）

原型：- ULSCall.dial(Context mContext,ULSCallType callType,String calledNumner,String userData);

功能：发起VOIP语音(免费、直拨、智能)呼叫

返回：无

备注：

• 语音免费呼叫：SDK与SDK之间语音通话场景；
• 语音直拨呼叫：SDK与传统固话（手机）语音通话场景；
• 语音智能呼叫：自动判断是使用P2P还是直拨；

参数：

4. 发起呼叫,支持P2P失败自动转直拨功能

原型：- ULSCall.dial(Context mContext,ULSCallType callType,String toClientId,String toPhone,String userData);

功能：发起VOIP语音(免费、直拨、智能)呼叫

返回：无

备注：

• 语音免费呼叫：SDK与SDK之间语音通话场景；
• 语音直拨呼叫：SDK与传统固话（手机）语音通话场景；
• 语音智能呼叫：优先使用语音免费呼叫，呼叫失败自动转语音直拨呼叫场景；

参数：

5. 发起回拨呼叫（被叫显号）

原型：- ULSCall.callBack(Context mContext,String caller,String callee);

功能：发起回拨呼叫，带显号功能

返回：无

备注：回拨呼叫：主被叫双方都是通过传统线路呼叫接通的场景，使用于网络条件比较差(2G)或者对语音质量要求比较高情况下使用(资费较高)。回拨显号：来电显示的号码，一般用于传统线路电话呼叫场景。

参数：

6. 发起回拨呼叫（指定显号与隐号）

原型：- ULSCall.callBack(Context mContext,String caller,String callee,String fromSerNum,String toSerMum);

功能：发起回拨呼叫，带显号功能

返回：无

备注：回拨呼叫：主被叫双方都是通过传统线路呼叫接通的场景，使用于网络条件比较差(2G)或者对语音质量要求比较高情况下使用(资费较高)。回拨显号：来电显示的号码，一般用于传统线路电话呼叫场景。

参数：

7. 释放通话

原型：- ULSCall.hangUp(String callid);

功能：挂断通话或拒绝接听

返回：无

备注：主叫方：外呼过程中或通话中，调用这个接口结束一路呼叫；被叫方：来电过程中或通话中，调用这个接口结束一路通话；

参数：

8. 被叫接听

原型：- ULSCall.answer(String callid);

功能：接听来电电话

返回：无

备注：用于被叫来电时，用户触发接听电话场景，被叫收到onIncomingCall事件后，可调用answer接口接听或调用reject接口拒绝接听。

参数：

9. 取消回拨

原型：- ULSCall. cancelCallBack (Context mContext,String callid);

功能：取消回拨呼叫

返回：无

备注：用于回拨呼叫发起后，主动取消呼叫的场景。

参数：

10. 发送DTMF

原型：- ULSCall.sendDTMF(String callid,String keyCode);

功能：发送DTMF信息

返回：无

备注：用于通话过程中发送DTMF场景。

参数：

11. 设置扬声器

原型：- ULSCall.setSpeakerphone(boolean isSpeakerphoneOn);

功能：设置扬声器状态，开启或关闭

返回：无

备注：用于通话过程中开启或关闭免提场景。

参数：

12. 获取扬声器状态

原型：- ULSCall.isSpeakerphoneOn();

功能：获取当前麦克风是否开启状态

返回：true：扬声器开启； false：扬声器关闭

备注：用于通话过程中判断扬声器是否开启场景。

参数：无

13. 设置静音

原型：- ULSCall.setMicMute(boolean isMicMute);

功能：设置静音状态，开启或关闭

返回：无

备注：用于通话过程中开启或关闭静音场景(开启后，自己能听到对方的声音，对方听不到自己的声音)。

参数：

14. 获取静音状态

原型：- ULSCall.isMicMute();

功能：获取当前静音是否开启状态

返回：true：静音开启； false：静音关闭

备注：用于通话过程中判断静音是否开启场景。

参数：无

15. 设置主叫当前手机号码

原型：- ULSCall.setSelfPhoneNumber(String phoneNumber);

功能：设置当前登录帐号的手机号码

返回：无

备注：语音通话中,被叫显示的号码,如果不设置,刚为隐藏号码。

参数：

1. 接到呼叫

原型：onIncoming(ULSCallIncomingInfo callInfo);

功能：来电话时候回调函数

返回：无

备注：用于通话，被叫侧接收到云平台下发呼叫的场景。应用接收到该事件后，需要提醒用户来电或者根据自己业务逻辑拒绝来电。

参数：

2. 主叫呼叫振铃中,用于通知主叫,被叫在响铃

原型：- onAlerting (String callid);

功能：呼叫振铃中,用于通知主叫,被叫在响铃

返回：无

备注：用于通话，主叫侧接收到云平台下发的呼叫回铃应答场景。外呼时，被叫如有回应，就返回该事件。当收到该事件时，对方会响起振铃音，本地会响起回铃音。

参数：

3. 被叫响铃

原型：- onRingIng (String callid);

功能：收到来电后，通知被叫前台，我开始响铃了

返回：无

备注：用于通话，被叫侧接收到云平台下发的呼叫确认,用于确定主收到回应

参数：

4. 被叫接听

原型：- onAnswer(String callid);

功能：通话被叫应答回调函数

返回：无

备注：用于通话，主叫侧接收到云平台下发的呼叫接听应答场景。外呼时，被叫如有回应接听，就返回该事件。当收到该事件时，表明对方已经应答接听，进入通话状态，应用需要提醒用户已经进入通话状态。

参数：

5. 呼叫失败

原型：- onCallFailed (String callid，ULSReason reason);

功能：通话呼叫失败回调函数

返回：无

备注：用于通话，主叫侧接收到云平台下发的呼叫失败应答场景。外呼时，如呼叫失败，就返回该事件。外呼失败的原因有很多，可以根据reason来判断。

参数：

6. 呼叫被释放

原型：- onHangUp(String callid，ULSReason reason);

功能：释放通话事件回调函数

返回：无

备注：用于通话，通话过程中主动释放通话场景。通话过程中，呼叫释放，就返回该事件。外呼过程中，呼叫释放，只调用onCallFailed事件代理。

参数：

7. 回拨成功

原型：- onCallBackSuccess(String callId);

功能：回拨成功事件回调函数

返回：无

备注：用于回拨呼叫场景。接收到云平台应答后，回调该接口。回拨失败原因有很多，可以根据reason来判断。

参数：

8. 取消回拨

原型：- onCancelCallBackStatus(String callId,ULSReason reason);

功能：取消回拨成功事件回调函数

返回：无

备注：用于取消回拨呼叫场景。接收到云平台应答后，回调该接口。回拨成功与失败原因有很多，可以根据reason来判断。

参数：

9. 准备发起呼叫

原型：- onCallReadyStart(String calledNumner);

功能：所有呼叫发起前通知前台

返回：无

备注：用于SDK通知前台我准备正式的发起呼叫,让开发者进行异步操作一些事情

参数：

10. 通话模块释放

原型：- onCallFinish();

功能：用于每一次通话结束后释放通知

返回：无

备注：用于通话，语音通话结束后，会进行回调该事件;回拨会在发起成功或者失败后,立即回调

参数：无