1、SDK以及平台功能接入流程【必读!】 » 历史记录 » 版本 23
版本 22 (魏可佳, 2022-09-21 15:26) → 版本 23/26 (张乐乐, 2022-10-09 10:45)
<h1> </h1>
<hr />
<hr />
<h2><strong>〓说明〓</strong></h2>
产品确定开始接入SDK后,请运营人员先<span style="font-size:12px;"><strong>在Redmine上发起<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E5%88%9B%E5%BB%BA%E5%8F%91%E8%A1%8C%E8%AE%A1%E5%88%92%E5%92%8C%E5%AE%A2%E6%88%B7%E7%AB%AF%E6%9B%B4%E6%96%B0%E8%AE%A1%E5%88%92">发行计划</a></strong></span>,并给相关运营、研发同学申请Redmine、GSC、BI等平台帐号,便于接入中排查问题。<br />
产品上线后,有客户端版本更新时,也请<span style="font-size:12px;"><strong>发起<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E5%88%9B%E5%BB%BA%E5%8F%91%E8%A1%8C%E8%AE%A1%E5%88%92%E5%92%8C%E5%AE%A2%E6%88%B7%E7%AB%AF%E6%9B%B4%E6%96%B0%E8%AE%A1%E5%88%92">更新计划</a></strong></span>。<br />
<br />
Redmine:发行技术部的任务流转平台,接入SDK以及相关平台功能,或者其他需求,均通过Redmine平台来发起。发行技术部需要运营或其他部门支持的业务,也会在Redmine发起。<br />
GSC:运营服务平台,包括日志查询,新版BI数据查询,新版GMT,打点查询,运维管理等一系列功能。【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/GSC%E5%8A%9F%E8%83%BD%E7%AE%80%E4%BB%8B">GSC功能简介</a>】<br />
老BI以及TGA:游戏内的经分数据目前还在这2个平台上展示,数据统计人员需要开通。<br />
<hr />
<h2><strong>〓</strong>SDK接入<strong>〓</strong></h2>
<div>研发需要按规范接入龙图安卓BaseSDK,生成安卓Base包,然后使用打包工具打出各渠道包(包括官网包)。BASE包仅用于调试,不可发布。<br />
2021年8月以后,谷歌平台新产品不支持APK上传,只能接受AAB的模式上传,如果研发需要使用AAB模式的资源管理方式,只能手工出谷歌包,不能使用打包工具。<br />
如果不是用AAB的资源管理模式,还可以继续出100M以内的母包+热更资源下载,打包工具可以把小包改成AAB模式。<br /> 如果不是用AAB的资源管理模式,还可以继续出100M以内的母包+热更资源下载,打包工具可以把小包改成AAB模式。</div>
<br SDK下载地址:<a href="http://sdk.longtubas.com/t3/241/4771/1500007444.html">http://sdk.longtubas.com/t3/241/4771/1500007444.html</a><br />
AppStore SDK需要研发手动接入并打包。<br 文档地址:<a href="http://sdk.longtubas.com/t3/241/4774/1500007458.html">http://sdk.longtubas.com/t3/241/4774/1500007458.html</a><br />
</div>
国内SDK下载地址:<a href="http://sdk.longtubas.com/t3/241/4771/1500007444.html">http://sdk.longtubas.com/t3/241/4771/1500007444.html</a><br 请使用技术支持人员提供的配置文件,请替换掉demo里的配置文件。<br />
海外SDK下载地址:http://sdk.longtubas.com/t3/241/4772/1500007447.html<br <br />
国内客户端接入文档:<a href="http://sdk.longtubas.com/t3/241/4774/1500007458.html">http://sdk.longtubas.com/t3/241/4774/1500007458.html</a><br 打包工具下载地址:<a href="http://sdk.longtubas.com/t3/241/4773/1500007448.html">http://sdk.longtubas.com/t3/241/4773/1500007448.html</a><br />
海外客户端接入文档:http://sdk.longtubas.com/t3/241/4775/1500007475.html<br 打包工具操作说明:<a href="http://sdk.longtubas.com/t3/241/4776/1500007452.html">http://sdk.longtubas.com/t3/241/4776/1500007452.html</a><br />
服务端接入文档:http://sdk.longtubas.com/t3/241/4775/1500007515.html<br <br />
<br />
请使用技术支持人员提供的配置文件,请替换掉demo里的配置文件。<br AppStore SDK需要研发手动接入并打包;<br />
<br SDK下载地址:<a href="http://sdk.longtubas.com/t3/241/4771/1500007446.html">http://sdk.longtubas.com/t3/241/4771/1500007446.html</a><br />
打包工具下载地址:<a href="http://sdk.longtubas.com/t3/241/4773/1500007448.html">http://sdk.longtubas.com/t3/241/4773/1500007448.html</a><br 文档地址:<a href="http://sdk.longtubas.com/t3/241/4774/1500007596.html">http://sdk.longtubas.com/t3/241/4774/1500007596.html</a><br />
打包工具操作说明:<a href="http://sdk.longtubas.com/t3/241/4776/1500007452.html">http://sdk.longtubas.com/t3/241/4776/1500007452.html</a><br 请使用技术支持人员提供的配置文件,请替换掉demo里的配置文件。<br />
<br />
接入调试时,需要在GSC平台配置游戏服ID,否则无法调试支付、礼包码等功能,日志信息也不准确。【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E6%B8%B8%E6%88%8F%E6%9C%8D%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E">游戏服配置说明</a>】<br />
<br />
接入支付时,需要先和技术支持沟通调试的商品ID和价格,再接入调试。【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E6%94%AF%E4%BB%98%E8%B0%83%E8%AF%95%E8%AF%B4%E6%98%8E">支付调试说明</a>】<br />
<br />
注意:<br />
1、文档中的游戏进度上报必须要接入,用于控制悬浮层按钮的显示和关闭;【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E6%82%AC%E6%B5%AE%E5%B1%82%E6%8C%89%E9%92%AE%E8%AF%B4%E6%98%8E">悬浮层按钮说明</a>】<br />
2、需要根据文档获取ServiceId(渠道id),Servicecode和SNID,上报给服务端,用于判断渠道以及上报BI数据使用;<br />
3、IOS包需要支持ipv6网络;<br />
4、需接入获取资源更新CDN地址功能,CDN地址不能固定写在客户端内。【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/CND%E8%B5%84%E6%BA%90%E4%B8%8A%E4%BC%A0%E4%BB%A5%E5%8F%8A%E6%9B%B4%E6%96%B0%E8%AF%B4%E6%98%8E">CDN资源上传以及更新说明</a>】<br />
<br />
其他功能<br />
1、通过webview展示外部链接,如调查问卷等。<br />
<br />
<span style="font-size:14px;"><strong>接入SDK后请提交客户端给技术支持人员进行发行相关规范测试,包括SDK测试以及渠道规范测试,请预留测试时间。<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E5%8F%91%E8%A1%8C%E6%B5%8B%E8%AF%95%E6%97%B6%E9%97%B4%E5%AE%89%E6%8E%92">点击查看测试时间安排</a></strong></span><br />
<br />
游戏包提包流程<br />
<img alt="" data-rich-file-id="10513" src="http://pm.longtuyun.com:880/system/rich/rich_files/rich_files/000/010/513/original/111.png" /><br />
<hr />
<h2><strong>〓GMT</strong>接入<strong>〓</strong></h2>
GMT接入文档:http://sdk.longtubas.com/t3/241/4774/1500009456.html<br />
<br />
GMT功能需要运营提出具体需求,研发接入平台部门的接口来实现,如果平台目前不支持的功能,需要沟通后新开发;<br />
SDK自身支持,不需要研发单独接入:<br />
1、登录前公告(SDK实现,需要提供UI图);【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E6%B8%B8%E6%88%8F%E5%85%AC%E5%91%8A%E8%AF%B4%E6%98%8E%EF%BC%88%E6%96%B0%EF%BC%89">公告UI图说明</a>】<br />
2、强制更新(根据版本号控制,可以强制更新或者提示更新);<br />
3、激活码登录(只有使用激活码才能登录帐号);<br />
4、白名单功能(限制帐号是否可以登录,无法控制帐号登录后进入游戏服);<br />
5、客服反馈(登录前浮窗位置存在入口,研发也可再游戏内设置UI调用客服反馈接口,从而通过反馈的问题获取更详细的玩家信息)<br />
<br />
必接项:<br />
1、信息审查接口(原聊天监控):游戏内玩家可自主输入文字的地方,均需要接入;<br />
2、角色禁言\封停;<br />
3、查询和修改角色属性;<br />
4、研发需要在本地做基础判断,一些特殊符号不允许出现在角色名、公会名、队伍名、联盟名等名称中,具体符号_(, | { } " ' \ / @ * $ # & ! - + ( ) . ? ~ )^<br />
5、角色ID必须全局唯一,跨服跨大区不能重复,否则后续合服时GMT相关功能无法判断;<br />
<br />
选接功能:<br />
1、进服后公告(需要提供UI:【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E6%B8%B8%E6%88%8F%E5%85%AC%E5%91%8A%E8%AF%B4%E6%98%8E%EF%BC%88%E6%96%B0%EF%BC%89">公告UI图说明</a>】);<br href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E5%85%AC%E5%91%8AUI%E5%9B%BE%E8%AF%B4%E6%98%8E">公告UI图说明</a>】);<br />
2、游戏内跑马灯公告(滚动字幕);<br />
3、游戏内邮件(满足发附件、分区服、分角色、角色注册、补单通知邮件等需求);<br />
4、礼包码兑换(唯一码、共用码、分服配置、分渠道配置、设备/账号/角色限制条件)<br />
5、入口开关(控制自定义功能的开关)<br />
6、GM指令<br />
7、游戏服列表功能(区服白名单、游戏服状态、维护公告)<br />
8、图片审核
<hr />
<h2><strong>〓BI</strong>接入<strong>〓</strong></h2>
BI数据上报文档:http://sdk.longtubas.com/t3/241/4774/1500010238.html<br />
快照数据上报:http://sdk.longtubas.com/t3/241/4774/1500010239.html<br BI数据上报文档:<a href="http://121.196.220.70:8888/showdoc/web/#/2">http://121.196.220.70:8888/showdoc/web/#/2</a><br />
BI数据上报按文档接入即可,有其他方面的经分数据需求,运营人员和BI组的同学沟通,安排开发和接入;<br />
<br />
SDK打点接口文档:<a href="http://sdk.longtubas.com/t3/241/4774/1500007629.html">http://sdk.longtubas.com/t3/241/4774/1500007629.html</a><br />
每个产品的打点内容,运营和研发确认后,发给平台BI人员,确认如何调用SDK接口上报,返回给研发人员接入;<br />
其中热更开始、热更成功、热更失败 3个点位是必接项,请研发同学一定要接入,方便后续定位资源热更相关的问题。<br />
<br />
同时游戏内的一些流水日志也可以通过打点接口上报上来,后续可以在GSC平台查询,具体可以和BI人员沟通确认;<br />
<br />
回到页首
<hr />
<hr />
<h2><strong>〓说明〓</strong></h2>
产品确定开始接入SDK后,请运营人员先<span style="font-size:12px;"><strong>在Redmine上发起<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E5%88%9B%E5%BB%BA%E5%8F%91%E8%A1%8C%E8%AE%A1%E5%88%92%E5%92%8C%E5%AE%A2%E6%88%B7%E7%AB%AF%E6%9B%B4%E6%96%B0%E8%AE%A1%E5%88%92">发行计划</a></strong></span>,并给相关运营、研发同学申请Redmine、GSC、BI等平台帐号,便于接入中排查问题。<br />
产品上线后,有客户端版本更新时,也请<span style="font-size:12px;"><strong>发起<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E5%88%9B%E5%BB%BA%E5%8F%91%E8%A1%8C%E8%AE%A1%E5%88%92%E5%92%8C%E5%AE%A2%E6%88%B7%E7%AB%AF%E6%9B%B4%E6%96%B0%E8%AE%A1%E5%88%92">更新计划</a></strong></span>。<br />
<br />
Redmine:发行技术部的任务流转平台,接入SDK以及相关平台功能,或者其他需求,均通过Redmine平台来发起。发行技术部需要运营或其他部门支持的业务,也会在Redmine发起。<br />
GSC:运营服务平台,包括日志查询,新版BI数据查询,新版GMT,打点查询,运维管理等一系列功能。【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/GSC%E5%8A%9F%E8%83%BD%E7%AE%80%E4%BB%8B">GSC功能简介</a>】<br />
老BI以及TGA:游戏内的经分数据目前还在这2个平台上展示,数据统计人员需要开通。<br />
<hr />
<h2><strong>〓</strong>SDK接入<strong>〓</strong></h2>
<div>研发需要按规范接入龙图安卓BaseSDK,生成安卓Base包,然后使用打包工具打出各渠道包(包括官网包)。BASE包仅用于调试,不可发布。<br />
2021年8月以后,谷歌平台新产品不支持APK上传,只能接受AAB的模式上传,如果研发需要使用AAB模式的资源管理方式,只能手工出谷歌包,不能使用打包工具。<br />
如果不是用AAB的资源管理模式,还可以继续出100M以内的母包+热更资源下载,打包工具可以把小包改成AAB模式。<br /> 如果不是用AAB的资源管理模式,还可以继续出100M以内的母包+热更资源下载,打包工具可以把小包改成AAB模式。</div>
<br SDK下载地址:<a href="http://sdk.longtubas.com/t3/241/4771/1500007444.html">http://sdk.longtubas.com/t3/241/4771/1500007444.html</a><br />
AppStore SDK需要研发手动接入并打包。<br 文档地址:<a href="http://sdk.longtubas.com/t3/241/4774/1500007458.html">http://sdk.longtubas.com/t3/241/4774/1500007458.html</a><br />
</div>
国内SDK下载地址:<a href="http://sdk.longtubas.com/t3/241/4771/1500007444.html">http://sdk.longtubas.com/t3/241/4771/1500007444.html</a><br 请使用技术支持人员提供的配置文件,请替换掉demo里的配置文件。<br />
海外SDK下载地址:http://sdk.longtubas.com/t3/241/4772/1500007447.html<br <br />
国内客户端接入文档:<a href="http://sdk.longtubas.com/t3/241/4774/1500007458.html">http://sdk.longtubas.com/t3/241/4774/1500007458.html</a><br 打包工具下载地址:<a href="http://sdk.longtubas.com/t3/241/4773/1500007448.html">http://sdk.longtubas.com/t3/241/4773/1500007448.html</a><br />
海外客户端接入文档:http://sdk.longtubas.com/t3/241/4775/1500007475.html<br 打包工具操作说明:<a href="http://sdk.longtubas.com/t3/241/4776/1500007452.html">http://sdk.longtubas.com/t3/241/4776/1500007452.html</a><br />
服务端接入文档:http://sdk.longtubas.com/t3/241/4775/1500007515.html<br <br />
<br />
请使用技术支持人员提供的配置文件,请替换掉demo里的配置文件。<br AppStore SDK需要研发手动接入并打包;<br />
<br SDK下载地址:<a href="http://sdk.longtubas.com/t3/241/4771/1500007446.html">http://sdk.longtubas.com/t3/241/4771/1500007446.html</a><br />
打包工具下载地址:<a href="http://sdk.longtubas.com/t3/241/4773/1500007448.html">http://sdk.longtubas.com/t3/241/4773/1500007448.html</a><br 文档地址:<a href="http://sdk.longtubas.com/t3/241/4774/1500007596.html">http://sdk.longtubas.com/t3/241/4774/1500007596.html</a><br />
打包工具操作说明:<a href="http://sdk.longtubas.com/t3/241/4776/1500007452.html">http://sdk.longtubas.com/t3/241/4776/1500007452.html</a><br 请使用技术支持人员提供的配置文件,请替换掉demo里的配置文件。<br />
<br />
接入调试时,需要在GSC平台配置游戏服ID,否则无法调试支付、礼包码等功能,日志信息也不准确。【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E6%B8%B8%E6%88%8F%E6%9C%8D%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E">游戏服配置说明</a>】<br />
<br />
接入支付时,需要先和技术支持沟通调试的商品ID和价格,再接入调试。【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E6%94%AF%E4%BB%98%E8%B0%83%E8%AF%95%E8%AF%B4%E6%98%8E">支付调试说明</a>】<br />
<br />
注意:<br />
1、文档中的游戏进度上报必须要接入,用于控制悬浮层按钮的显示和关闭;【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E6%82%AC%E6%B5%AE%E5%B1%82%E6%8C%89%E9%92%AE%E8%AF%B4%E6%98%8E">悬浮层按钮说明</a>】<br />
2、需要根据文档获取ServiceId(渠道id),Servicecode和SNID,上报给服务端,用于判断渠道以及上报BI数据使用;<br />
3、IOS包需要支持ipv6网络;<br />
4、需接入获取资源更新CDN地址功能,CDN地址不能固定写在客户端内。【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/CND%E8%B5%84%E6%BA%90%E4%B8%8A%E4%BC%A0%E4%BB%A5%E5%8F%8A%E6%9B%B4%E6%96%B0%E8%AF%B4%E6%98%8E">CDN资源上传以及更新说明</a>】<br />
<br />
其他功能<br />
1、通过webview展示外部链接,如调查问卷等。<br />
<br />
<span style="font-size:14px;"><strong>接入SDK后请提交客户端给技术支持人员进行发行相关规范测试,包括SDK测试以及渠道规范测试,请预留测试时间。<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E5%8F%91%E8%A1%8C%E6%B5%8B%E8%AF%95%E6%97%B6%E9%97%B4%E5%AE%89%E6%8E%92">点击查看测试时间安排</a></strong></span><br />
<br />
游戏包提包流程<br />
<img alt="" data-rich-file-id="10513" src="http://pm.longtuyun.com:880/system/rich/rich_files/rich_files/000/010/513/original/111.png" /><br />
<hr />
<h2><strong>〓GMT</strong>接入<strong>〓</strong></h2>
GMT接入文档:http://sdk.longtubas.com/t3/241/4774/1500009456.html<br />
<br />
GMT功能需要运营提出具体需求,研发接入平台部门的接口来实现,如果平台目前不支持的功能,需要沟通后新开发;<br />
SDK自身支持,不需要研发单独接入:<br />
1、登录前公告(SDK实现,需要提供UI图);【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E6%B8%B8%E6%88%8F%E5%85%AC%E5%91%8A%E8%AF%B4%E6%98%8E%EF%BC%88%E6%96%B0%EF%BC%89">公告UI图说明</a>】<br />
2、强制更新(根据版本号控制,可以强制更新或者提示更新);<br />
3、激活码登录(只有使用激活码才能登录帐号);<br />
4、白名单功能(限制帐号是否可以登录,无法控制帐号登录后进入游戏服);<br />
5、客服反馈(登录前浮窗位置存在入口,研发也可再游戏内设置UI调用客服反馈接口,从而通过反馈的问题获取更详细的玩家信息)<br />
<br />
必接项:<br />
1、信息审查接口(原聊天监控):游戏内玩家可自主输入文字的地方,均需要接入;<br />
2、角色禁言\封停;<br />
3、查询和修改角色属性;<br />
4、研发需要在本地做基础判断,一些特殊符号不允许出现在角色名、公会名、队伍名、联盟名等名称中,具体符号_(, | { } " ' \ / @ * $ # & ! - + ( ) . ? ~ )^<br />
5、角色ID必须全局唯一,跨服跨大区不能重复,否则后续合服时GMT相关功能无法判断;<br />
<br />
选接功能:<br />
1、进服后公告(需要提供UI:【<a href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E6%B8%B8%E6%88%8F%E5%85%AC%E5%91%8A%E8%AF%B4%E6%98%8E%EF%BC%88%E6%96%B0%EF%BC%89">公告UI图说明</a>】);<br href="http://pm.longtuyun.com:880/projects/wiki/wiki/%E5%85%AC%E5%91%8AUI%E5%9B%BE%E8%AF%B4%E6%98%8E">公告UI图说明</a>】);<br />
2、游戏内跑马灯公告(滚动字幕);<br />
3、游戏内邮件(满足发附件、分区服、分角色、角色注册、补单通知邮件等需求);<br />
4、礼包码兑换(唯一码、共用码、分服配置、分渠道配置、设备/账号/角色限制条件)<br />
5、入口开关(控制自定义功能的开关)<br />
6、GM指令<br />
7、游戏服列表功能(区服白名单、游戏服状态、维护公告)<br />
8、图片审核
<hr />
<h2><strong>〓BI</strong>接入<strong>〓</strong></h2>
BI数据上报文档:http://sdk.longtubas.com/t3/241/4774/1500010238.html<br />
快照数据上报:http://sdk.longtubas.com/t3/241/4774/1500010239.html<br BI数据上报文档:<a href="http://121.196.220.70:8888/showdoc/web/#/2">http://121.196.220.70:8888/showdoc/web/#/2</a><br />
BI数据上报按文档接入即可,有其他方面的经分数据需求,运营人员和BI组的同学沟通,安排开发和接入;<br />
<br />
SDK打点接口文档:<a href="http://sdk.longtubas.com/t3/241/4774/1500007629.html">http://sdk.longtubas.com/t3/241/4774/1500007629.html</a><br />
每个产品的打点内容,运营和研发确认后,发给平台BI人员,确认如何调用SDK接口上报,返回给研发人员接入;<br />
其中热更开始、热更成功、热更失败 3个点位是必接项,请研发同学一定要接入,方便后续定位资源热更相关的问题。<br />
<br />
同时游戏内的一些流水日志也可以通过打点接口上报上来,后续可以在GSC平台查询,具体可以和BI人员沟通确认;<br />
<br />