Appearance
渠道SDK配置
IMPORTANT
接好的渠道SDK,必须要配置到打包工具中,方可使用。 打包工具中放置渠道SDK的目录是client/config/sdk;放置插件SDK的目录是client/config/plugin。
配置渠道jar包和资源
1、新建渠道配置目录
所有当前打包工具中接好的渠道SDK都统一放在client/config/sdk目录下。比如[上一篇]中我们接好了aaa渠道SDK。
我们现在需要配置到打包工具中,我们需要在这里新建一个子目录,并且以当前渠道名来命名,并且名称必须唯一。建议大家命名采用和工程统一的命名格式。比如之前我们的接入工程是U8SDK_AAA,那么我们这里新建一个aaa目录,作为aaa渠道的配置目录。
:client/config/sdk/aaa
2、拷贝渠道资源
之前接入的时候,我们并没有关心渠道SDK提供的资源(res)和assets等,现在我们要将他们配置到打包工具中。
1) 渠道SDK一般会提供一个Demo工程和一个库工程,我们去库工程中将libs,assets,res原封不动的拷贝到aaa目录中。
2) 上一篇中,我们在U8SDK_AAA/bin目录下生成了最终的接入工程的jar包:u8sdk_aaa.jar文件。我们将这个jar文件拷贝到aaa目录下。
3) 上一篇中,我们定义了一个config.xml和一个SDKManifest.xml文件,也拷贝到aaa目录下。
配置闪屏
NOTE:部分渠道要求游戏启动的时候先显示他提供的启动画面,通常他们会提供一张闪屏图片。部分渠道则将闪屏集成在了他们SDK的初始化接口中,无需我们这边操作,这种则不需要管闪屏了。注意,这里配置的闪屏,仅仅是渠道的闪屏,游戏如果自己也需要闪屏,逻辑自己处理。
1、U8SDK中闪屏的处理方式
因为U8SDK对多游戏的支持,所以渠道SDK的配置也要能服务于不同游戏的不同需求。所以U8SDK将闪屏分为如下四类:
横屏白色背景:11
横屏黑色背景:12
竖屏白色背景:21
竖屏黑色背景:22
对于竖屏的游戏,可以使用21,22类型的闪屏;横屏的游戏,可以使用11,12类型的闪屏
关于这里的详细说明,可以看之前[打包工具的说明](package_readme.md)中对闪屏配置的说明。或者,你可以参考我们博客上的文章:[统一闪屏解决方案](http://www.uustory.com/?p=1483)
2、配置aaa的闪屏目录
这里我们在aaa目录下,新建一个子目录splash,然后在splash下新建四个子目录,分别命名为11,12,21,22。
在各个目录中,放上对应的不同尺寸的子目录drawable,drawable-hdpi,drawable-ldpi,drawable-mdpi,drawable-xhdpi,drawable-xxhdpi,然后在这些资源目录中,放上对应尺寸的闪屏文件。闪屏文件的命名,必须为u8_splash.png
3、闪屏尺寸
各个目录下的闪屏尺寸如下(一般渠道没特殊要求,我们只需要在drawable下面放一个大小800480或者480800的png闪屏图片即可,不需要每个目录下都放):
资源目录 | 横屏尺寸(11,12) | 竖屏尺寸(21,22) |
---|---|---|
drawable-ldpi | 320*240 px | 240*320 px |
drawable-mdpi | 480*320 px | 320*480 px |
drawable-hdpi | 800*480 px | 480*800 px |
drawable-xhdpi | 1280*720 px | 720*1280 px |
drawable-xxhdpi | 1920*1080 px | 1080*1920 px |
配置角标
NOTE:部分渠道需要在游戏的图标上加上渠道的角标,传统方式是美术来完成这个工作,U8SDK中采用图片处理工具,自动将游戏图标叠加上对应的角标。
1、U8SDK中角标的处理方式
U8SDK中我们支持自动程序叠加设置好的角标到游戏图标上
游戏需要在游戏目录中的icon目录下放置一张大小512*512 px大小的ICON图片。这个ICON图片,就是游戏默认的图标。
需要附加角标的渠道,需要在渠道配置目录下新建一个icon_marks的目录,放置四张大小512*512 px大小的角标图片,为什么要四张呢?
为了适应不同游戏的不同需求,比如有的游戏适合将角标放在左上角,有的游戏适合将脚本放在右上角。所以,我们需要四张,图片名称固定,分别是
left-bottom.png:左下角
left-top.png:左上角
right-bottom.png:右下角
right-top.png:右上角
打包的时候,U8SDK会根据渠道当前的配置,来取对应的角标文件。然后缩放成不同的ICON尺寸。
关于ICON尺寸可以看这里(ICON和闪屏尺寸)。
2、配置aaa的角标
让美术根据aaa渠道提供的角标文件,做四张512*512 px的角标图片,必须是透明的png格式,角标分别处于左上角,左下角,右上角,右下角。
然后在aaa目录下,新建一个icon_marks目录,将这四张图片根据角标位置,分别命名为上面指定的名称。
使用渠道
经过上面的步骤,aaa渠道本地的配置就全部完毕了。但是现在你在打包客户端中,还无法看到该渠道。 我们还需要在U8Server后台进行渠道SDK信息的添加和配置。
1、 在U8SDK后台-》SDK管理-》渠道商管理中,添加一个aaa渠道商
2、 比如我们需要给A游戏打包,那么我们需要在U8SDK后台-》配置管理-》渠道配置中,给A游戏添加一个aaa渠道的渠道配置
如果你还不知道如何完成上面两个步骤, 请看U8SDK后台视频教程