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

给指定公会绑定公开群

前提条件	需要提前调用 tt.login({force: true}) 保证用户已登录宿主
业务背景	无
使用限制	目前仅支持抖音，抖 lite，可以使用 tt.getSystemInfoSync 判断宿主该 API 必须要由用户点击触发，也就是只能在 tt.onTouchEnd 的回调里面同步调用该 API
注意事项	无
相关教程	公会群能力指南

语法

tt.bindUnionGroup(options)

参数说明

options 为 object 类型，属性如下：

属性名	类型	必填	说明	最低支持版本
unionId	string	是	查询绑定群信息的公会 ID，格式限制为字母数字下划线，长度不超过 30	3.51.0
success	function	否	接口调用成功的回调函数	3.51.0
fail	function	否	接口调用失败的回调函数	3.51.0
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）	3.51.0

回调成功

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"bindUnionGroup:ok"	3.51.0
bindResult	boolean	是否绑定公开群，true 完成绑定，false 未绑定	3.51.0

回调失败

object 类型，属性如下：

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

错误码

errorCode	errMsg	errorType	说明	最低支持版本
135901	unknown error	F	小游戏框架内部错误，有需要请创建工单咨询	3.51.0
135902	server error	F	小游戏框架内部错误，有需要请创建工单咨询	3.51.0
135903	union has been bound to a group	D	公会已绑定公开群	3.51.0
135904	user auth deny	U	用户拒绝授权	3.51.0
135905	user auth expired	U	用户授权过期	3.51.0
135906	user auth fail	F	小游戏框架内部错误，有需要请创建工单咨询	3.51.0
135907	open auth fail	F	小游戏框架内部错误，有需要请创建工单咨询	3.51.0
135908	open page fail	F	小游戏框架内部错误，有需要请创建工单咨询	3.51.0
999976	must be invoked by user tap gesture	D	该API需要由用户点击触发	3.51.0
999985	network unavailable	U	网络请求失败	3.51.0
999986	invoke too frequently	D	调用频率过高	3.51.0
999987	The feature is not supported in app	D	宿主未支持	3.51.0
999988	The feature is not available in current operating system	D	当前系统不支持	3.51.0
999996	not login	D	用户未登录	3.51.0
999999	invalid param	D	参数错误	3.51.0

代码示例

开发者工具中预览

tt.bindUnionGroup({
  unionId: 'testUnionId',
  success(res) {
    console.log('tt.bindUnionGroup success', res);
  },
  fail(res) {
    console.log('tt.bindUnionGroup failed', res);
  }
});