APP迁移SOP
Runtime授权服务升级至 OpenPaaS 服务后,原 Runtime 授权服务将停止授权。新的 OpenPaaS 服务中将采用新的游戏包格式,涉及到游戏用户账号体系获取方式修改,支付流程,广告流程等修改以及新的结算方式。本文旨在帮助合作方快速从原有服务迁移至新的服务,保证业务安全有序运转。
整体迁移工作概览
- 在 OpenPaaS 后台中注册账号,并进行企业认证
- 前后端接入 OpenPaaS 的 SDK
- 通过 OpenPaaS 提供的 JS API 中扩展 API 的能力,实现 APP 特有能力
- 对当前存量游戏的处理
- 游戏包兼容处理
- 游戏包升级处理
- 数据同步处理
- APP 原开放平台中游戏开发者与 OpenPaaS 游戏开发者数据同步
- OpenPaaS 平台中游戏数据与 APP 原开放平台中的游戏数据同步
1. OpenPaaS 账号准备
- 账号注册
- 进行相关认证:需准备公司营业职照,法人信息,银行账户等
- 获取接入服务所需的公私钥对
2. OpenPaaS SDK 接入
2.1 前端接入
OpenPaaS 为 APP 提供了不同系统版本的SDK,APP 可根据自身系统选择 SDK 接入。
SDK已经封装了绝大部分的能力,但仍有极少量的各 APP 特性化能力,需要 APP 通过以 JS API 的方法注入到 SDK 来实现,
2.2 后端接入
3. 存量游戏的兼容
存量游戏APP可选择通过本地游戏文件目录加载的方式进行加载运行。
3.1 支持通过本地路径的方式加载游戏
APP通过调用 startGameByDirectoryPath执行本地游戏包目录的加载运行,此处传入的文件目录为已经将包验签解密安装后的文件目录,同时需传入相关参数。SDK将上报相关参数作为计费依据标准,为避免同一游戏同用户多次计费,APP 方需提前将存量游戏的全量数据同步 SUD。
4. 存量游戏向新版本的升级和迁移
存量游戏更新需要开发者按 OpenPaaS 支持的新包格式进行打包,新包的加载方式、用户登录等有与原逻辑不同。
4.1 新版本游戏包格式
新的游戏包后缀为.sp格式,需要调用startGameBySignature执行游戏加载运行。
4.2 游戏更新后包体迁移
4.2.1 从 SUD OpenPaaS 平台上架游戏包
- CP 方将游戏打包为新的版本后,在OpenPaaS平台中上架小游戏新的版本
- APP 方在 OpenPaaS 平台中选取小游戏进行上架
- 拉取小游戏的
GameSignature - 通过
GameSignture加载小游戏
4.2.2 继续从 APP 上架游戏包(不推荐)
- 上架流程维持 APP 原流程
- 游戏包加载通过本地路径或URL方式加载
- 因游戏包的文件 hash 值发生改变,用户在两个版本都登录的情况下会导致重复计费
4.3 游戏的新版本中用户数据映射
4.3.1 老用户数据映射
- 新游戏包在用户登录游戏时,由于 OpenPaaS 提供了全新的登录方案,由此产生的用户身份标识与 APP 颁发的用户身份标识不一致,因此APP需要在用户登录时将用户的原身份标识返回给 OpenPaaS,由 OpenPaaS 处理后形成新标识和与旧标识映射关系后返回给游戏方。
- 用户账号数据
