推荐流直出游戏能力接入FAQ
收藏为方便阅读，在本文中，推荐流直出游戏能力将被统一简称为直玩能力/直玩游戏。
直玩游戏场景：
Q1：测试账号完成订阅后，为啥在推荐流仍刷不到游戏卡？
刷不到直玩游戏卡的问题，一般有以下两种情况：
- 1.游戏卡触发失败
进入测试模式后，后台会自动检测当前是否可以触发游戏卡。若触发失败，弹窗会展示失败原因，开发者可以根据下方解决建议进行问题排查。
问题 | 解决建议 |
不存在相关就绪数据 | 出现在直玩复访版测试中，需确保让被测试的方案场景保持就绪状态，让后台可在OpenAPI中拉取到对应的场景。
|
接口返回值非零，错误码：xxx | 检查OpenAPI返回接口是否存在问题 |
http状态异常，请检查接口 | 检查http接口是否存在问题 |
相关环境服务器配置缺失 | 配置服务器 |
小游戏未实名，请前往小游戏实名 | 前往小游戏实名 |
签名校验失败 | 检查签名计算过程是否存在问题 |
数据解析失败，请检查数据格式是否规范 | 检查数据格式是否规范 |
获取就绪数据接口返回失败，请检查接口能力 | 检查OpenAPI返回接口是否存在问题 |
- 2.未留下充 分时间给游戏进行加载
直玩采用的是预加载技术，游戏卡在成功下发前，需在后台完成「游戏预启动」、「首帧渲染」和「场景加载」，每一步骤完成时都会通过弹窗进行提示。建议在看到「游戏首帧渲染完成」提示之前，都在首个视频中等待，以便给游戏充分时间加载。
若长时间等不到「游戏首帧渲染完成」，请反馈或 oncall。
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，这两个参数是有对应关系的，不能混着传。
