Docs Overview/
Call/
Android/
基础功能/
群组通话/

群组通话

本文介绍群组通话功能的使用，如发起群组通话、加入群组通话。

预期效果

TUICallKit 支持群组通话，预期效果见下图。
发起群组通话
收到群组通话请求
接受群组通话请求










创建 groupID

使用群组通话功能前，需要先创建群组，在已存在的群组中发起群组通话。
方式一：通过调用 Chat API 创建群，详见 Chat 群组管理。
方式二：通过控制台手动创建群组，详见 控制台群组管理。

群组通话

发起群组通话

调用 groupCall API 发起群通话。
Android（Kotlin）
Android（Java）
iOS（Swift）
iOS（Objective-C）
Flutter（Dart）
import com.tencent.qcloud.tuikit.tuicallengine.TUICallDefine
import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit

TUICallKit.createInstance(context).groupCall("12345678", Arrays.asList("jane", "mike", "tommy"), TUICallDefine.MediaType.Video)
import com.tencent.qcloud.tuikit.tuicallengine.TUICallDefine;
import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit;

TUICallKit.createInstance(context).groupCall("12345678", Arrays.asList("jane", "mike", "tommy"),TUICallDefine.MediaType.Video);
import TUICallKit_Swift
import TUICallEngine

TUICallKit.createInstance().groupCall(groupId: "12345678",
                                      userIdList: ["denny", "mike", "tommy"],
                                      callMediaType: .video)

#import <TUICallKit_Swift/TUICallKit_Swift-Swift.h>
#import <TUICallEngine/TUICallEngine.h>

[[TUICallKit createInstance] groupCallWithGroupId:@"12345678"
                                       userIdList:@[@"denny", @"mike", @"tommy"] 
                                    callMediaType:TUICallMediaTypeVideo];
import 'package:tencent_calls_uikit/tencent_calls_uikit.dart';

void groupCall() {
    TUICallKit.instance.groupCall('0001', ['denny', 'mike', 'tommy'], TUICallMediaType.video);
}

加入群组通话

调用 joinInGroupCall API 主动加入群组中已有的音视频通话。
Android（Kotlin）
Android（Java）
iOS（Swift）
iOS（Objective-C）
Flutter（Dart）
import com.tencent.qcloud.tuikit.TUICommonDefine
import com.tencent.qcloud.tuikit.tuicallengine.TUICallDefine
import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit

var roomId = TUICommonDefine.RoomId()
roomId.intRoomId = 123321
var groupId = "12345678"
TUICallKit.createInstance(context).joinInGroupCall(roomId, groupId, TUICallDefine.MediaType.Video)
import com.tencent.qcloud.tuikit.TUICommonDefine;
import com.tencent.qcloud.tuikit.tuicallengine.TUICallDefine;
import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit;

TUICommonDefine.RoomId roomId = new TUICommonDefine.RoomId();
roomId.intRoomId = 123321;
String groupId = "12345678";
TUICallKit.createInstance(context).joinInGroupCall(roomId, groupId, TUICallDefine.MediaType.Video);
import TUICallKit_Swift
import TUICallEngine

let roomId = TUIRoomId()
roomId.intRoomId = 123321
TUICallKit.createInstance().joinInGroupCall(roomId: roomId,
                                      groupId: "1234567",
                                      callMediaType: .video)
#import <TUICallKit/TUICallKit.h>
#import <TUICallEngine/TUICallEngine.h>

TUIRoomId *roomId = [[TUIRoomId alloc] init];
roomId.intRoomId = 123321;
[[TUICallKit createInstance] joinInGroupCallWithRoomId:roomId 
                                               groupId:@"223344"
                                         callMediaType:TUICallMediaTypeVideo];
import com.tencent.qcloud.tuikit.TUICommonDefine
import com.tencent.qcloud.tuikit.tuicallengine.TUICallDefine
import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit

var roomId = TUICommonDefine.RoomId()
roomId.intRoomId = 123321
TUICallKit.createInstance(context).joinInGroupCall(roomId, "12345678", TUICallDefine.MediaType.Video)