tt.storeFeedData
收藏我的收藏
基础库 3.67.0 开始支持本方法,这是一个异步方法。
存储游戏是否直玩就绪状态。
| 前提条件 | 在使用前需前往开发者后台,在运 营能力 - 推荐流直出能力中申请开通,并获取对应场景值 scene,素材 contentID |
| 业务背景 | 无 |
| 使用限制 | 无 |
| 注意事项 | 当前接口面向无server小游戏,如果在开通直玩能力过程中配置了 OpenAPI,则无需调用此接口存储直玩状态 |
| 相关教程 | 无 |
语法
tt.storeFeedData(options)
参数说明
options 为 object 类型,属性如下:
| 属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
|---|---|---|---|---|---|
| extra | string | 否 | 自定义补充字段 | 3.67.0 | |
| scene | number | 是 | 订阅的场景 ID | 3.67.0 | |
| status | enum | 是 | 满足运算公式后,对应直玩场景是否就绪。0:未就绪, 1:就绪 | 3.67.0 | |
| contentID | string | 是 | 自定义文案的 contentID,contentID 在后台申请开通直玩能力后可获取 | 3.67.0 | |
| leftValue | enum | 是 | 运算公式的左值,当前只支持"timeStampMs",即毫秒级时间戳 | 3.67.0 | |
| operator | enum | 是 | 运算符 | 3.67.0 | |
| rightValue | string | 是 | 运算公式的右值 | 3.67.0 | |
| success | function | 否 | 接口调用成功的回调函数 | 3.67.0 | |
| fail | function | 否 | 接口调用失败的回调函数 | 3.67.0 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | 3.67.0 |
status 的合法值
| 值 | 说明 | 最低支持版本 |
|---|---|---|
| 0 | 满足运算公式条件后,直玩状态为未就绪 | 3.67.0 |
| 1 | 满足运算公式条件后,直玩状态为已就绪 | 3.67.0 |
leftValue 的合法值
| 值 | 说明 | 最低支持版本 |
|---|---|---|
| timeStampMs | 毫秒级时间戳 | 3.67.0 |
operator 的合法值
| 值 | 说明 | 最低支持版本 |
|---|---|---|
| = | 等于 | 3.67.0 |
| > | 大于 | 3.67.0 |
| >= | 大于等于 | 3.67.0 |
| < | 小于 | 3.67.0 |
| <= | 小于等于 | 3.67.0 |
| != | 不等于 | 3.67.0 |
回调成功
object 类型,属性如下:
| 属性名 | 类型 | 说明 | 最低支持版本 |
|---|---|---|---|
| errMsg | string | "storeFeedData:ok" | 3.67.0 |
回调失败
object 类型,属性如下:
| 属性名 | 类型 | 说明 | 最低支持版本 |
|---|---|---|---|
| errMsg | string | "storeFeedData:fail" + 详细错误信息 | 3.67.0 |
错误码
| errNo | errMsg | 说明 | 最低支持版本 |
|---|---|---|---|
| 20001 | invalid param | 参数错误 | 3.67.0 |
| 20000 | no permission | 无调用权限,请联系客服添加 | 3.67.0 |
| 10104 | invoke too frequently | 频控限制 | 3.67.0 |
| 10401 | internal error | 小游戏框架内部错误,有需要请创建工单咨询 | 3.67.0 |
代码示例
当前时间戳大于等于1744340968580时,满足直玩就绪条件
tt.storeFeedData({ scene: 1, // 离线收益场景 contentID: 'contentID123', // contentID leftValue: 'timeStampMs', operator: '>=', rightValue: '1744340968580', success(res) { console.log('storeFeedData success', res) }, fail(res) { console.log('storeFeedData fail', res) }, })
