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处理后形成新标识和与旧标识映射关系后返回给游戏方。
- 用户账号数据