# Ultra SDK快速接入手册

# 概述:接入SDK的步骤

从开始接入Ultra SDK到上线一般分为6个步骤,本手册将带您快速预览接入至游戏上线的基本流程。

1.创建游戏:

登录中台,创建游戏,获得必要的参数。

核心参数:product ID、ProductKey、CallbackKey

2.接入SDK:

游戏接入SDK,目前SDK分为UE4、unity、安卓、IOS共4个版本,CP可按需接入。

例如您使用的unity引擎开发游戏,可只接入unity版本且不需要再单独接入的安卓、ios版本。

同时您还需要接入服务端的接口。

3.母包测试:

游戏完成sdk和服务端接入后,需要进行母包的登录、支付测试。

4.打包参数配置:

母包测试通过后,请先完成支付商品、支付回调等相关配置 同时添加您需要发行的渠道,并在完成对应参数的配置。

5.渠道线上配置:

完成渠道线上登录、支付等相关功能配置。

6.进行打包

下载打包工具进行渠道打包即可。

# 1.游戏项目创建:

1.联系UltraSDK运营开通账号 使用运营提供的账号登录Ultra SDK后台,运营提供账号为当前公司下的管理员账户,可以自行添加子账号。

中台登录地址 (opens new window)

2.完成登录后首次进行游戏创建

3c60b9034f0f5097824745c37b4e1e60.png

3.添加游戏时请输入游戏名称,及发行地区,后续如有变动可进行修改。

fd59cd5bfee788f1a551d0cf5a7d7dcf.png

创建完成后即可看到如下信息:

其中product ID、ProductKey、CallbackKey三个参数请给到开发方在接入时候使用。

3c0ad543ce56768d0bcdd56364617060.png

# 2.SDK接入及测试:

开始接入之前,您可以通过如下链接中,选择适合您的方式进行接入。其中服务端文档属于必须要接入的内容。

SDK接入指南及资源下载链接见下:

UE4 (opens new window)

Unity (opens new window)

Android (opens new window)

iOS (opens new window)

服务端接入文档如下:

服务端接入 (opens new window)

# 3.母包测试

接入完成后可本地出母包进行首次的登录及测试,您可以参考下图中的步骤逐步完成测试。

48c231bf8d6bc957d9a7224676b5960f.png

母包测试前需要完成支付回调、测试商品、测试账号的配置。

母包测试时,安卓端需要通过中台创建含有支付额度的母包账号, 并使用此账号登录进行,IOS端无法进行直接游戏的母包测试,需要通过打印日志进行测试,请参考下方链接中的测试说明。

IOS测试指南 (opens new window)

# 4.后台打包参数配置:

1)按照您需要接入的渠道进行配置添加。点击后添加所需渠道即可。

2)添加后即可在此处编辑对应渠道的参数信息。

217a648acaa8bcaa73beb8dccd7814b9.png

3)以海外安卓为例,在这里编辑游戏包名

需要注意游戏包名需要和渠道的后台一致(如google play市场、华为市场等),否则会无法登录。

渠道参数和客户端参数默认会带出部分信息,正常情况下不需要修改。

同时下方会展示初始化时需要的参数,如需要登录该渠道,请勾选并配置参数

d177c1084b4b4cf7c15017444f6ea634.png

4)此处进行ICON及闪屏设置。

fc98ac4c9c2421f4ad01edd417351f09.png

5)配置结束后,打包参数及状态显示为“已配置”则说明可以进行打包;如状态提示为未开通,请联系对接商务沟通即可。

f4102fa29ae07e0091db1b1ee76faf02.png

# 5.渠道线上配置

1)此处可进行登录、支付、商品的配置,此处配置为线上即时生效,请注意在游戏上线后不要随意修改。

05e9e197a722405e926d8ab2dc9f46f3.png

2)登录管理默认打开需要的渠道即可,其中FaceBook配置建议同时打开BusinessId。

需注意,如果在“打包参数配置中”未进行对应渠道的参数配置,即使打开该渠道也无法进行登录。

9801f1190c4989ccd7c5aab95bc06a26.png

3)此处进行支付信息配置,对应参数的获取途径我们可点击右边问号查看。

d0042804716682e67f3b5c19c4c8464a.png

针对谷歌渠道,各个参数详细申请方式请见 文档:海外第三方渠道接入--GOOGLE

4)此处配置系统签名文件,系统文件需要主动上传。

5)商品配置需要在此处先配置通用商品信息,配置完成后如涉及第三方渠道,需要在对应渠道后台进行商品关联。

开启对应支付方式后即可见商品ID关联入口。

4b5cdc971e4682543cebaab45849d03e.png

3fd1ae46100d90ddee9828db8e6e110c.png

# 6.开始打包

打包整体请参考如下文档进行。打包完成后即可进行后续测试动作。

打包工具使用 (opens new window)

# 7.运营工具使用方式

点击左侧“发行渠道--运营工具”即可看到目前ultra提供的中台运营工具模块。 此处会根据您的游戏发行地区有所不同。分为通用渠道工具、官方国内工具、全球工具3个模块。此处的操作都会实时影响线上,请谨慎操作。 dc6402aa2571070fcf3e599d380938a5.png

# 通用渠道工具:

1)、协议管理:支持对各个渠道用户首次进入时的协议内容及权限弹窗内容更新。按需求填及勾选对应权限,配置后打开弹窗开关即可。建议每次修改后可以进行一次版本提升操作确保生效。 4701d676138ef317247fd96284261f5e.png 如进入后没有对应权限配置,请在“基础权限库”页面进行添加。 a55fe5f10594dfa31bdfbf6f6f570df4.png

2)、浮标管理:支持浮窗展示,开启后允许启用8个功能模块,可按照自身需要进行配置即可。注意每个渠道需要单独管理。 5876e9d1c7a2b9b020f5cb0ef14e11b3.png

3)、强更管理:如游戏本身不支持强更,ultra提供游戏内强更功能,添加对应渠道、设置时间、添加链接及版本号后进行操作即可。 4f0ad3bdfaf7cc82d03b518fd93a7ebd.png

4)禁用管理:对单独渠道进行注册、登录、支付等功能开启或关闭。

# 官方国内工具:

仅针对国内官方渠道生效的功能,包括实名、代金券、以及联系客服地址,注销地址等修改。其中实名内容为默认完成,通常情况下不需要调整。 f3762fccf838e7ef60e4dcd698245f09.png

# 全球工具:

仅对海外渠道生效的功能,支持切换账号、多语言协议配置及登录黑白名单的配置。其中协议语言需要自行添加对应语种版本的协议链接。 4be942a86176b11534b4f88f71fc975b.png

本文档对解决你的问题有所帮助?