抖音开放平台Logo
开发者文档
控制台
  • 体验抖音小游戏
  • 游戏引擎
  • Unity 引擎适配
  • WebGL 方案与优化
  • BGDT 手册
  • 接入
  • C# API
  • API 概览
  • 开放能力
  • 账号
  • 侧边栏
  • 收藏
  • 群聊
  • 平台开放能力
  • 游戏互推组件
  • 好友排行榜
  • 数据分析
  • 客服能力
  • 直玩能力
  • 基础
  • 设备
  • 文件
  • 媒体
  • 网络
  • 游戏分享
  • 数据缓存
  • 系统
  • 界面
  • 支付
  • 广告
  • 宿主事件
  • 抖音云模块
  • 邀请模块
  • PlayerPrefs
  • 调试工具
  • 初始化
  • 渲染
  • Cocos/Laya/Egret引擎适配
  • 基础功能
  • 开放能力
  • 性能优化
  • 该模块为直玩能力相关。向用户请求授权允许游戏在满足一定的条件后出现在Feed流中和查询用户的授权情况
    前提条件
    已申请开通小游戏直玩能力,在申请开通后可以获得 contentID
    业务背景
      1.游戏供给更加偏向中重度,因此以游戏内的「关键节点」为高价值信息牵引用户复访成为效率更高的一种手段
      2.因此,业务侧期望,发挥小游戏的即点即玩特性,且整体无限贴合抖音:刷、推信息本身的体验,尝试为用户提供一种新型的小游戏游玩体验

    TT.RequestFeedSubscribe

    语法

    public static void RequestFeedSubscribe(JsonData param, Action<JsonData> success = null, Action<int, string> failed = null, Action complete = null)

    参数说明

    param 为 JsonData 类型,属性如下:
    属性名
    类型
    默认值
    必填
    说明
    type
    string
    --
    订阅Feed流的类型
    scene
    int
    --
    订阅的场景ID(type='play'时必传)
    contentIDs
    Array<string>
    --
    自定义文案ID(type='play'时必传)
    type 的合法值
    说明
    'play'
    直玩场景
    scene 的合法值
    说明
    1
    离线收益场景
    2
    体力恢复场景
    3
    重要事件掉落

    回调成功

    JsonData 类型,属性如下:
    属性名
    类型
    说明
    errMsg
    string
    回调信息
    success
    bool
    用户的订阅结果(true为成功,false为订阅失败,具体原因看errMsg)

    回调失败

    属性如下:
    属性名
    类型
    说明
    errNo
    int
    错误码
    errMsg
    string
    错误信息

    错误码

    errNo
    errMsg
    说明
    10301
    feature is not supported in app
    宿主不支持该功能
    21100
    host does not have permission
    该app未开通该能力
    21101
    no permission
    该游戏没有订阅权限
    10601
    not login
    需要调用tt.login登录
    20001
      type is invalid
      params contentIDs or scene is required (type='play'时才有)
    开发者传参错误
    21102
    network error
    网络环境问题,一般指无网环境
    21103
    service error:具体错误信息
    网络请求失败
    21104
    internal error:具体错误信息
    弹窗跳转失败等
    21105
    frequency control
    频控限制

    代码示例

    public void FeedTest(){ var contentIDs = JsonData.NewJsonArray(); contentIDs.Add("CONTENT123"); contentIDs.Add("CONTENT234"); var param = new JsonData { ["type"]: "play", // play=直玩(该场景必传scene和contentIDs) ["scene"]: 1, // 一次只能订阅一个 ["contentIDs"]: contentIDs, }; TT.RequestFeedSubscribe( param, (res) => { }, (errNo, errMsg) => { }, () => { } ); }

    TT.CheckFeedSubscribeStatus

    语法

    public static void CheckFeedSubscribeStatus(JsonData param, Action<JsonData> success = null, Action<int, string> failed = null, Action complete = null)

    参数说明

    param 为 JsonData 类型,属性如下:
    属性名
    类型
    默认值
    必填
    说明
    type
    string
    --
    订阅 Feed 流的类型
    scene
    int
    --
    订阅的模版ID(type="play"时必传)
    type 的合法值
    说明
    "play"
    直玩场景
    scene 的合法值
    说明
    1
    离线收益场景
    2
    体力恢复场景
    3
    重要事件掉落

    回调成功

    JsonData 类型,属性如下:
    属性名
    类型
    说明
    errMsg
    string
    回调信息
    success
    bool
    用户的订阅状态(true为已经订阅,false为用户未订阅)

    回调失败

    属性如下:
    属性名
    类型
    说明
    errNo
    number
    错误码
    errMsg
    string
    错误信息

    错误码

    errNo
    errMsg
    说明
    10301
    feature is not supported in app
    宿主不支持该功能
    21100
    host does not have permission
    该app未开通该能力
    21101
    no permission
    该游戏没有订阅权限
    10601
    not login
    需要调用tt.login登录
    20001
      invalid params, type is invalid
      params scene is required (type='play'时才有) (type='play'时才有)
    开发者传参错误,客户端主要校验 msgID 为空的情况
    21102
    network error
    网络环境问题,一般指无网环境
    21103
    service error:具体错误信息
    网络请求失败

    代码示例

    public void FeedTest(){ var param = new JsonData { ["type"]: "play", ["scene"]: 1, }; TT.CheckFeedSubscribeStatus( param, (res) => { }, (errNo, errMsg) => { }, () => { } ); }