抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 网络状态
  • 系统信息
  • Wi-Fi
  • 加速度计
  • 罗盘
  • 拨打电话
  • 扫码
  • 剪贴板
  • tt.getClipboardData
  • tt.setClipboardData
  • 屏幕
  • 陀螺仪
  • 加密
  • 短信
  • 日历
  • 振动
  • 性能
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • 生活服务
  • tt.setClipboardData
    收藏
    我的收藏

    基础库 1.0.0 开始支持本方法,这是一个异步方法。

    设置系统剪贴板内容。基础库 2.53.0 开始,调用成功后,会弹出 toast 提示【已设置剪切板内容】,持续 1.5s。可以和 tt.getClipboardData 配套使用。

    前提条件
    业务背景
    使用限制
    注意事项

    在 success 回调中调用 tt.showToast 打开的 toast 可以覆盖接口默认打开的 toast。

    支持沙盒
    相关教程

    语法

    tt.setClipboardData(options)

    参数说明

    options 为 object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    datastring
    剪贴板的内容
    1.0.0
    successfunction
    接口调用成功的回调函数
    1.0.0
    failfunction
    接口调用失败的回调函数
    1.0.0
    completefunction
    接口调用结束的回调函数(调用成功、失败都会执行)
    1.0.0

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "setClipboardData:ok"
    1.0.0

    回调失败

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "setClipboardData:fail" + 详细错误信息
    1.0.0

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    104179api scope is not declared in the privacy agreementD
    没有在隐私协议声明里声明使用剪贴板信息

    请检查隐私协议配置是否正确

    1.0.0
    104180privacy permission is not authorizedU
    隐私协议授权拒绝

    用户未授予小程序授权,请引导用户按需授权,详情参考 用户授权

    1.0.0
    104190auth denyU
    用户拒绝授权

    用户未授予小程序授权,请引导用户按需授权,详情参考 用户授权

    1.0.0
    104191invokeFailed, intercept by ApiControlF
    小程序框架内部错误,有需要请创建工单咨询
    1.0.0
    104194app in backgroundU
    小程序在后台
    1.0.0
    104199data cannot be nullD
    参数错误

    请根据错误信息修改参数类型

    1.0.0
    104199params.data should be string, but got %sD
    参数错误

    请根据错误信息修改参数类型

    1.0.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例