• 可以下载Demo、SDK、API Java 文档
  现在下载

• 开发语言：Java
• 系统要求：Android4.4以上版本

• android studio 需要android SDK

• 下载urtc android SDK包，SDK包为aar 格式，名称为ucloudrtclib开头加版本号加一串8位识别码，可以参考github上的接入demo。
• 将aar 文件拷贝到自己的lib 目录下，然后添加到lib 中，修改要使用sdk模块目录下的 build.gradle，确保已经添加了如下依赖，如下所示：

  dependencies { implementation (name: 'ucloudrtclib1.0.1b52bc04c', ext: 'aar')

• 如果项目混淆，请在混淆中添加一下urtc 混淆规则

snippet.js

-keep class com.ucloudrtclib.sdkengine.**{*;}
-keep class com.ucloudrtclib.sdkengine.define.*{*;}
-keep enum com.ucloudrtclib.sdkengine.define.*{*;}
 
-keepclassmembers class com.ucloudrtclib.sdkengine.AutoAIRtcSdkEnv {
    public static ;
}
 
-keepclassmembers interface com.ucloudrtclib.sdkengine.AutoAIRtcSdkEngine {
    public ;
    public static ;
}
-keep class org.webrtc.** {
    *;
}

• 目录结构

• 添加权限

在 Android 6.0 (API 23) 开始，用户需要在应用运行时授予权限，而不是在应用安装时授予，并分为正常权限和危险权限两种类型。在实时音视频 SDK 中，用户需要在进入音视频通话房间前动态申请 CAMERA、RECORD_AUDIO、WRITE_EXTERNAL_STORAGE 权限，具体可以参考 Android官方文档

snippet.js

• 引擎环境初始化

主要配置android context sdkmode以及AppID ，测试用的SEC_KEY,日志等级

snippet.js

public class AutoAIRtcApplication extends Application {
        @Override
        public void onCreate() {
            super.onCreate();
            URTCSdkEnv.initEnv(getApplicationContext(), this);
            URTCSdkEnv.setLogLevel(URTCSdkLogLevel.URTC_SDK_LogLevelInfo) ;
            URTCSdkEnv.setSdkMode(URTCSdkMode.RTC_SDK_MODE_TRIVAL);
            URTCSdkEnv.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;
        }
    }

• 继承实现AutoAIRtcSdkEventListener 实现事件处理

js AutoAIRtcSdkEventListener eventListener = new AutoAIRtcSdkEventListener() { @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(); } } }); }

• 获取SDK 引擎 并进行基础配置

js sdkEngine.setAudioOnlyMode(true) ; // 设置纯音频模式 sdkEngine.configLocalCameraPublish(false) ; // 设置摄像头是否发布 sdkEngine.configLocalAudioPublish(true) ; // 设置音频是否发布，用于让sdk判断自动发布的媒体类型 sdkEngine.configLocalScreenPublish(false) ; // 设置桌面是否发布，作用同上 sdkEngine.setStreamRole(URTCSdkStreamRole.URTC_SDK_STREAM_ROLE_BOTH);// 流权限 sdkEngine.setAutoPublish(true) ; // 是否自动发布 sdkEngine.setAutoSubscribe(true) ;// 是否自动订阅 sdkEngine.setVideoProfile(AutoAIRtcSdkVideoProfile.matchValue(mVideoProfile)) ;// 摄像头输出等级

• 加入房间

js AutoAIRtcSdkAuthInfo info = new AutoAIRtcSdkAuthInfo(); info.setAppId(mAppid); info.setToken(mRoomToken); info.setRoomId(mRoomid); info.setUId(mUserid); Log.d(TAG, " roomtoken = " + mRoomToken); sdkEngine.joinChannel(info);

• 自动/手动发布

如果配置了自动发布无需调用发布视频接口，SDK会在用户成功加入房间后自动发布，只需要监听事件调用渲染接口即可。 如果配置了手动发布需要调用sdkEngine引擎的publish接口 配置手动/自动发布

snippet.js

sdkEngine.setAutoPublish(mPublishMode == CommonUtils.AUTO_MODE ? true : false);

• 媒体发布类型

现在的类型包括两大类，需要传入publish接口的mtype,hasvideo,hasaudio参数各不相同，混合类型是单一类型的组合，具体代码可参阅urtcdemo的RoomActvity中的处理。

• 混合类型
• 音频+屏幕捕捉
• 视频+屏幕捕捉
• 单一类型
  • 音频 （mtype:urtcsdkmediatypevideo,hasvideo:false,hasaudio:true）
  • 视频 （mtype:urtcsdkmediatypevideo,hasvideo:true,hasaudio:true）
  • 屏幕捕捉 （mtype:urtcsdkmediatypescreen,hasvideo:true,hasaudio:false）
    • 手动发布媒体流

snippet.js

sdkEngine.publish(AutoAIRtcSdkMediaType mtype, boolean hasvideo, boolean hasaudio)
回调事件
public void onLocalPublish(int code, String msg, AutoAIRtcSdkStreamInfo info

• 渲染媒体流

在onLocalPublish 回调成功后，再函数中可以调用视频渲染

snippet.js

localrenderview.setBackgroundColor(Color.TRANSPARENT);
sdkEngine.startPreview(info.getmMediatype(), localrenderview);
不想渲染时可以调用停止渲染接口
sdkEngine.stopPreview(AutoAIRtcSdkMediaType mediatype

• 取消发布媒体流

snippet.js

sdkEngine.unPublish(AutoAIRtcSdkMediaType mtype)
回调事件
public void onLocalUnPublish(int code, String msg, AutoAIRtcSdkStreamInfo info

• 订阅

如果配置了自动发布无需调用发布视频接口，SDK会自动发布，只需要监听事件调用渲染接口即可。

• 订阅媒体流

snippet.js

sdkEngine.subscribe(AutoAIRtcSdkStreamInfo info)
//回调事件
public void onSubscribeResult(int code, String msg, AutoAIRtcSdkStreamInfo info

• 渲染媒体流

在onSubscribeResult回调成功后，再函数中可以调用视频渲染

snippet.js

sdkEngine. startRemoteView(AutoAIRtcSdkStreamInfo info, AutoAIRtcSdkSurfaceVideoView renderview)
//不想渲染时可以调用定制渲染接口
sdkEngine.stopPreview(AutoAIRtcSdkMediaType mediatype

• 取消订阅媒体流

snippet.js

sdkEngine. subscribe(AutoAIRtcSdkStreamInfo info) 
//回调事件
public void onUnSubscribeResult(int code, String msg, AutoAIRtcSdkStreamInfo info)

• 权限控制

权限分为发布，订阅，全部权限，全部权限包括了发布和订阅

snippet.js

//接口
public int setStreamRole(AutoAIRtcSdkStreamRole role)
//调用
sdkEngine.setStreamRole(mRole);

• 离开房间

snippet.js

sdkEngine.leaveChannel() ;

• 编译、运行，开始体验吧！