tt.unbindUnionGroup
基础库 3.51.0 开始支持本方法,这是一个异步方法。
解除指定公会和公开群的绑定关系
| 前提条件 | 需要提前调用 tt.login({force: true}) 保证用户已登录宿主 |
| 业务背景 | 无 |
| 使用限制 |
|
| 注意事项 | IDE 上该接口返回模拟结果,请使用真机预览调试 |
| 相关教程 |
语法
tt.unbindUnionGroup(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 | "unbindUnionGroup:ok" | 3.51.0 |
回调失败
object 类型,属性如下:
| 属性名 | 类型 | 说明 | 最低支持版本 |
|---|---|---|---|
| errMsg | string | "unbindUnionGroup:fail" + 详细错误信息 | 3.51.0 |
错误码
| errorCode | errMsg | errorType | 说明 | 最低支持版本 |
|---|---|---|---|---|
| 136001 | unknown error | F | 小游戏框架内部错误,有需要请创建工单咨询 | 3.51.0 |
| 136002 | server error | F | 小游戏框架内部错误,有需要请创建工单咨询 | 3.51.0 |
| 136003 | union is not bound to a group | D | 公会未绑定公开群 | 3.51.0 |
| 136004 | not the same operator | D | 解绑人和绑定人不是同一个人 | 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.unbindUnionGroup({ unionId: 'testUnionId', success(res) { console.log('tt.unbindUnionGroup success', res); }, fail(res) { console.log('tt.unbindUnionGroup failed', res); } });
