创建并初始化 RtcEngine
public static RtcEngine create( Context context, String appId, IRtcEngineEventHandler handler) throws Exception {}
参数
context 安卓活动上下文。
appId 声网为 App 开发者签发的 App ID。 使用同一个 App ID 的 App 才能进入同一个频道进行通话或直播。一个 App ID 只能用于创建一个 RtcEngine。如需更换 App ID,必须先调用 destroy 销毁当前 RtcEngine 再重新创建。 handler RtcEngine 的事件句柄,详见 IRtcEngineEventHandler。 返回值
方法调用成功,返回一个 RtcEngine 对象。 方法调用失败,抛出异常,你需要捕获异常并进行处理。详见错误码了解详情和解决建议。
销毁 RtcEngine 对象
public static void destroy() { if (mInstance == null) return; mInstance.doDestroy(); mInstance = null; System.gc(); }
获取用户信息
public UserInfo getUserInfoByUid(int uid, String channelId, String localUserAccount); 详情
远端用户加入频道后,SDK 会获取到该远端用户的 UID 和 User Account,然后缓存一个包含了远端用户 UID 和 User Account 的映射表,并在本地触发 onUserInfoUpdated 回调。收到回调后,调用该方法传入 UID 来获取包含了指定用户 User Account 的 UserInfo 对象。
参数
uid 用户 ID。 channelId 频道名。该参数标识用户进行实时音视频互动的频道。App ID 一致的前提下,填入相同频道名的用户会进入同一个频道进行音视频互动。该参数为长度在 64 字节以内的字符串。以下为支持的字符集范围(共 89 个字符): 26 个小写英文字母 a~z 26 个大写英文字母 A~Z 10 个数字 0~9 "!"、"#"、"$"、"%"、"&"、"("、")"、"+"、"-"、":"、";"、"<"、"="、"."、">"、"?"、"@"、"["、"]"、"^"、"_"、"{"、"}"、"|"、"~"、"," localUserAccount 本地用户的 User Account。
加入通道
public int joinChannel( String token, String channelId, String optionalInfo, int uid); 参数:token 在服务端生成的用于鉴权的动态密钥。详见使用 Token 鉴权。channelId 频道名。该参数标识用户进行实时音视频互动的频道。 uid 用户 ID。该参数用于标识在实时音视频互动频道中的用户。
离开通道
public int leaveChannel(); 调用该方法后,SDK 会终止音视频互动、离开当前频道,并会释放会话相关的所有资源。
关闭视频模块
public abstract int enableLocalVideo(boolean enabled);
启用视频模块
public abstract int enableVideo();
开启视频预览
public abstract int startPreview();
停止视频预览
public abstract int stopPreview();