图7.2.2-1 SDK流程

1. 创建新的项目工程，导入SDK后，需要创建客户端并获取本地音视频设备信息。
2. 创建本地流并初始化。
3. 当用户加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以对音视频流进行订阅、取消订阅等其它操作。
4. 在会中，也可以对本地录音或播放设备等进行配置。
5. 用户离开房间后，房间内其他用户会收到该用户离开的回调信息，离开房间后，需销毁对应资源。

在时序图中，单击相应接口名称可快速跳转到相应接口位置查看其使用方法。

1. 创建引擎并初始化样例。

  private void ensureEngineCreated() {        try {            mRtcEngine = new CreateVideoEngine().create(mContext, EngineType.ISDP);   //创建引擎            mRtcEngine.createVideo(mContext, appId,                    videoEngineListener);    //初始化引擎对象        } catch (Exception e) {                     }  }

2.回调监听器样例。

private ISDPVideoEngineListener videoEngineListener = new ISDPVideoEngineListener () {        @Override    //远端视频流状态变化回调        public void onRemoteVideoStateChanged(String s, int i, int i1, int i2) {        }        @Override   //远端音频流状态变化回调        public void onRemoteAudioStateChanged(String s, int i, int i1, int i2) {        }        @Override   //加入房间成功回调        public void onJoinMainChannelSuccess(String s, String s1, int i) {        }        @Override   //远端用户加入房间回调        public void onMainUserJoined(String s, String s1, int i) {        }        @Override   //加入房间失败回调        public void onMainError(int i) {        }        @Override   //远端用户离开房间回调        public void onMainUserOffline(String s, int i) {        }         @Override   //离开房间回调        public void onMainLeaveChannel(RtcStats rtcStats) {        }        @Override   //远端用户第一帧解码成功回调        public void onMainFirstRemoteVideoFrame(String s, int i, int i1, int i2) {        }        @Override   //用户第一帧解码成功回调        public void onMainFirstLocalVideoFrame(int i, int i1, int i2) {        }        @Override   //客户端角色改变回调        public void onClientRoleChanged(int i, int i1) {        }        @Override   //音频流状态改变回调        public void onLocalAudioStateChanged(int i, int i1) {        }        @Override   //远端视频流状态回调        public void onRemoteVideoStats(RemoteVideoStats remoteVideoStats) {        }        @Override   //刷新入会凭证        public void renewToken() {        }        @Override   //第一帧音频解码成功回调        public void onFirstLocalAudioFrame(int i) {        }        @Override   //远端用户第一帧视频解码回调        public void onFirstRemoteVideoDecoded(String s, int i, int i1, int i2) {        }        @Override  //推流发布回调        public void onStreamPublished(String s, int i) {        }        @Override   //Token即将失效回调        public void onTokenPrivilegeWillExpire(String s) {        }        @Override   //远端用户音频状态回调        public void onRemoteAudioStats(RemoteAudioStats remoteAudioStats) {        }        @Override   //远端用户第一帧音频回调        public void onFirstRemoteAudioFrame(String s, int i) {        }         /**         * 当前音频播放方式改变         *         * @param mode 0-默认是扬声器 1-耳机         */        @Override        public void onAudioPlayModelChanged(int mode) {        }        @Override   //音量调整回调        public void onAudioVolumeIndication(AudioVolumeInfo[] audioVolumeInfos, int i) {        }        @Override   //媒体服务状态回调        public void onRtcStats(RtcStats rtcStats) {        }        @Override   //网络质量回调        public void onNetworkQuality(String s, int i, int i1) {        }        @Override   //监控数据上报回调        public void onMonitorReady(MonitorInfo monitorInfo) {        }        @Override   //媒体服务连接状态改变回调        public void onConnectionStateChanged(int i, int i1) {        }        @Override   //媒体服务连接失败回调        public void onConnectionLost() {        } };

3.加入房间。

public void joinChannel(String channelId, final String token, String userId) {        if (TextUtils.isEmpty(channelId)) {            return;         }        if (mRtcEngine == null) {            VideoSDKLogger.info(tag, "joinChannelWithRtcChannel  rtcEngine is null:");            return;        }        mRtcEngine.joinChannel(channelId,token,"",userId, appId, null);    }

4.创建预览视图，在 （onJoinChannelSuccess回调成功后）。

public final void preview(SurfaceView view, String channelId, String userId) {        ensureEngineCreated();        if (mRtcEngine != null) {                mRtcEngine.setupLocalVideo(view, VideoCanvas.RENDER_MODE_HIDDEN, userId);                mRtcEngine.startPreview(channelId);           }

5.离开房间。

RtcEngine.leaveChannel();finish();

6.销毁引擎

RTCEngine.onDestroy();