SDK 隐私和同意

目标读者：实现 SDK UI 玩家同意流程的开发者。

截图上传、最近日志和联系方式都是 opt-in。截图和最近日志 checkbox 默认不勾选。

最小示例

{
  "screenshot_upload": false,
  "recent_logs_upload": false,
  "contact_upload": false,
  "recent_logs_dropped": false,
  "contact_dropped": false
}

同意状态只允许使用 screenshot_upload、recent_logs_upload 和 contact_upload。已删除的 Alpha 字段 include_screenshot、include_recent_logs、include_contact 会导致整条 payload 无效。

项目 feature gate 与逐次提交同意

项目设置中的 screenshot、recent_logs 和 contact 只开放对应能力，不会授予 consent，也不会把对应 consent 字段设为 true。breadcrumbs 和 offline_queue 是项目能力，不是额外的玩家同意字段。

每次新打开反馈面板时，截图上传、最近日志上传和隐私确认都保持未勾选。只有项目开放 contact 且玩家为本次提交明确填写联系方式时，才会包含 contact；上一次面板选择不会复用。每条被接受的 report 都保存属于该 report 的 consent 快照，因此项目设置与 consent 证据始终分离。

服务端行为

服务端先应用项目 feature gate，再处理玩家对本次提交的 consent。如果玩家没有确认隐私提示，API 会拒绝反馈。如果客户端在未获得同意时发送联系方式或内嵌 recent_logs，服务端会保存反馈、丢弃这些字段，并在 consent 快照中记录 contact_dropped 或 recent_logs_dropped。项目 feature 被禁用或对应已保存 consent 标记为 false 时，截图或最近日志附件上传都会被拒绝。

常见错误

• checkbox 未勾选时不要上传截图。
• 不要从游戏账号静默推断联系方式。
• 不要发送已删除的 include_* 同意字段；API 会拒绝整条 payload。
• 不要记录玩家联系方式、project key、JWT 或 signed URL。
• 不要把已启用的项目 feature 当作 consent 证据。

下一步

阅读完整 隐私 指南。