tencent cloud

文档反馈

最后更新时间:2024-06-17 17:41:52
    本文介绍群组通话功能的使用,如发起群组通话、加入群组通话。

    预期效果

    TUICallKit 支持群组通话,预期效果见下图。
    Web 端
    移动端
    
    
    
    
    
    

    创建 groupID

    使用群组通话功能前,需要先创建群组,在已存在的群组中发起群组通话。
    方式一:通过调用 Chat API 创建群,详见 Chat 群组管理
    方式二:通过控制台手动创建群组,详见 控制台群组管理
    import Chat from "@tencentcloud/chat"; // npm i @tencentcloud/chat
    
    const userIDList: string[] = ['user1', 'user2'];
    async function createGroupID() {
    const chat = Chat.create({ SDKAppID });
    const memberList: any[] = userIDList.map(userId => ({ userID: userId }));
    const res = await chat.createGroup({
    type: Chat.TYPES.GRP_PUBLIC, // Must be a public group
    name: 'WebSDK',
    memberList
    });
    return res.data.group.groupID;
    }

    群组通话

    发起群组通话

    调用 groupCall API 发起群通话。
    import { TUICallKitServer, TUICallType } from "@tencentcloud/call-uikit-react";
    // Replace it with the call-uikit npm package you are currently using
    
    try {
    const params = {
    userIDList: ['user1', 'user2'],
    groupID: 'xxx',
    type: TUICallType.VIDEO_CALL,
    }
    await TUICallKitServer.groupCall(params);
    } catch (error: any) {
    console.error(`[TUICallKit] groupCall failed. Reason:${error}`);
    }

    加入群组通话

    调用 joinInGroupCall API 主动加入群组中已有的音视频通话。
    说明:
    v3.1.2+ 支持。
    import { TUICallKitServer, TUICallType } from "@tencentcloud/call-uikit-react";
    // Replace it with the call-uikit npm package you are currently using
    
    try {
    const params = {
    type: TUICallType.VIDEO_CALL,
    groupID: "xxx",
    roomID: 0,
    };
    await TUICallKitServer.joinInGroupCall(params);
    } catch (error: any) {
    console.error(`[TUICallKit] joinInGroupCall failed. Reason: ${error}`);
    }
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持