# 游戏 SDK 接入准备清单

版本：2026-09-08
来源：GameStart Studio（https://www.gamestartstudio.cn）

> 用途：在广告、支付、登录、统计或其他第三方 SDK 接入前，核对工程、平台账号、隐私流程、环境参数和验收条件。本清单不替代平台官方文档、隐私合规审查或专业法律意见。

## 1. 项目与接入目标

- 项目名称：
- 引擎名称与精确版本：
- 当前项目版本或分支：
- 目标平台：Android / iOS / WebGL / 微信小游戏 / 其他
- 计划接入的 SDK：
- 接入目的：广告 / 支付 / 登录 / 统计 / 推送 / 其他
- 计划测试日期：
- 计划上线日期：
- 项目技术负责人：

## 2. 平台账号与应用配置

| 项目                 | 当前状态               | 负责人 | 待完成事项 |
| -------------------- | ---------------------- | ------ | ---------- |
| 平台开发者账号       | 未申请 / 审核中 / 可用 |        |            |
| 应用 ID 或包名       | 未确定 / 已确定        |        |            |
| 签名、证书或描述文件 | 未准备 / 已准备        |        |            |
| SDK 服务商后台应用   | 未创建 / 已创建        |        |            |
| 测试账号与测试设备   | 未准备 / 已准备        |        |            |
| 商户、广告或结算资质 | 未申请 / 审核中 / 可用 |        |            |

## 3. SDK 与工程依赖

| 名称 | SDK 版本 | 官方文档地址 | 依赖项 | 当前冲突或风险 |
| ---- | -------- | ------------ | ------ | -------------- |
|      |          |              |        |                |

检查项：

- [ ] SDK 来自官方或经确认的可信来源
- [ ] SDK 版本支持当前引擎、插件接口和目标平台版本
- [ ] Android Gradle、CocoaPods、UPM 或其他依赖方式已确认
- [ ] 已记录与现有 SDK、插件和原生库的潜在冲突
- [ ] 测试环境与生产环境参数可以明确区分
- [ ] 服务端密钥不会写入客户端工程或公开仓库

## 4. 隐私、权限与用户同意

- 计划上线地区：
- 隐私政策地址：
- 用户协议地址：
- 首次启动是否需要隐私同意：是 / 否 / 待确认
- 用户拒绝后是否仍可进入基础功能：
- SDK 初始化时机：同意前 / 同意后 / 按功能触发
- 申请的系统权限：
- 收集或传输的数据类型：
- 数据接收方与处理目的：
- 删除账号或撤回同意流程：

检查项：

- [ ] SDK 数据行为已与隐私政策逐项核对
- [ ] 非必要权限不会在启动时提前申请
- [ ] 用户拒绝、取消和失败路径具有可用反馈
- [ ] 统计或广告标识符使用符合目标平台要求
- [ ] 隐私弹窗、设置入口和撤回方式已纳入验收

## 5. 接入流程与回调

| 编号  | 业务流程 | 前置条件 | 成功结果 | 取消或失败结果 | 是否需要服务端校验 |
| ----- | -------- | -------- | -------- | -------------- | ------------------ |
| S-001 |          |          |          |                |                    |

重点场景：

- [ ] 首次初始化和重复初始化
- [ ] 登录成功、取消、失败和账号切换
- [ ] 广告加载、展示、关闭、奖励和无填充
- [ ] 支付成功、取消、失败、重复回调和补单
- [ ] 弱网、断网、切后台和进程重启
- [ ] 测试环境切换到生产环境

## 6. 日志与异常处理

- 日志开关与查看方式：
- 客户端错误码记录位置：
- 服务端回调或校验日志位置：
- 是否需要崩溃和异常监控：
- 敏感字段脱敏规则：
- 用户可见错误提示：
- 无法恢复时的降级方案：

## 7. 真机与后台验收

| 平台或设备 | 系统版本 | 测试环境    | 核心流程 | 后台记录 | 结果                 |
| ---------- | -------- | ----------- | -------- | -------- | -------------------- |
|            |          | 测试 / 生产 |          |          | 通过 / 不通过 / 阻塞 |

验收证据：

- [ ] 真机完整流程录屏或截图
- [ ] 客户端关键日志
- [ ] 服务商后台对应记录
- [ ] 服务端签名或金额校验结果
- [ ] 隐私同意与权限申请路径
- [ ] 测试参数和生产参数切换记录

## 8. 接入结论

- 当前是否具备接入条件：是 / 否 / 部分具备
- 阻塞事项：
- 需要客户或平台完成的前置条件：
- 建议实施顺序：
- 主要技术风险：
- 主要合规待确认项：
- 预计验收范围：
- 本次明确不包含：

## 9. 变更记录

| 日期 | SDK 或配置变化 | 影响范围 | 处理结果 | 确认人 |
| ---- | -------------- | -------- | -------- | ------ |
|      |                |          |          |        |