抖音开放平台Logo
控制台

button组件小程序跳转加群
收藏
我的收藏

​基础库 2.69.0 开始支持本能力。支持小程序跳转加群能力，需要将 button 组件 open-type 的值设置为 joinGroup。​
​button 组件常规属性请参考button 按钮。​

​语法​

HTML
复制
<button open-type="joinGroup" group-id="fansGroup123"></button>

​属性说明​

属性名​
类型​
默认值​
必填​
说明​
最低支持版本​
group-id​
string​
​
是​
群聊 id，通过创建聊天群、查询群信息获取​
2.69.0​
data-is-half-page​
boolean​
​
否​
是否开启半屏模式​
2.88.0​
bindjoingroup​
EventHandle​
​
否​
加群后触发​
2.69.0​

​bindjoingroup 事件对象的 detail​

object 类型，属性如下：​
属性名​
类型​
说明​
最低支持版本​
errMsg​
string​
错误描述​
2.69.0​
errNo​
number​
错误码​
2.69.0​

​错误说明​

​errMsg​
​errNo​
​说明​
​最低支持版本​
​onJoinGroup:fail invalid params​
​20000​
​参数少传​
2.69.0​
​onJoinGroup:fail service error , code = %s​
​21100​
​下游服务异常​
2.69.0​
​onJoinGroup:fail Internal error , code = %s​
​21101​
​参数错误​
2.69.0​
​onJoinGroup:fail have no permission​
​21102​
​获取群信息失败​
2.69.0​
​onJoinGroup:fail login failed​
​21103​
​登录失败​
2.69.0​
onJoinGroup:fail get openid fail​
​21104​
​openid 获取失败​
2.69.0​

​代码示例​

HTML
复制
<!-- index.ttml -->
<button
open-type="joinGroup"
group-id="@4F9R0vKUDsthbXTzOI1qGaD6umLoPviHM5F2rw+mLlkbbvH60nPbQGAsjAv/6TcHfpCrVl8fxxxxxxxxx=="
bindjoingroup="handleJoinGroup"
></button>
JavaScript
复制
page{(
data: {},
handleJoinGroup(e) {
console.log(e.detail);
};
)};

​Bug & Tip​

    •​Tip：使用加群组件的 appId 和创建群时群主授权的 appId（client_key）需要相同，否则会报错误码 2150004​
​​