实现多方语音通话

本章将介绍如何实现多方语音通话，多方语音通话的 API 调用时序见下图：

/cn/document/V2.1/images/doc_python_image/multiaudioworkflow.png

初始化

首先继承 JCMediaChannelCallback 对象和 JCMediaDeviceCallback 对象，并实现这两个对象中的纯虚函数。

class JCManager : public JCMediaDeviceCallback, public JCMediaChannelCallback
{
public:

    //自身状态变化回调
    virtual void onMediaChannelStateChange(JCMediaChannelState state, JCMediaChannelState oldState);
    //频道属性变化回调
    virtual void onMediaChannelPropertyChange(JCMediaChannelPropChangeParam propChangeParam);
    //加入频道结果回调
    virtual void onJoin(bool result, JCMediaChannelReason reason, const char* channelId);
    //离开频道结果回调
    virtual void onLeave(JCMediaChannelReason reason, const char* channelId);
    //解散频道结果回调
    virtual void onStop(bool result, JCMediaChannelReason reason);
    //查询频道结果回调
    virtual void onQuery(int operationId, bool result, JCMediaChannelReason reason, JCMediaChannelQueryInfo* queryInfo);
    //新成员加入回调
    virtual void onParticipantJoin(JCMediaChannelParticipant* participant);
    //成员离开回调
    virtual void onParticipantLeft(JCMediaChannelParticipant* participant);
    //成员更新回调
    virtual void onParticipantUpdate(JCMediaChannelParticipant* participant, JCMediaChannelParticipant::ChangeParam changeParam);
    //频道中收到消息回调
    virtual void onMessageReceive(const char* type, const char* content, const char* fromUserId);
    //邀请sip成员结果回调
    virtual void onInviteSipUserResult(int operationId, bool result, JCMediaChannelReason reason);
    //成员声音变化
    virtual void onParticipantVolumeChange(JCMediaChannelParticipant* participant);

public:
    //媒体设备对象
    JCMediaDevice* mediaDevice;
    //媒体通道对象
    JCMediaChannel* mediaChannel;
};

然后调用 createJCMediaDevice 和 createJCMediaChannel 以初始化多方视频通话需要的模块：

//初始化
bool JCManager::initialize()
{
    //1. 媒体类
    mediaDevice = createJCMediaDevice(client, this);
    //1. 媒体通道类
    mediaChannel = createJCMediaChannel(client, mediaDevice, this);
    return true;
}

其中：

JCMediaDevice create 方法中的 this 为 JCMediaDeviceCallback 的派生类，该类于将媒体设备相关的事件通知给上层。因此需要先创建 JCMediaDeviceCallback 的派生类，然后在该派生类中实现 JCMediaDeviceCallback 的纯虚函数。
JCMediaChannel create 方法中的 this 为 JCMediaChannelCallback 的派生类，该类用于将频道中的相关事件通知给上层。因此需要先创建 JCMediaChannelCallback 的派生类，然后在该派生类中实现 JCMediaChannelCallback 的纯虚函数。

回调中的对象只能在该回调中使用，不能保存，上层可通过对应的方法获取通话对象。

加入频道

JC SDK 默认不上传本地音频流，因此如果需要进入会议中就能听到彼此的声音，需要在加入频道前预打开音频流上传的标识:

1. 调用 enableUploadAudioStream 开启音频流。

// 开启音频流
JCManager::shared()->mediaChannel->enableUploadAudioStream(true);

该接口可以在加入频道之前调用，也可以在加入频道之后调用。两者区别具体如下。

如果在加入频道前调用，只是打开或关闭“上传音频”的标识，但不会发送数据，当加入频道成功时会根据 enableUploadAudioStream 设定的值来确定是否上传音频数据。同时，频道中的其他成员会收到该成员“是否上传音频“的状态变化回调(onParticipantUpdate)。

如果在加入频道后调用，则会开启或者关闭发送本地音频流数据，服务器也会根据 enableUploadAudioStream 设定的值来确定是否上传音频数据。同时，频道中的其他成员会收到该成员“是否上传音频“的状态变化回调(onParticipantUpdate)。

此外，此方法还可以实现开启或关闭静音的功能。当 enable 值为 false ，将会停止发送本地音频流，此时您可以听到其他成员的声音，但是其他成员将听不到您的声音，从而实现静音功能。

由于 SDK 默认上传视频流，因此需要在加入频道前关闭上传视频流的标识以进行语音通话

// 关闭视频流上传
JCManager::shared()->mediaChannel->enableUploadVideoStream(false);

调用 join 方法加入频道。你需要在该方法中传入如下参数：

channelIdOrUri：频道 ID 或频道 Uri，当 param 中 uriMode 设置为 true 时表示频道 Uri，其他表示频道 ID。频道 ID 或 Uri 相同的用户会进入同一个频道。
joinParam：加入参数，没有则填 NULL。详见 JCMediaChannelJoinParam 对象。

// 加入频道
JCManager::shared()->mediaChannel->join("频道 ID", NULL);

3. 加入频道后会收到 onJoin 回调。

// 加入频道结果回调
void JCManager::onJoin(bool result, JCMediaChannelReason reason, const char* channelId)
{
    if (result) {
    //加入成功的逻辑
    ...
    } else {
    //加入失败的逻辑
    ...
    }
}

离开频道

调用 leave 方法离开当前频道。

JCManager::shared()->mediaChannel->leave();

离开频道后，自身收到 onLeave 回调，其他成员同时收到 onParticipantLeft 回调。

// 离开频道回调
void JCManager::onLeave(JCMediaChannelReason reason, const char* channelId);
{
    //离开频道的逻辑
}

解散频道

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

// 结束频道
JCManager::shared()->mediaChannel->stop();

解散频道后，发起结束的成员收到 onStop 回调，其他成员同时收到 onLeave 回调。解散失败原因枚举值请参考 JCMediaChannelReason 。

void JCManager::onStop(bool result, JCMediaChannelReason reason)
{
    //结束频道的处理逻辑
}

至此，您已经完成基础的多方语音通话功能。