# urtc-android-demo **Repository Path**: banzhangzzw/urtc-android-demo ## Basic Information - **Project Name**: urtc-android-demo - **Description**: 视频通讯 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2019-10-13 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 1 描述 URTCAndroid 是UCloud推出的一款适用于android平台的实时音视频 SDK，支持android5.1及以上系统，提供了音视频通话基础功能，提供灵活的接口，支持高度定制以及二次开发。 # 2 功能列表 ## 2.1 基本功能 * 基本的音视频通话功能 * 支持内置音视频采集的常见功能 * 支持静音关闭视频功能 * 支持视频尺寸的配置(180P - 720P) * 支持自动重连 * 支持丰富的消息回调 * 支持纯音频互动 * 支持视频的大小窗口切换 * 支持获取视频房间统计信息（帧率、码率、丢包率等） * 支持编码镜像功能 * 支持屏幕录制功能 * 支持自动手动订阅 自动手动发布 * 支持权限（上行/下行/全部）控制 * 支持音量提示 * 支持获取sdk版本 * 支持大班小班切换功能 ## 2.2 增值功能 * 终端智能测试（摄像头、麦克风、网络、播放器） * 视频录制/视频存储 * 视频水印 * 视频直播CDN分发 * 美颜 * 贴纸/滤镜/哈哈镜 * 背景分割 * 手势 * 虚拟形象 * 变声 ## 2.3 文档地址 * https://docs.ucloud.cn/video/urtc/index.html # 3 方案优势 ## 3.1 方案架构 ![](http://urtcwater.cn-bj.ufileos.com/%E5%9B%BE%E7%89%871.png) ## 3.2 方案优势 * 利用边缘节点就近接入 * 可用性99.99% * 智能链路调度 * 自有骨干专线+Internet传输优化 * 数据报文AES加密传输 * 全API开放调度能力 * 端到端链路质量探测 * 多点接入线路容灾 * 抗丢包视频30% 音频70% * 国内平均延时低于75ms 国际平均延时低于200ms # 4 应用场景 ## 4.1 主播连麦 支持主播之间连麦一起直播，带来与传统单向直播不一样的体验 48KHz 采样率、全频带编解码以及对音乐场景的特殊优化保证观众可以听到最优质的声音 ## 4.2 视频会议 小范围实时音视频互动，提供多种视频通话布局模板，更提供自定义布局方式，保证会议发言者互相之间的实时性，提升普通观众的观看体验 ## 4.3 泛文娱 ### 4.3.1 一对一社交 客户可以利用UCloud实时音视频云实现 QQ、微信、陌陌等社交应用的一对一视频互动 ### 4.3.2 狼人杀游戏 支持15人视频通话，玩家可在游戏中选择只开启语音或同时开启音视频 ## 4.4 在线教育 支持自动和手动发布订阅视频流，方便实现课堂虚拟分组概念，同时支持根据角色设置流权限，保证课程秩序 ## 4.5 在线客服 线上开展音视频对话，对客户的资信情况进行审核，方便金融科技企业实现用户在线签约、视频开户验证以及呼叫中心等功能 提供云端存储空间及海量数据的处理能力，提供高可用的技术和高稳定的平台 # 5 快速使用 ## 5.1 初始化 ### 5.1.1 引擎环境初始化 主要配置android context sdkmode以及AppID ，测试用的SEC_KEY,日志等级 ~~~ public class UCloudRtcApplication extends Application { @Override public void onCreate() { super.onCreate(); UCloudRtcSdkEnv.initEnv(getApplicationContext(), this); UCloudRtcSdkEnv.setLogLevel(UCloudRtcSdkLogLevel.UCloudRtc_SDK_LogLevelInfo) ; UCloudRtcSdkEnv.setSdkMode(UCloudRtcSdkMode.RTC_SDK_MODE_TRIVAL); UCloudRtcSdkEnv.setTokenSeckey(CommonUtils.SEC_KEY); WindowManager windowManager = (WindowManager) getSystemService(Context.WINDOW_SERVICE); DisplayMetrics outMetrics = new DisplayMetrics(); windowManager.getDefaultDisplay().getMetrics(outMetrics); CommonUtils.mItemWidth = outMetrics.widthPixels / 3; CommonUtils.mItemHeight = CommonUtils.mItemWidth; } } ~~~ ### 5.1.2 继承实现UCloudRtcSdkEventListener 实现事件处理 ~~~ UCloudRtcSdkEventListener eventListener = new UCloudRtcSdkEventListener() { @Override public void onServerDisconnect() { runOnUiThread(new Runnable() { @Override public void run() { ToastUtils.shortShow(RoomActivity.this, " 服务器已断开"); stopTimeShow(); onMediaServerDisconnect() ; } }); } @Override public void onJoinRoomResult(int code, String msg, String roomid) { runOnUiThread(new Runnable() { @Override public void run() { if (code == 0) { ToastUtils.shortShow(RoomActivity.this, " 加入房间成功"); startTimeShow(); }else { ToastUtils.shortShow(RoomActivity.this, " 加入房间失败 "+ code +" errmsg "+ msg); Intent intent = new Intent(RoomActivity.this, ConnectActivity.class); onMediaServerDisconnect() ; startActivity(intent) ; finish(); } } }); } ~~~ ### 5.1.3 获取SDK 引擎 并进行基础配置 ~~~ sdkEngine = UCloudRtcSdkEngine.createEngnine(eventListener) ; sdkEngine.setAudioOnlyMode(true) ; // 设置纯音频模式 sdkEngine.configLocalCameraPublish(false) ; // 设置摄像头是否发布 sdkEngine.configLocalAudioPublish(true) ; // 设置音频是否发布，用于让sdk判断自动发布的媒体类型 sdkEngine.configLocalScreenPublish(false) ; // 设置桌面是否发布，作用同上 sdkEngine.setStreamRole(UCloudRtcSdkStreamRole.UCloudRtc_SDK_STREAM_ROLE_BOTH);// 流权限 sdkEngine.setAutoPublish(true) ; // 是否自动发布 sdkEngine.setAutoSubscribe(true) ;// 是否自动订阅 sdkEngine.setVideoProfile(UCloudRtcSdkVideoProfile.matchValue(mVideoProfile)) ;// 摄像头输出等级 ~~~ ## 5.2 加入房间 ~~~ UCloudRtcSdkAuthInfo info = new UCloudRtcSdkAuthInfo(); info.setAppId(mAppid); info.setToken(mRoomToken); info.setRoomId(mRoomid); info.setUId(mUserid); Log.d(TAG, " roomtoken = " + mRoomToken); sdkEngine.joinChannel(info); ~~~ ## 5.3 自动/手动发布 如果配置了自动发布无需调用发布视频接口，SDK会在用户成功加入房间后自动发布，只需要监听事件调用渲染接口即可。 如果配置了手动发布需要调用sdkEngine引擎的publish接口 配置手动/自动发布 ### 5.3.1 媒体发布类型 现在的类型包括两大类，需要传入publish接口的mtype,hasvideo,hasaudio参数各不相同，混合类型是单一类型的组合，具体代码可参阅UCloudRtcdemo的RoomActvity中的处理。 1. 混合类型 音频+屏幕，视频+屏幕 2. 单一类型 音频 （mtype:UCloudRtc_sdk_media_type_video,hasvideo:false,hasaudio:true），视频（mtype:UCloudRtc_sdk_media_type_video,hasvideo:true,hasaudio:true），屏幕 （mtype:UCloudRtc_sdk_media_type_screen,hasvideo:true,hasaudio:false） ### 5.3.2 渲染媒体流 在onLocalPublish 回调成功后，再函数中可以调用视频渲染 ~~~ localrenderview.setBackgroundColor(Color.TRANSPARENT); sdkEngine.startPreview(info.getmMediatype(), localrenderview); //不想渲染时可以调用停止渲染接口 sdkEngine.stopPreview(UCloudRtcSdkMediaType mediatype) ~~~ ### 5.3.3 取消媒体发布流 ~~~ sdkEngine.unPublish(UCloudRtcSdkMediaType mtype) //回调事件 public void onLocalUnPublish(int code, String msg, UCloudRtcSdkStreamInfo info) ~~~ ## 5.4 自动/手动订阅 ### 5.4.1 订阅媒体流 ~~~ sdkEngine.subscribe(UCloudRtcSdkStreamInfo info) //回调事件 public void onSubscribeResult(int code, String msg, UCloudRtcSdkStreamInfo info) ~~~ ### 5.4.2 取消媒体发布流 在onSubscribeResult回调成功后，再函数中可以调用视频渲染 ~~~ sdkEngine. startRemoteView(UCloudRtcSdkStreamInfo info, UCloudRtcSdkSurfaceVideoView renderview) //不想渲染时可以调用定制渲染接口 sdkEngine.stopPreview(UCloudRtcSdkMediaType mediatype) ~~~ ### 5.4.3 取消订阅媒体流 ~~~ sdkEngine. subscribe(UCloudRtcSdkStreamInfo info) //回调事件 public void onUnSubscribeResult(int code, String msg, UCloudRtcSdkStreamInfo info) ~~~ ## 5.5 权限控制 权限分为发布，订阅，全部权限，全部权限包括了发布和订阅 ~~~ //接口 public int setStreamRole(UCloudRtcSdkStreamRole role) ~~~ ## 5.6 录像 ### 5.6.1 录像开始 录像目前只支持摄像头录制，不支持桌面录制，region和bucket这两个参数需要上ucloud控制台申请自己的录像存储空间，测试demo 可以使用demo已经申请好的，服务器会通过UCloudRtcSdkEventListener 的onRecordStart()接口作为回调返回录像开始结果。 ~~~ sdkEngine.startRecord(3,UCLOUD_RTC_SDK_MEDIA_TYPE_VIDEO.ordinal(),"region","bucket",UCloudRtcSdkVideoProfile.UCLOUD_RTC_SDK_VIDEO_RESOLUTION_STANDARD.ordinal()); //UCloudRtcSdkEventListener void onRecordStart(int code,String fileName); ~~~ ### 5.6.2录像结束 服务器会通过UCloudRtcSdkEventListener 的onRecordStop()接口作为回调返回录像结束结果。 ~~~ sdkEngine.stopRecord(); ~~~ ## 5.6 离开房间 ~~~ sdkEngine.leaveChannel() ; ~~~ ## 5.7 编译运行