Android JMRTC SDK 实时音视频

          compile 'cn.jiguang.sdk:jmrtc:1.0.2'  // 此处以jmrtc 1.0.2 版本为例

        

              <!-- Required for jmrtc -->
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.CAMERA" />
 <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

        

          # ========================JMRTC================================
-dontwarn cn.jiguang.jmrtc.**
-keep class cn.jiguang.jmrtc.api.** {*;}

# ========================Agora================================
-dontwarn io.agora.rtc.**
-keep class io.agora.rtc.** {*;}

        

          /**
 * @param listener 音视频相关事件回调监听类
 */
JMRtcClient.getInstance().initEngine(JMRtcListener listener);

        

          JMRtcClient.getInstance().reinitEngine();

        

          JMRtcClient.getInstance.releaseEngine();

        

          /**
 * 发起通话邀请。
 * 任何通话的发起都应该以此接口开始。
 * <p>
 * 邀请发出之后，触发{@link JMRtcListener#onCallOutgoing(JMRtcSession)}回调，通知上层正在发起通话。之后进入outgoing状态。
 * <p>
 * 被邀请方收到邀请时，触发{@link JMRtcListener#onCallInviteReceived(JMRtcSession)}回调，通知上层收到邀请。
 *
 * @param invitedUsers 被邀请的用户的UserInfo集合
 * @param mediaType    通话类型
 * @param callback     结果回调
 */
JMRtcClient.getInstance().call(List<UserInfo> invitedUsers, JMSignalingMessage.MediaType mediaType, final BasicCallback callback);

        

          /**
 * 向其他用户发起邀请，加入通话。
 * 此接口只能在通话建立、sdk回调了{@link JMRtcListener#onCallConnected(JMRtcSession, SurfaceView)}接口之后，才能发起调用。
 * <p>
 * 邀请发出之后，当前通话中的其他用户会触发{@link JMRtcListener#onCallOtherUserInvited(UserInfo, List, JMRtcSession)}回调，通知上层有其他人被邀请加入通话
 * <p>
 * 被邀请方收到邀请时，触发{@link JMRtcListener#onCallInviteReceived(JMRtcSession)}回调，通知上层收到邀请。
 *
 * @param invitedUsers 被邀请的用户的UserInfo集合
 * @param callback     结果回调
 */
JMRtcClient.getInstance().invite(List<UserInfo> invitedUsers, final BasicCallback callback);

        

          /**
 * 接受通话邀请。
 * 此接口只能在收到通话邀请、sdk回调了{@link JMRtcListener#onCallInviteReceived(JMRtcSession)}之后，才能发起调用。
 * <p>
 * 成功调用后，双方都会触发{@link JMRtcListener#onCallConnected(JMRtcSession, SurfaceView)}通知上层通话连接已建立。
 * 并且sdk会通过{@link JMRtcListener#onCallMemberJoin(UserInfo, SurfaceView)}上报当前已经在通话频道内的用户。
 *
 * @param callback 结果回调
 */
JMRtcClient.getInstance().accept(final BasicCallback callback);

        

          /**
 * 拒绝通话邀请。
 * 此接口只能在收到通话邀请、sdk回调了{@link JMRtcListener#onCallInviteReceived(JMRtcSession)}之后，才能发起调用。
 * <p>
 * 成功调用后，被邀请方会触发{@link JMRtcListener#onCallDisconnected(DisconnectReason)}通知上层连接断开，通话已结束。
 * <p>
 * 邀请方触发{@link JMRtcListener#onCallMemberOffline(UserInfo, DisconnectReason)}通知上层有用户离线，离线原因{@link DisconnectReason#refuse}
 *
 * @param callback 结果回调
 */
JMRtcClient.getInstance().refuse(final BasicCallback callback);

        

          /**
 * 通话挂断。
 * 此接口可以在邀请阶段以及通话阶段由任意通话中用户发起
 * <p>
 * 成功调用后，调用者会触发{@link JMRtcListener#onCallDisconnected(DisconnectReason)}通知上层连接断开，通话已结束。
 * <p>
 * 其他用户触发{@link JMRtcListener#onCallMemberOffline(UserInfo, DisconnectReason)}通知上层有用户离线，离线原因{@link DisconnectReason#hangup}
 *
 * @param callback 结果回调
 */
JMRtcClient.getInstance().hangup(final BasicCallback callback);

        

          /**
 * 设置本地音频输出开关。只在视频或语音通话连接建立之后调用有效。
 * <p>
 * 默认打开。
 *
 * @param isEnable true - 开启音频输出, false - 关闭音频输出
 * @return 操作结果。 true - 操作成功，false - 操作失败
 */
JMRtcClient.getInstance().enableAudio(boolean isEnable);

        

          /**
 * 设置本地视频输出开关。只在视频通话连接建立之后调用有效。
 * <p>
 * 视频通话中默认打开。音频通话中此接口无效。
 *
 * @param isEnable true - 开启视频输出, false - 关闭视频输出
 * @return 操作结果。 true - 操作成功，false - 操作失败
 */
JMRtcClient.getInstance().enableVideo(boolean isEnable) {
 if (null == stateMachine) {
  Logger.ee(TAG, "[enableVideo] failed. should init engine first.");
  return false;
 }
 return stateMachine.enableVideo(isEnable);
}

        

          /**
 * 设置使用本地外置扬声器开关。只在视频或语音通话连接建立之后调用有效。
 * <p>
 * 默认打开
 *
 * @param isEnable true - 使用外置扬声器, false - 不使用外置扬声器
 * @return 操作结果。 true - 操作成功，false - 操作失败
 */
JMRtcClient.getInstance().enableSpeakerphone(boolean isEnable);

        

          /**
 * 切换前置/后置摄像头。只在视频或语音通话连接建立之后调用有效。
 * <p>
 * 默认使用前置摄像头
 *
 * @return 操作结果。 true - 操作成功，false - 操作失败
 */
JMRtcClient.getInstance.switchCamera()

        

          /**
 * 设置视频输出的编码属性
 * <p>
 * 视频通话期间调用此接口设置的属性将在下次视频通话中生效
 *
 * @param videoProfile 视频编码属性
 */
JMRtcClient.getInstance.setVideoProfile(VideoProfile videoProfile);

        

          /**
 * 获取当前设置的视频编码属性
 * <p>
 * 默认为{@link VideoProfile#Profile_360P}
 *
 * @return
 */
JMRtcClient.getInstance.getVideoProfile();

        

          /**
 * 获取当前通话session对象。
 *
 * @return {@link JMRtcSession}对象,如果当前不在任何会话中，则返回null。
 */
JMRtcClient.getInstance.getSession();

        

          /**
 * 获取通话类型
 *
 * @return 通话类型
 */
session.getMediaType();

        

          /**
 * 获取用户在通信中的角色，{@link SessionRole#inviter}邀请发起者，或者{@link SessionRole#invited}被邀请者。
 *
 * @return 通信中的角色
 */
session.getSessionRole();

        

          /**
 * 获取邀请者用户信息
 *
 * @param callback 结果回调
 */
session.getInviterUserInfo(final RequestCallback<UserInfo> callback);

        

          /**
 * 获取当前被邀请的用户的用户信息集合
 *
 * @param callback 结果回调
 */
session.getInvitingUserInfos(final RequestCallback<List<UserInfo>> callback);

        

          /**
 * 获取当前已加入通信的用户的用户信息集合
 *
 * @param callback 结果回调
 */
session.getJoiendMembers(final RequestCallback<List<UserInfo>> callback);

        

          /**
 * jmrtc引擎初始化结果回调。
 *
 * @param errCode 错误码。 0 - 成功，其他错误码参见错误码定义表
 * @param errDesc 错误描述。
 */
public void onEngineInitComplete(int errCode, String errDesc) {
}

        

          /**
 * 邀请方成功调用{@link JMRtcClient#call(List, JMSignalingMessage.MediaType, BasicCallback)}后，会触发此回调通知上层通话已播出。
 *
 * @param callSession 保存通信元信息的实体对象
 */
public void onCallOutgoing(JMRtcSession callSession) {
}

        

          /**
 * 被邀请方收到邀请时，会触发此回调通知上层收到通话邀请。
 *
 * @param callSession 保存通信元信息的实体对象
 */
public void onCallInviteReceived(JMRtcSession callSession) {
}

        

          /**
 * 通话过程中，有其他用户被邀请。
 *
 * @param fromUserInfo     邀请发起方用户信息
 * @param invitedUserInfos 被邀请方用户信息集合
 * @param callSession      保存通信元信息的实体对象
 */
public void onCallOtherUserInvited(UserInfo fromUserInfo, List<UserInfo> invitedUserInfos, JMRtcSession callSession) {
}

        

          /**
 * 音视频通信连接已建立。
 * 当被邀请方有任意一方成功调用{@link JMRtcClient#accept(BasicCallback)}接受邀请后，邀请方和接受方都会触发此回调通知上层通信连接已建立。
 *
 * @param callSession      保存通信元信息的实体对象
 * @param localSurfaceView 本地视频预览SurfaceView对象，对于视频聊天，上层可以直接用此对象在界面上进行渲染展示。
 */
public void onCallConnected(JMRtcSession callSession, SurfaceView localSurfaceView) {
}

        

          /**
 *
 * @param joinedUserInfo    加入的用户的用户信息
 * @param remoteSurfaceView 加入用户的视频预览SurfaceView对象。对于视频聊天，上层可以直接用此对象在界面上进行渲染展示。
 */
public void onCallMemberJoin(UserInfo joinedUserInfo, SurfaceView remoteSurfaceView) {
}

        

          /**
 * 通话过程中，有用户退出通话。
 *
 * @param leavedUserInfo 退出通话的用户的用户信息
 * @param reason         退出原因
 */
public void onCallMemberOffline(UserInfo leavedUserInfo, JMRtcClient.DisconnectReason reason) {
}

        

          /**
 * 通话连接断开。
 *
 * @param reason 断开原因
 */
public void onCallDisconnected(JMRtcClient.DisconnectReason reason) {
}

        

          /**
 * 通话过程中发生错误
 *
 * @param errorCode 错误码
 * @param desc      错误描述
 */
public void onCallError(int errorCode, String desc) {
}

        

          /**
 * 上层收到此回调后，建议根据系统具体版本决定是否需要向用户动态申请权限（android 6.0之后）。
 * 权限申请成功之后，需要调用{@link JMRtcClient#reinitEngine()}重新初始化引擎。
 *
 * @param requiredPermissions 缺少的权限
 */
public void onPermissionNotGranted(String[] requiredPermissions) {
}

        

          /**
 * 对方用户禁用/启用视频流时的回调。
 *
 * @param remoteUser 用户信息
 * @param isMuted    是否禁用。 true - 禁用，false - 启用
 */
public void onRemoteVideoMuted(UserInfo remoteUser, boolean isMuted) {
}