抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

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扫码

代码示例