抖音开放平台Logo
开发者文档
控制台

tt.checkFeedSubscribeStatus
收藏
我的收藏

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

查询用户直玩订阅的授权情况

前提条件
已申请开通小游戏直玩能力,在申请开通后可以获得 contentID
业务背景
  1. 游戏供给更加偏向中重度,因此以游戏内的「关键节点」为高价值信息牵引用户复访成为效率更高的一种手段;
  2. 业务侧期望,发挥小游戏的即点即玩特性,且整体无限贴合抖音:刷、推信息本身的体验,尝试为用户提供一种新型的小游戏游玩体验;
使用限制
  1. 必须在调用 tt.login 后才能调用本接口。
  2. 本接口存在频控限制,需要注意调用场景和频率。
注意事项
相关教程

语法

tt.checkFeedSubscribeStatus(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
scenenumber

订阅的场景 ID(type="play"时必传)

3.34.0
typeenum

订阅 Feed 流的类型,目前只支持传 'play'

3.34.0
successfunction
接口调用成功的回调函数
3.34.0
failfunction
接口调用失败的回调函数
3.34.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
3.34.0

scene 参数说明

说明

1

离线收益场景

2

体力恢复场景

3

重要事件掉落

type 的合法值

说明最低支持版本
play

直玩场景

3.34.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"checkFeedSubscribeStatus:ok"
3.34.0
statusboolean

用户的订阅状态(true为已经订阅,false为用户未订阅)

3.34.0

回调失败

object 类型,属性如下:

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

错误码

errNoerrMsg说明最低支持版本
10301feature is not supported in app
宿主不支持该功能
3.34.0
21100host does not have permission
该 app 未开通该能力
3.34.0
21101no permission
该游戏没有订阅权限
3.34.0
10601not login
需要调用 tt.login 登录
3.34.0
20001params scene is required
参数错误
3.34.0
21102network error
网络环境问题,一般指无网环境
3.34.0
21103service error:具体错误信息
网络请求失败
3.34.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.checkFeedSubscribeStatus({ type: "play", scene: 1, success(res) { console.log(res.status) }, fail(res) { console.log(res.errMsg) }, })