频道管理

频道信息查询

调用 query (opens new window) 接口查询频道相关信息，例如频道名称、频道是否存在、成员名以及成员数。

JCManager::shared()->mediaChannel->query("channelId");

查询操作发起后，查询的结果通过 onQuery (opens new window) 回调上报。

void JCManager::onQuery(int operationId, bool result, JCMediaChannelReason reason, JCMediaChannelQueryInfo* queryInfo)
{
    //查询结果
    if (result) {
        //查询到的 channelId
        CString channelId = queryInfo->getChannelId();
        //查询到的成员数
        int number = queryInfo->getClientCount();
    }
}

发送消息

如果想在频道中给其他成员发送消息，可以调用 sendMessage (opens new window) 方法。

//最后一个参数为接收者 id，如果为空则会发给频道所有人员
JCManager::shared()->mediaChannel->sendMessage(type, "消息内容", NULL);

其中，type（消息类型）为自定义类型。例如 text、image、file 等类型，在对收到的消息进行解析时消息类型需要保持一致。

当频道中的其他成员收到消息时，会收到 onMessageReceive (opens new window) 回调。

void JCManager::onMessageReceive(const char* type, const char* content, const char* fromUserId)
{
    std::stringstream s;
    s << "收到Conf消息 " << fromUserId << " type:" << type << " content:" << JCTool::Utf8ToGB2312(content);
}

频道成员管理

获取频道成员

调用 getParticipant (opens new window) 方法，传入成员的 userId 获取频道成员对象。

JCMediaChannelParticipant* participant = JCManager::shared()->mediaChannel->getParticipant(userId);

获取频道所有成员对象

调用 getParticipants (opens new window) 方法获取频道所有成员对象。

std::list<JCMediaChannelParticipant*>* participants = JCManager::shared()->mediaChannel->getParticipants();

踢出成员

调用 kick (opens new window) 方法将成员踢出会议。

//获取成员对象
JCMediaChannelParticipant* participant = JCManager::shared()->mediaChannel->getParticipant(userId);
//踢除成员
JCManager::shared()->mediaChannel->kick(participant);

频道属性设置

在调用 JCMediaChannel 中的 join 函数加入/创建频道前，您可以通过 JoinParam 类来设置频道属性，如频道允许加入的最大人数、推流参数、录制参数等。其默认参数如下所示。

// 会议最大人数
public int capacity;
// 推流参数
public char cdn [512];
// 录制参数
public JCMediaChannelRecordParam record;
// 密码
public char password [64];
// 平滑模式
public bool smooth;
// 会议最大分辨率
public JCMediaChannelMaxResolution maxResolution;
// 心跳间隔
public int heartbeatTime;
// 心跳超时
public int heartbeatTimeout;
// 帧率 1-30, 默认 24
public int framerate;
// 自定义属性
public char customProperty [1024];
// 自定义媒体每层参数
public char customVideoResolution [128];
// 会议画面比例
public float videRatio;

最大人数设置

您可以通过改变 capacity 参数来调整频道最大人数。

JCMediaChannelJoinParam* joinParam = new JCMediaChannelJoinParam();
// 设置最大人数
joinParam->capacity = 6;
// 加入频道
mediaChannel->join("222", joinParam);

会议最大分辨率设置

您可以通过改变 maxResolution 参数来调整频道最大分辨率。

JCMediaChannelJoinParam* joinParam = new JCMediaChannelJoinParam();
// 设置会议最大分辨率
joinParam->maxResolution = JCMediaChannelMaxResolution360P;
// 加入频道
mediaChannel->join("222", joinParam);

TIP

菊风默认提供 360p 的最大分辨率，如需设置会议最大分辨率 720p，1080p，您可以通过发送邮件与我们取得联系：marketing@juphoon.com.cn 。