抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 开发指南
  • 运行时
  • 游戏引擎
  • 开放能力
  • 小游戏站
  • PC 端小游戏
  • 开放数据域基础能力
  • 商业化激励再得能力介绍
  • 「必接」侧边栏复访能力技术指南
  • 游戏排行榜功能介绍
  • 游戏推荐组件能力介绍
  • 订阅消息能力介绍
  • 游戏群聊能力接入介绍
  • 关注抖音号能力介绍
  • 多端支持
  • 推荐流直出游戏能力
  • 游戏礼包
  • 游戏转发分享
  • 支付
  • 广告
  • 转发
  • 关系链
  • 公会群能力指南
  • 用户信息
  • 获取小程序链接
  • 直播间即看即玩能力技术指南
  • 基础能力
  • 性能优化
  • 开放接口
  • AI
  • 安全指引
  • 安全指引
  • 公会群能力指南

    收藏
    我的收藏

    能力简介:

    抖音「公会群」旨在打造一个便捷化的交流互动平台,便于公会成员之间进行沟通交流,以及高效组织各类游戏相关活动 。公会长可在抖音平台自行创建公会、联盟、帮派等的专属群组,并将其与游戏内的公会进行绑定操作。绑定完成后,公会成员即可在游戏内一键加群至相应群中。
      「公会群」互动案例:
    公会活动组织
    攻略经验分享
    游戏日常交流
    游戏组队开黑
    游戏资讯分享

    数据效果:

      LT :加群前 VS 加群后,人均游戏时长 + 15.5%。
      留存:加群玩家 VS 小游戏玩家大盘,次日留存高 33%,7 日留存高 27%。
      群活跃:公会群 VS 活跃群大盘,日均发言率高 16.2%,日均进群率高 28.6%。

    能力示意图:

    分为公会长和公会成员的流程,部分页面实现逻辑(包括 UI)由小游戏承接、剩余部分由平台承接,请详细看图区分。

    前置准备:

    检查基础库版本:基础库版本 >= 3.51.0.0

    接入流程:

    名词说明:

    名词
    说明
    公会
    游戏内自行维护的群体,可以是帮派,群组等,通过 unionId 唯一标识
    公会长
    游戏内自行维护的公会的管理人员,一般给予公会长绑定和公开群的权限
    unionId
    游戏与平台交互的主要字段,由游戏侧生成和存储,平台会记录 unionId 与 公开群的绑定信息,并提供查询/绑定/解绑 等能力

    整体链路:

    场景细拆:

    场景
    步骤说明
    示例截图
    前置判断
      1.通过 tt.canIuse("getUnionGroupInfo") 判断当前环境和应用版本是否支持公会群能力:
      a.不支持则不应展示公会群相关的信息
      b.支持则继续
    展示公会群信息
      1.游戏内自行判断用户是否为公会成员;
      2.通过 tt.getUnionGroupInfo 获取当前公会是否有绑定过公开群
      a.如果未绑定则给特定用户,比如公会长展示绑定按钮
      b.如果已绑定则展示加入公开群按钮(一个公会只支持绑定一个公开群,请勿提供绑定入口重复绑定)
    绑定公会和公开群(公会长)
      1.公会长点击触发 tt.bindUnionGroup 接口,接口成功回调可获取绑定结果;
      a.success bindResult = true:绑定成功更新游戏公会群信息,展示解绑(公会长)/进群入口(公会成员);
      b.success bindResult = false:用户未进行绑定操作,游戏按需进行提示或者引导重新;
      c.fail 回调:绑定失败,请参考错误码排查;
    解除绑定公会和公开群(公会长)
    JSAPI 解绑必须和绑定是同一人
    OpenAPI 支持游戏服务端解除绑定
      1.公会长点击触发 tt.unbindUnionGroup 接口:
      a.success 回调:解绑成功;
      b.fail 回调:根据错误码排查;
      2.公会长无法进行解绑时,游戏也能通过 OpenAPI 进行解绑操作;
    加入群聊(公会成员)
      1.公会成员点击触发 tt.joinUnionGroup 接口:
      a.success 回调:接口调用成功,但是否进群由玩家自行选择,游戏无法感知加群结果;
      b.fail 回调:接口调用失败,根据错误码排查;
    (成功加入后,也需要保留“加入群”按钮,公会成员一点就进入群聊互动)