Skip to content

APP迁移SOP

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

整体迁移工作概览

1. APP从OpenPaaS平台获取账号

  • 账号注册:需准备手机号,邮箱等
  • 进行相关认证:需准备公司营业职照,法人信息,银行账户等
  • 获取接入服务所需的公私钥对

2. OpenPaaS SDK接入

2.1 前端接入

OpenPaaS为APP提供了不同系统版本的SDK,APP可根据自身系统选择SDK接入。

SDK已经封装了绝大部分的能力,但仍有极少量的各APP特性化能力,需要APP通过以JS API的方法注入到SDK来实现,

2.2 后端接入

3. 存量游戏的兼容

存量游戏APP可选择通过本地游戏包文件、本地游戏文件目录加载或者URL的方式进行加载运行。

3.1 支持通过本地文件的方式加载游戏

APP通过调用 startGameByFilePath执行本地游戏包文件的加载运行,此处传入的游戏包文件为无签名和加密信息的裸包,同时需要传入该文件的其他相关信息,SDK会将上报相关参数作为计费依据标准,为避免同一游戏同用户多次计费,APP方需提前将存量游戏的全量数据同步SUD。

3.2 支持通过本地路径的方式加载游戏

APP通过调用 startGameByDirectoryPath执行本地游戏包目录的加载运行,此处传入的文件目录为已经将包验签解密安装后的文件目录,同时需传入相关参数。SDK将上报相关参数作为计费依据标准,为避免同一游戏同用户多次计费,APP方需提前将存量游戏的全量数据同步SUD。

3.3 支持通过URL的方式加载游戏

APP通过调用 startGameByURL执行本地路径游戏的加载运行,需传入相关参数。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处理后形成新标识和与旧标识映射关系后返回给游戏方。
  • 用户账号数据