推荐流直出游戏能力接入FAQ
收藏为方便阅读，在本文中，推荐流直出游戏能力将被统一简称为直玩能力/直玩游戏。
直玩游戏场景：
Q1：测试账号完成订阅后，为啥在推荐流仍刷不到游戏卡？
刷不到直玩游戏卡的问题，一般有以下两种情况：
- 1.未看到「游戏正在预启动」弹窗
使用不出卡问题排查工具查看原因
如下图所示，在抖音开放平台的推荐流直出游戏能力页中内置了不出卡问题排查工具，开发者只需进入对应页面，跳转 到调试设备页面使用对应工具进行排查即可。
抖音推荐流直出游戏能力页示意图 | 不出卡问题排查工具示意图 |
- 2.看到了「游戏正在预启动」和「首帧渲染完成」弹窗，等不到「场景加载完成」弹窗
没有看到「场景加载完成」弹窗，大概率是因为场景加载过程中存在依赖用户强交互的弹窗/公告/登录界面，导致没法正常加载到对应场景，从而没能上报reportScene。可以按以下步骤确认当前场景的加载情况和reportScene的上报情况：
- a.首先通过抖音扫码进入游戏的测试版本，在右上角「···」中打开更多面板，在更多面板中选择「打开调试」，开启vconsole能力；
- b.冷启抖音并开始往下刷推荐流，直到依次出现「开始预启动游戏」和「游戏首帧渲染完成」的弹窗提示后，通过抖音扫码进入游戏的后台测试版本，可以查看游戏当前的加载进度以及vconsole（可以在reportScene的调用处打印日志）等信息。
Q2：平台拉取游戏数据的时机是怎样的？如何确认平台是否成功推送了游戏？
平台拉取游戏数据的时机为：用户在刷推荐流视频的过程中，需要拉取下一刷推荐流数据（一般为10+个），并且平台侧满足分发条件时，会去请求游戏提供的server接口尝试拉取游戏数据。
关于平台是否推送了游戏：
- •如果游戏提供的server接口有平台侧的请求记录，只是说明平台侧满足了分发条件，可以往用户设备推送一个游戏数据，但是仍可能会受到频控等逻辑影响，导致设备上没有接收到游戏数据；
- •手机设备上看到了「游戏正在预启动」的弹窗，才说明直玩游戏数据被真正地推送到客户端，并且在场景加载完成后会被展示。
Q3：直玩游戏场景跟直玩订阅能力有前后依赖关系吗？没有完成直玩订阅的用户可以刷到直玩游戏卡片吗？
直玩场景和直玩订阅能力没有严格的前后依赖关系。
直玩卡片的分发有两种途径：
- •用户订阅制：开发者需要接入订阅能力，选择合适时机给未订阅用户展示订阅界面，只有订阅了的用户才支持分发订阅场景下的直玩游戏（面向订阅游戏人群分发)
- •平台推荐制：平台会根据一定的策略 选取合适的游戏用户来分发直玩游戏（面向非订阅游戏人群推进分发)
订阅机制只是让游戏卡片有更高的概率触达目标用户，未订阅的用户也可能会通过推荐机制被分发到游戏卡片。
直玩订阅能力：
订阅API错误可以先根据API文档中的错误码进行自查C# API：查询订阅&订阅 API
Q1：接口不存在或者 canIuse 为 false？
基础库3.34.0版本及以上开始支持订阅接口，遇到该问题请通过应用市场更新到最新的抖音客户端版本。
Q2：在哪里可以看到用户直玩的订阅状态？
在小游戏的设置页面有【游戏进度提醒】按钮，表示直玩的订阅状态，用户可以通过该途径主动进行订阅/取消订阅行为。
Q3：API 报错：21105 frequency control
当日拒绝过订阅弹窗后再调用订阅API会返回该错误，可以通过更改系统时间绕开此限制。
Q4：API 报错：21103 service error
确保传入的是在抖音开放平台生成的scene和contentIDs，这两个参数是有对应关系的，不能混着传。
