/EasyWebrtc-Android

只需要简单几行代码快速部署Android视频通话，基于GoogleWebRtc

Primary LanguageJava

集成
开启摄像头
建立连接
视频录制
销毁
关于几个重要回调说明
其他问题

EasyWebrtc-Android

  • 支持动态本地视频录制
  • 支持动态远程视频录制
  • 支持动态相机切换
  • 支持自定义设置录制视频保存路径

集成

  • 在项目级 build.gradle添加
allprojects {
   repositories {
      maven { url 'https://jitpack.io' }
	}
}
  • 在app模块下的build.gradle文件中加入
dependencies {
    // 请用最后release版本替换Tag
    implementation 'com.github.eurigo:EasyWebrtc:1.0.0'
}
  • 在app模块下的AndroidManifest.xml添加权限
<manifest
    ...
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

    <uses-permission android:name="android.permission.CAMERA"/>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.RECORD_AUDIO"/>
/>
  • 在Layout中配置
    <org.webrtc.SurfaceViewRenderer
        android:id="@+id/local_video_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

开启摄像头

// 配置STUN服务器地址，设置回调	
EasyRtc.create(Constant.STUN, new EasyRtcCallBack);
EasyRtc.setLocalView(localVideoView);
EasyRtc.setRemoteView(remoteVideoView);
// 开启本地视频
EasyRtc.startLocalVideo();

建立连接

EasyRtc.createOffer();

视频录制

视频录制分为录制远程和录制本地，start和stop需成对出现

// 开启录制本地	
EasyRtc.startRecorderLocal();
// 停止本地录制
EasyRtc.stopRecorderLocal();
// 开启录制远程
EasyRtc.startRecorderRemote();
// 停止远程录制
EasyRtc.stopRecorderRemote();

销毁

// 在onDestory时release
EasyRtc.release();

关于几个重要回调说明

	/**
     * 发送 offer sdp
     * @param sessionDescription sdp
     * 在创建offer之后需要把sdp发送给对方，可以使用webSocket、http等都可以
     * 被呼叫方收到offer之后需要EasyRtc.setRemoteSdp(SessionDescription sessionDescription);
     */
    @Override
    public void onSendOffer(SessionDescription sessionDescription) {
        WsData wsData = new WsData(EventType.SEND_OFFER, DeviceUtils.getAndroidID(), "");
        wsData.setSessionDescription(sessionDescription);
        WsManager.getInstance().send(GsonUtils.toJson(wsData));
    }

    /**
     * 发送 answer sdp
     * @param sessionDescription sdp
     * 本质上也是sdp的发送
     * 被呼叫方收到Answer之后需要EasyRtc.setRemoteSdp(SessionDescription sessionDescription);
     */
    @Override
    public void onSendAnswer(SessionDescription sessionDescription) {
        WsData wsData = new WsData(EventType.SEND_ANSWER, DeviceUtils.getAndroidID(), "");
        wsData.setSessionDescription(sessionDescription);
        WsManager.getInstance().send(GsonUtils.toJson(wsData));
    }

    /**
     * 发送 Ice
     * 类似sdp,需要发STUN返回的Ice发送给远端
     * 被呼叫方收到Ice之后需要EasyRtc.setRemoteIce(IceCandidate iceCandidate);
     */		
    @Override
    public void onSendIce(IceCandidate iceCandidate) {
        WsData wsData = new WsData(EventType.SEND_ICE, DeviceUtils.getAndroidID(), "");
        wsData.setIceCandidate(iceCandidate);
        WsManager.getInstance().send(GsonUtils.toJson(wsData));
    }

    @Override
    public void onConnectStateChange(PeerConnection.PeerConnectionState newState) {
        
    }

    @Override
    public void onRtcConnected() {
        // ice已连接
    }

    @Override
    public void onRtcDisconnect() {
        // ice已断开
    }

    @Override
    public void onRtcConnectFailed() {
        // ice连接失败，通常fail发生在连接断开之后
    }

    @Override
    public void onChannelMessage(DataChannel.Buffer buffer) {
        // P2P Channel接收到消息
    }

其他API

方法 说明
getPeerConnection() P2P连接
getChannel() P2P连接中的数据通道
getLocalRecordFile() 本地录制的视频文件
getLocalSavePath() 本地录制视频保存路径
setCustomLocalSavePath() 自定义本地视频保存路径
getRemoteRecordFile() 远程录制的视频文件
getRemoteSavePath() 远程录制视频保存路径
setCustomRemoteSavePath 自定义远程视频保存路径
switchCamera() 切换摄像头