实时语音和实时视频的数据流量如下：
通过设置相应 CallDelegate 来监听呼叫过来的通话。
proxy.callDelegate = xx; //设置呼叫处理 delegate
/** * 发起语音呼叫 * @param peerName 对方用户ID * @param roomId 标识一次呼叫的唯一ID * @param extraData 附加信息 * @return true 表示调用成功 */ -(BOOL) audioCall:(NSString*)peerName roomId:(NSString*)roomId extraData:(NSData*)extraData;
/** * 发起视频呼叫 * @param peerName 对方用户ID * @param roomId 标识一次呼叫的唯一ID * @param extraData 附加信息 * @return true 表示调用成功 */ -(BOOL) videoCall:(NSString*)peerName roomId:(NSString*)roomId extraData:(NSData*)extraData;
/** * 接受视频呼叫 * @param extraData 附加信息 * @return true 表示调用成功 */ -(BOOL) acceptVideoCall:(NSData*)extraData; /** * 接受视频呼叫 * @param extraData 附加信息 * @return true 表示调用成功 */ -(BOOL) acceptAudioCall:(NSData*)extraData;
/** * 拒绝来电 * @return true 表示调用成功 */ -(BOOL) reject;
/** * 挂断呼叫 * @return true 表示调用成功 */ -(BOOL) hangup;
public class VoipVideoCapture { /** * VoipVideoCapture构造函数 * @param callback 此参数应传入VoipAndroid对象 * @param param 包含采集的宽高值 */ public VoipVideoCapture(VideoCaptureCallback callback, CaptureParam param); /** * 开启摄像头 * @param frontCamera 是否前置摄像头 * @param config 设备相关的配置，可从服务器获取得 * @param parentView 采集所用的SurfaceView的父View * @return * 0: 成功 * -1: 摄像头已经启动 * -2: 摄像头被禁用 * -3: 打开摄像头失败 * -4: 无法访问摄像头 */ public int start(boolean frontCamera,VoipConfig config, ViewGroup parentView); /** * 停止摄像头 */ public void stop(); /** * 暂时丢弃采集到的视频数据不处理 */ public void pause(); /** * 恢复对采集到的视频数据的处理 */ public void resume(); }
public class VoipAndroid { /** * VoipAndroid构造函数 * @param handle 目前已弃用该参数，可忽略 * @param context context对象 * @param jsonConfig 设备相关的配置，可从服务器获得 */ public VoipAndroid(Handler handler, Context context, JSONObject jsonConfig); /** * VoipAndriod初始化 * @param cpu CPU能力级别 * @param videoCapture VoipVideoCapture对象 * @param localAspectRatio 本地窗口宽高比：1024*高/宽 */ public void init(int cpu, VoipVideoCapture videoCapture, int localAspectRatio); /** * 注册音频回调函数 * @param audioCallback 实现了AudioCallback接口的对象 */ public void registerAudioCallback(AudioCallback audioCallback); /** * 注册视频回调函数 * @param videoCallback 实现了VideoCallback接口的对象 */ public void registerVideoCallback(VideoCallback videoCallback); /** * 反初始化 */ public void uninit(); /** * 获取版本号 * @return 版本字符串 */ public static native String version(); /** * 设置日志级别 * @param logLevel 日志的级别，0:ERROR; 1:WARNING; 2:INFO; 3:DEBUG */ public void setLogLevel(int logLevel); }
public class VoipAndroid { /** * 设置通话质量相关的参数 * @param qosJson 根据网络类型等信息从服务器获得 */ public void setQosParam(String qosJson); /** * 准备媒体的收发 * @param remote “group”表示群呼叫，否则为个人呼叫 * @param audioSdp 音频能力集 * @param videoSdp 视频能力集 * @param selfUserIdInGroup 本用户在群中的ID（csrc） */ public void startCall(String remote, String audioSdp, String videoSdp, int selfUserIdInGroup); /** * 启动音频传输 * @param activity Activity对象，用于调节音量等 * @param audioParam 音频参数 * @param userEarpiece 为TRUE时从听筒播放声音，为FALSE时从扬声器播放声音 */ public void startAudioPipeline(Activity activity, AudioParameter audioParam, boolean useEarpiece); /** * 启动视频传输 * @param videoParam 视频参数 */ public void startVideoPipeline(VideoParameter videoParam); /** * 停止媒体传输 */ public void stopCall(); /** * 起停音频的发送 * @param audioRecvOnly 为TRUE时，只接收不发送；为FALSE时，既接收又发送 */ public void setAudioRecvOnly(boolean audioRecvOnly); /** * 起停视频的发送 * @param videoRecvOnly 为TRUE时，只接收不发送；为FALSE时，既接收又发送 */ public void setVideoRecvOnly(boolean videoRecvOnly); /** * 暂停视频的传输 */ public void holdVideoPipeline(); /** * 恢复之前暂停的视频传输 */ public void resumeVideoPipeline(); }
public class VoipAndroid { /** * 更新群视频中的观察者人数 * @param observerCount 观察者人数 */ public void updateObserverCountInGroupCall(int observerCount); /** * 新的表演者加入群视频 * @param userId 新加入表演者的群内ID（csrc） */ public void performerJoinInGroupCall(int userId); /** * 表演者离开群视频 * @param userId 离开的表演者的群内ID（csrc） */ public void performerQuitGroupCall(int userId); }
public class VoipAndroid { /** * 设置自己预览视频的窗口参数 * @param sizeLevel 窗口的大小等级 * @param aspect 窗口的宽高比：1024*高/宽 */ public void setLocalWindow(WindowSizeLevel sizeLevel, int aspect); /** * 设置远端视频的窗口参数 * @param sizeLevel 窗口的大小等级 */ public void setRemoteWindow(WindowSizeLevel sizeLevel); }
public class VoipAndroid { /** * 停止音频设备 */ public void disableAudioIO(); /** * 启动音频设备 */ public void enableAudioIO(); /** * 重设音频的播放模式 * @param useEarpiece 之前保存的状态：为TRUE时从听筒播放；为FALSE时从扬声器播放 */ public void resetSpecialAudioDevice(boolean useEarpiece); /** * 将麦克风静音 */ public void muteMicrophone(); /** * 取消麦克风的静音 */ public void unmuteMicrophone(); /** * 当在通话中时，静音播放 */ public void muteSpeaker(); /** * 取消通话中的静音播放 */ public void unmuteSpeaker(); /** * 通话中时，将收到的对方声音静音播放 */ public void muteVoice(); /** * 取消通话中的对方声音的静音播放 */ public void unmuteVoice(); /** * 设置播放模式 * @param use 为TRUE时从听筒播放；为FALSE时从扬声器播放 */ public void setUseEarpiece(boolean use); /** * 蓝牙音频设备的设置 * @param on 为TRUE时表示链接了蓝牙音频设备，为FALSE时表示断开蓝牙音频设备 */ public void setBluetooth(boolean on); /** * 获取当前是否在吹气 * @return TRUE表示目前正在吹气；FALSE表示没有监测到吹气 */ public boolean audioIsWind(); /** * 获取当前语音的音量 * @return 当前音量的分贝值 */ public int audioDB(); /** * 设置游戏模式下的特殊音频处理 * @param isGameMode 是否在游戏模式下 */ public void setGameMode(boolean isGameMode); }
public class VoipAndroid { /** * 播放MP3文件 * @param activity Activity对象，用于调节音量 * @param uri MP3文件的URI地址 * @param fileName MP3文件的绝对路径 * @param cache 播放时是否缓存解码数据 * @param repeat 是否循环播放 * @param crescendo 是否渐强效果 * @param force 该参数已弃用 * @param useEarpiece 为TRUE表示从听筒播放，为FALSE表示从扬声器播放 * @param type 声音类型：提示音／铃声／音乐 */ public void playMp3File(Activity activity, final Uri uri, String fileName, boolean cache, final boolean repeat, boolean crescendo, boolean force, boolean useEarpiece, MP3_TYPE type); /** * 停止MP3文件的播放 * @param fileName MP3文件的绝对路径 */ public void stopMp3File(String fileName); /** * 停止所有的MP3文件播放 */ public void stopAllMp3Files(); /** * 暂停MP3文件的播放 */ public void pauseMp3(); /** * 恢复暂停播放的MP3文件 */ public void resumeMp3(); /** * 播放音效文件 * @param path 音效文件的绝对路径 * @param cache 是否缓存解码数据 * @param repeat 是否循环播放 * @param crescendo 是否渐强效果 * @param volume 音量 */ public void playAudioEffect(String path, boolean cache, boolean repeat, boolean crescendo, float volume); /** * 释放在playAudioEffect时获取的资源 */ public void releaseAudioEffect(); }
public class VoipAndroid { /** * 设置滤镜模式 * @param mode 0，关闭；1，自然；2，阳光；3，甜蜜；4，淡雅 */ public void setFaceBeautyMode(int mode); /** * 设置亮度和色彩 * @param light 亮度值，0～20 * @param color 色彩值，自然模式下，范围为0～20；其他模式下，需设置为-1 */ public void setFaceBeautyLightAndColor(int light, int color); /** * 设置模版强度，仅在非“自然”模式时设置 * @param templateStrength 模版强度值，50～125，仅在非“自然”模式时设置 */ public void setFaceBeautyTemplateStrength(int templateStrength); /** * 设置滤镜的效果强度 * @param strength 强度值，0～5 */ public void setFaceBeautyStrength(int strength); /** * 设置模糊效果 * @param enable 是否开启模糊效果 * @param radius 模糊效果的强度值，0～5 */ public void setGaussBlur(boolean enable, int radius); /** * 将一帧YUV图像进行模糊处理 * @param image 待处理的图像 * @param radius 模糊效果的强度，0～15 */ public void gaussBlurImage(VoipImage image, int radius); /** * 将一帧YUV图像的一部分进行模糊处理 * @param image 待处理的图像 * @param radius 模糊效果的强度，0～15 * @param left 待处理部分的相对坐标，左 * @param top 待处理部分的相对坐标，上 * @param right 待处理部分的相对坐标，右 * @param bottom 待处理部分的相对坐标，下 */ public void gaussBlurImagePart(VoipImage image, int radius, int left, int top, int right, int bottom); /** * 将一帧ARGB图像的一部分进行模糊处理 * @param image 待处理的ARGB图像 * @param radius 模糊效果的强度，0～15 * @param left 待处理部分的相对坐标，左 * @param top 待处理部分的相对坐标，上 * @param right 待处理部分的相对坐标，右 * @param bottom 待处理部分的相对坐标，下 */ public void gaussBlurARGB(byte[] data, int radius, int width, int height, int left, int top, int right, int bottom)； }
public class VoipAndroid { /** * 设置语音短信录制的最大时长，默认为60s * @param seconds 最大时长的秒数 */ public void setAudioMessageMaxDuration(int seconds); /** * 开始录制语音短信 * @param fileName 存储语音短信的本地文件的绝对路径 * @param version 文件格式版本 * @param callback 录制语音短信过程中的回调 */ public void startRecordingAudioMessage(String fileName, int version, AudioMsgRecorderCallback callback); /** * 停止语音短信的录制 */ public void stopRecordingAudioMessage(); /** * 获取语音短信的时长 * @param fileName 存储语音短信的本地文件的绝对路径 * @return int 语音短信的时长，单位毫秒 */ public int getAudioMessageDuration(String fileName); /** * 开始播放语音短信 * @param activity Activity对象，用于调整音量 * @param fileName 存储语音短信的本地文件的绝对路径 * @param callback 播放语音短信过程中的回调 * @param useEarpiece 为TRUE时，从听筒播放；为FALSE时，从扬声器播放 */ public void startPlayingAudioMessage(Activity activity, String fileName, AudioMsgPlayerCallback callback, boolean useEarpiece); /** * 停止语音短信的播放 */ public void stopPlayingAudioMessage(); }
public class VoipAndroid { /** * 设置小视频录制的最大时长，默认为60秒 * @param seconds 最大时长的秒数 */ public void setVideoMessageMaxDuration(int seconds); /** * 准备开始录制小视频 * @param isAvatar FALSE * @param srcFileDir “” * @param avatarDir “” * @return 0: 成功; Other: 失败 */ public int prepareRecordingVideoMessage(boolean isAvatar, String srcFileDir, String avatarDir); /** * 开始录制小视频 * @param fileName 存储小视频的本地文件的绝对路径 * @param callback 录制小视频过程中的回调 */ public void startRecordingVideoMessage(String fileName, VideoMsgRecorderCallback callback); /** * 停止小视频的录制 */ public void stopRecordingVideoMessage(); /** * 取消录制小视频的准备 */ public void unprepareRecordingVideoMessage(); /** * 获取小视频文件的时长 * @param fileName 存储小视频的本地文件的绝对路径 * @return int 小视频的时长，单位毫秒 */ public int getVideoMessageDuration(String fileName); /** * 开始播放小视频，开始后视频内容循环播放，若播放语音，语音只播一遍 * @param activity Acitivity对象，用于调整音量 * @param fileName 存储小视频的本地文件的绝对路径 * @param withAudio 是否播放声音 * @param callback 播放小视频过程中的回调 * @param useEarpiece 为TRUE时，使用听筒播放；为FALSE时，使用扬声器播放 */ public void startPlayingVideoMessage(Activity activity, String fileName, boolean withAudio, VideoMsgPlayerCallback callback, boolean useEarpiece); /** * 停止小视频的播放 * @param fileName 存储小视频的本地文件的绝对路径 * @param remainVideoPreview 是否保留视频的继续循环播放 * @param stopAudio 尝试停止Audio设备 * @param callback 播放小视频过程中的回调，作为区分同一文件在不同窗口中播放时的ID */ public void stopPlayingVideoMessage(String fileName, boolean remainVideoPreview, boolean stopAudio, VideoMsgPlayerCallback callback); /** * 暂停或停止所有小视频的播放 * @param removeCallbacks 为true时，将彻底停止所有小视频的播放；为false时，仅仅暂停，还可以通过restartAllPlayingVideoMessage()来恢复 */ public void stopAllPlayingVideoMessage(boolean removeCallbacks); /** * 尝试重新恢复之前暂停的所有小视频 */ public void restartAllPlayingVideoMessage(); }