抖音开放平台Logo
开发者文档
控制台
  • 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 前可以豁免。建议开发者需要的情况可以设置一个客服按钮,点击后出现弹框,文字引导下 :如果您对充值有问题,可以点击「右上角三个点」-「反馈与帮助」-「意见建议」选择「充值问题」进行反馈,我们会第一时间对您的问题进行跟踪处理。
    该文档是否有帮助?