Skip to content

APP迁移SOP ​

Runtime授权服务升级至 OpenPaaS 服务后,原 Runtime 授权服务将停止授权。新的 OpenPaaS 服务中将采用新的游戏包格式,涉及到游戏用户账号体系获取方式修改,支付流程,广告流程等修改以及新的结算方式。本文旨在帮助合作方快速从原有服务迁移至新的服务,保证业务安全有序运转。

整体迁移工作概览 ​

  1. 在 OpenPaaS 后台中注册账号,并进行企业认证
  2. 前后端接入 OpenPaaS 的 SDK
  3. 通过 OpenPaaS 提供的 JS API 中扩展 API 的能力,实现 APP 特有能力
  4. 对当前存量游戏的处理
    • 游戏包兼容处理
    • 游戏包升级处理
  5. 数据同步处理
    • 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 处理后形成新标识和与旧标识映射关系后返回给游戏方。
  • 用户账号数据