抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • API 概览
  • C# API
  • 开放接口
  • 登录
  • 侧边栏能力
  • 设置
  • 授权
  • 添加到桌面
  • 游戏排行榜
  • 订阅消息
  • 开放数据域
  • 开放数据
  • 开放数据分组
  • 客服消息
  • tt.openCustomerServiceConversation
  • tt.createContactButton
  • ContactButton
  • 直播能力
  • 推荐流直出游戏能力
  • 公会群能力
  • 意见反馈
  • 游戏站
  • 收藏
  • 群聊
  • 广告
  • 关注
  • 数据分析
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 网络
  • 转发
  • 数据缓存
  • 广告
  • 界面
  • 支付
  • Worker
  • tt.createContactButton
    收藏
    我的收藏

    基础库 1.55.0 开始支持本方法,低版本需做兼容处理
    创建客服按钮。
    详细说明请参考 小游戏客服介绍

    返回

    返回一个 ContactButton 对象

    参数

    Object 类型,属性如下:
    属性
    类型
    默认值
    必填
    描述
    type
    "image" | "text"
    按钮的类型,取值 image 或 text。image 对应图片按钮,text 对应文本按钮
    image
    string
    按钮的背景图片,type 为 image 时必填。仅支持本地图片,目录包括代码包目录、临时文件目录和本地用户目录
    text
    string
    更多游戏
    按钮上的文本内容, type 为 text 时有效
    style
    object
    按钮的样式

    style 参数说明

    属性
    类型
    默认值
    必填
    说明
    left
    number
    左上角横坐标
    top
    number
    左上角纵坐标
    width
    number
    宽度
    height
    number
    高度
    backgroundColor
    string
    背景颜色
    borderColor
    string
    边框颜色
    borderWidth
    number
    边框宽度
    borderRadius
    number
    边框圆角
    textAlign
    "left" | "center" | "right"
    文本的水平居中方式
    fontSize
    number
    字号
    lineHeight
    number
    文本的行高
    textColor
    string
    文本颜色

    style.textAlign 属性合法值

    说明
    left
    居左
    center
    居中
    right
    居右

    返回

    返回一个 ContactButton 对象

    示例

    const button = tt.createContactButton({ type: "image", // image | text image: "./test.jpg", style: { left: 20, top: 40, width: 150, height: 150, lineHeight: 40, backgroundColor: "#ffffff", textAlign: "center", fontSize: 16, borderRadius: 4, borderColor: "#ffffff", borderWidth: 1, textColor: "#ffffff", }, success(res) { console.log("create success", res); }, fail(res) { console.log("create fail", res); }, complete(res) { console.log("create complete", res); }, }); // 点击事件 function handleClick() { console.log("点击客服按钮"); } button.onTap(handleClick); // 监听点击事件 button.offTap(handleClick); // 取消监听点击事件 button.show(); // 显示按钮 button.hide(); // 隐藏按钮 // 错误处理 function handleError(res) { console.log(res.errMsg); } button.onError(handleError); // 监听错误 button.offError(handleError); //取消监听错误 button.destroy(); // 销毁按钮

    Bug&Tip

      Bug: 番茄小说和番茄畅听暂不支持客服能力,预计 2022 年 3.31 号可使用。
      Tip: 番茄小说和番茄畅听端内购游戏强制接入客服消息的限制 3.31 前可以豁免。建议开发者需要的情况可以设置一个客服按钮,点击后出现弹框,文字引导下 :如果您对充值有问题,可以点击「右上角三个点」-「反馈与帮助」-「意见建议」选择「充值问题」进行反馈,我们会第一时间对您的问题进行跟踪处理。