# 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后台，运营提供账号为当前公司下的管理员账户，可以自行添加子账号。
2.完成登录后首次进行游戏创建
3.添加游戏时请输入游戏名称，及发行地区，后续如有变动可进行修改。
创建完成后即可看到如下信息：
其中product ID、ProductKey、CallbackKey三个参数请给到开发方在接入时候使用。
# 2.SDK接入及测试：
开始接入之前，您可以通过如下链接中，选择适合您的方式进行接入。其中服务端文档属于必须要接入的内容。
SDK接入指南及资源下载链接见下:
服务端接入文档如下：
# 3.母包测试
接入完成后可本地出母包进行首次的登录及测试，您可以参考下图中的步骤逐步完成测试。
母包测试前需要完成支付回调、测试商品、测试账号的配置。
母包测试时，安卓端需要通过中台创建含有支付额度的母包账号， 并使用此账号登录进行，IOS端无法进行直接游戏的母包测试，需要通过打印日志进行测试，请参考下方链接中的测试说明。
# 4.后台打包参数配置：
1)按照您需要接入的渠道进行配置添加。点击后添加所需渠道即可。
2)添加后即可在此处编辑对应渠道的参数信息。
3）以海外安卓为例，在这里编辑游戏包名
需要注意游戏包名需要和渠道的后台一致（如google play市场、华为市场等），否则会无法登录。
渠道参数和客户端参数默认会带出部分信息，正常情况下不需要修改。
同时下方会展示初始化时需要的参数，如需要登录该渠道，请勾选并配置参数
4）此处进行ICON及闪屏设置。
5）配置结束后，打包参数及状态显示为“已配置”则说明可以进行打包；如状态提示为未开通，请联系对接商务沟通即可。
# 5.渠道线上配置
1）此处可进行登录、支付、商品的配置，此处配置为线上即时生效，请注意在游戏上线后不要随意修改。
2）登录管理默认打开需要的渠道即可，其中FaceBook配置建议同时打开BusinessId。
需注意，如果在“打包参数配置中”未进行对应渠道的参数配置，即使打开该渠道也无法进行登录。
3）此处进行支付信息配置，对应参数的获取途径我们可点击右边问号查看。
针对谷歌渠道，各个参数详细申请方式请见 文档：海外第三方渠道接入--GOOGLE
4）此处配置系统签名文件，系统文件需要主动上传。
5）商品配置需要在此处先配置通用商品信息，配置完成后如涉及第三方渠道，需要在对应渠道后台进行商品关联。
开启对应支付方式后即可见商品ID关联入口。
# 6.开始打包
打包整体请参考如下文档进行。打包完成后即可进行后续测试动作。
# 7.运营工具使用方式
点击左侧“发行渠道--运营工具”即可看到目前ultra提供的中台运营工具模块。
此处会根据您的游戏发行地区有所不同。分为通用渠道工具、官方国内工具、全球工具3个模块。此处的操作都会实时影响线上，请谨慎操作。
# 通用渠道工具：
1）、协议管理：支持对各个渠道用户首次进入时的协议内容及权限弹窗内容更新。按需求填及勾选对应权限，配置后打开弹窗开关即可。建议每次修改后可以进行一次版本提升操作确保生效。
如进入后没有对应权限配置，请在“基础权限库”页面进行添加。
2）、浮标管理：支持浮窗展示，开启后允许启用8个功能模块，可按照自身需要进行配置即可。注意每个渠道需要单独管理。
3）、强更管理：如游戏本身不支持强更，ultra提供游戏内强更功能，添加对应渠道、设置时间、添加链接及版本号后进行操作即可。
4）禁用管理：对单独渠道进行注册、登录、支付等功能开启或关闭。
# 官方国内工具：
仅针对国内官方渠道生效的功能，包括实名、代金券、以及联系客服地址，注销地址等修改。其中实名内容为默认完成，通常情况下不需要调整。
# 全球工具：
仅对海外渠道生效的功能，支持切换账号、多语言协议配置及登录黑白名单的配置。其中协议语言需要自行添加对应语种版本的协议链接。
