# 实现互动直播

本章将介绍如何实现视频互动直播,视频互动直播的 API 调用时序见下图:

../../../../_images/multivideoworkflow.jpg

# 初始化

调用 JCMediaDevice.create (opens new window)JCMediaChannel.create (opens new window) 以初始化实现多方通话需要的模块。

// 声明对象
JCMediaDevice mMediaDevice;
JCMediaChannel mMediaChannel;

// 初始化函数
public boolean initialize(Context context) {

    //1. 媒体类
    mMediaDevice = JCMediaDevice.create(mClient, new JCMediaDeviceCallback() {
        @Override
        public void onCameraUpdate() {

        }
        @Override
        public void onAudioOutputTypeChange(int i) {

        }
        @Override
        public void onRenderReceived(JCMediaDeviceVideoCanvas jcMediaDeviceVideoCanvas) {

        }
        @Override
        public void onRenderStart(JCMediaDeviceVideoCanvas jcMediaDeviceVideoCanvas) {

        }
    });
    // 2. 媒体通道类
    mMediaChannel = JCMediaChannel.create(client, mediaDevice, new JCMediaChannelCallback() {
        @Override
        public void onMediaChannelStateChange(int i, int i1) {

        }
        @Override
        public void onMediaChannelPropertyChange(JCMediaChannel.PropChangeParam propChangeParam) {

        }
        @Override
        public void onJoin(boolean b, int i, String s) {

        }
        @Override
        public void onLeave(int i, String s) {

        }
        @Override
        public void onStop(boolean b, int i) {

        }
        @Override
        public void onQuery(int i, boolean b, int i1, JCMediaChannelQueryInfo jcMediaChannelQueryInfo) {

        }
        @Override
        public void onParticipantJoin(JCMediaChannelParticipant jcMediaChannelParticipant) {

        }
        @Override
        public void onParticipantLeft(JCMediaChannelParticipant jcMediaChannelParticipant) {

        }
        @Override
        public void onParticipantUpdate(JCMediaChannelParticipant jcMediaChannelParticipant, JCMediaChannelParticipant.ChangeParam changeParam) {

        }
        @Override
        public void onMessageReceive(String s, String s1, String s2) {

        }
        @Override
        public void onInviteSipUserResult(int i, boolean b, int i1) {

        }
        @Override
        public void onParticipantVolumeChange(JCMediaChannelParticipant jcMediaChannelParticipant) {

        }
    });
}

# 角色设置

加入频道前要先进行角色的设置。其中角色设置包括主播和观众。 角色值可以根据 JCMediaChannel.CustomRole (opens new window) 枚举值进行自定义,例如

//自定义主播角色,根据CustomState枚举值自定义角色
int ROLE_BROASCASTER = JCMediaChannel.CUSTOM_ROLE_0;
//自定义观众角色,根据CustomState枚举值自定义角色
int ROLE_AUDIENCE = JCMediaChannel.CUSTOM_ROLE_1;

调用 setCustomRole (opens new window) 设置自己的角色以进入频道。

// 设置角色,participant(第二个参数) 值为 null 代表设置自身的角色
mediaChannel.setCustomRole(ROLE_BROASCASTER, null);

# 加入频道

  1. 调用 enableUploadAudioStream (opens new window) 开启音频流。若要开启视频,调用 enableUploadVideoStream (opens new window) 开启视频流。

    // 1. 开启音频流
    mMediaDeviceChannel.enableUploadAudioStream(true);
    // 2. 开启视频流(语音无需调用此方法)
    mMediaDeviceChannel.enableUploadVIdeoStream(true);
    
  2. 创建并加入频道,需要传入 channelIdOrUriJCMediaChannel.JoinParam (opens new window)

    • channelIdOrUri 表示频道 ID 或频道 Uri。

    • JCMediaChannelJoinParamuriMode 参数设置为 true 时表示传入频道 Uri,设置其他参数时表示传入频道 ID。传入相同的频道 ID 或相同的频道 Uri 的用户会进入同一个频道。

    mMediaChannel.join("222", null);
    
  3. 加入频道后自身会收到 onJoin (opens new window) 回调。其他成员会收到 onParticipantJoin (opens new window) 回调。

    @Override
    public void onJoin(boolean result, @JCMediaChannel MediaChannelReason int reason, String channelId) {
        if (result) {
            // 加入频道成功
        } else {
            // 加入频道失败
        }
    }
    

# 创建远端视频画面

视频通话中,通常需要看到其他用户。加入频道后,调用 JCMediaChannel (opens new window) 中的 getParticipants (opens new window) 获取频道内所有成员对象。

然后调用 JCMediaChannelParticipant (opens new window) 类中的 startVideo (opens new window) 获取远端视频画面。返回对象为 JCMediaDeviceVideoCanvas (opens new window)

startVideo (opens new window) 方法调用后,还需要调用 JCMediaChannel (opens new window) 中的 requestVideo (opens new window) 方法请求频道中其他用户的视频流。

// 获取所有成员对象
List<JCMediaChannelParticipant> participants = mMediaChannel.getParticipants();
// 调用创建视频画面的方法
participants.get(0).startVideo(JCMediaDevice.RENDER_FULL_CONTENT, JCMediaChannel.PICTURESIZE_LARGE);
// 请求远端视频流, 此处调用大尺寸视频窗口
mMediaChannel.requestVideo(participants.get(0), JCMediaChannel.PICTURESIZE_LARGE);

# 离开频道

调用 leave (opens new window) 方法可以离开当前频道。

mMediaChannel.leave();

在多方视频通话中,离开频道还需要调用 stopVideo (opens new window) 移除视频画面。

mParticipant.stopVideo();

离开频道后,自身收到 onLeave (opens new window) 回调,其他成员同时收到 onParticipantLeft (opens new window) 回调。

# 销毁本地和远端视频画面

调用 JCMediaChannelParticipant (opens new window) 里的 stopVideo (opens new window) 销毁本地和远端视频画面。

// 离开频道结果回调
@Override
public void onLeave(@JCMediaChannel.MediaChannelReason int reason, String channelId) {
    ...
    // 销毁视频画面
    mParticipant.stopVideo();
}

# 解散频道

如果想解散频道,可以调用下面的接口,此时所有成员都将被退出。

// 结束频道
mMediaChannel.stop();

在多方视频通话中,离开频道还需要调用 stopVideo (opens new window) 移除视频画面。

mParticipant.stopVideo();

解散频道后,发起结束的成员收到 onStop (opens new window) 回调,其他成员同时收到 onLeave (opens new window) 回调。 解散失败原因枚举值请参考 MediaChannelReason (opens new window)

@Override
public void onStop(boolean result, @JCMediaChannel.MediaChannelReason int reason) {
    // 销毁视频, canvas 为 JCMediaDeviceVideoCanvas 对象实例
    mParticipant.stopVideo();
    canvas = null;
}