基础库 2.70.0 开始支持本方法，这是一个异步方法。

在平台创建群聊，获得 groupid 后，游戏内通过这个方法引导用户加入抖音群

前提条件	使用本 API 前需要先在开发者平台创建群聊获取 groupid。具体可参考游戏群聊能力接入介绍前往开发者平台，「运营 - 运营能力 - 粉丝群能力」，申请开通能力扫码绑定抖音号后，点击「新建群聊」以获得对应的群 ID
业务背景	无
使用限制	目前仅支持抖音及抖音极速版该 API 必须要由用户点击触发，只能在 tt.onTouchEnd 的回调里面同步调用该 API
注意事项	无
相关教程	游戏群聊能力接入介绍

语法

tt.joinGroup(options)

参数说明

options 为 object 类型，属性如下：

属性名	类型	必填	说明	最低支持版本
extraInfo	string	否	附加信息	2.70.0
groupid	string	是	群 ID	2.70.0
success	function	否	接口调用成功的回调函数	2.70.0
fail	function	否	接口调用失败的回调函数	2.70.0
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）	2.70.0

回调成功

object 类型，属性如下：

属性名	类型	说明	最低支持版本
data	object	加群信息	2.70.0
errMsg	string	"joinGroup:ok"	2.70.0

data 类型说明

object 类型，属性如下：

属性名	类型	说明	最低支持版本
openid	string	用户的openid	2.70.0
groupid	string	群 ID	2.70.0

回调失败

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"joinGroup:fail" + 详细错误信息	2.70.0

错误码

errNo	errMsg	说明	最低支持版本
21000	the group is not authorized to the app		2.70.0
21001	internal error	小游戏框架内部错误，有需要请创建工单咨询	2.70.0
20001	invalid param	参数错误	2.70.0
20000	internal error	小游戏框架内部错误，有需要请创建工单咨询	2.70.0
10301	feature is not supported in app		2.70.0
20000	groupid is nil.		2.70.0
21000	user login failed		2.70.0
21003	internal error.	小游戏框架内部错误，有需要请创建工单咨询	2.70.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.joinGroup({
    groupid: "998877", //加入的群id，可在平台创建群聊后获得
    sessionFrom: "sessionFrom",
    extraInfo: "extraInfo",
    success(res) {
        console.log(res);
    },
    fail(res) {
        console.log(res);
    }
});