android-SDK接入说明

一、接入说明

开发者需拥有自己原生页面开发的app,通过接入SDK实现丰富的广告集成,开发者只需要增加一个入口的方式就可获得丰富的广告资源进行变现;

安卓版本(V2.1.9)

二、使用方式

SDK采用远程库Maven库接入方式,在项目根目录增加jcenter()库,然后增加如下依赖语句:implementation ‘com.toomee:jxwSDK-Android:2.1.9’同步即可依赖。

demo下载地址 JXW_Demo2.rar

1:主入口api类:TooMeeManager类

init()方法初始化,参数如下

参数 类型 说明
一:上下文 Context String 开发者Id
二:mid String 从我们服务端或商务获取
三:resource_id String 用户唯一标识,保证唯一性
四:token String 从我们服务端或商务获取
五:自定义字段 String 自定义参数oaid(移动安全联盟oaid)和android_id(安卓设备码,一般以imei1为准),多个参数用|隔开,如 “shield,ismobile|oaid,xxxxxx|android_id,xxxxxxx”;(注意分隔符|要使用英文格式下的竖线)
六:图片加载类实例 object 你们定义一个类,实现 TooMeeImageLoader 接口,SDK内部图片加载都交给外部处理
屏蔽指定模块:shield字段表示不展示某个板块,多版块同时屏蔽用符号”_”连接,比如屏蔽益智和手游:shield,ispuzzle_ismobile
筛选指定模块:show字段表示展示某个板块,多版块同时展示用符号”_”连接,比如只展示益智和手游:show,ispuzzle_ismobile
游戏标签支持四种,isfast 快赚标签,ispuzzle 益智标签,isfish 捕鱼标签,ismobile 手游标签
1.1:正常使用
先调用 TooMeeManager.init()方法传入指定参数初始化一些信息,之后调用 TooMeeManager.start(context)方法即可

注:调用init()函数前,请动态判断手机存储权限和获取手机识别码权限

2:定制SDK内部主题颜色

目前主要几种主题颜色定义如下,如需要修改,可直接在你们 color 里面定义相同名称进行覆盖

<!--主题色 tyle1-->
<color name="tm_basic">#00bbd3</color>
<!--ToolBar 文字颜色-->
<color name="tm_toolbar_txt_color">#ffffff</color>
<!--ToolBar 分割线颜色-->
<color name="tm_toolbar_divide_Line">#00bbd3</color>
<!--底部 TabBar 背景色-->
<color name="tm_main_tab_bg">#ffffff</color>
<!--加载进度条一级背景色-->
<color name="tm_progress_gray">#f1f1f1</color>
<!--加载进度条二级背景色-->
<color name="tm_progress_second">#00bbd3</color>
3:沉浸式状态栏

如果要实现沉浸式状态栏,请增加 values-v21 和 values-v23 两个文件夹,增加 app 的 style,并增加如下定义:

<item name="android:windowLightStatusBar">true</item>
<item name="android:windowDrawsSystemBarBackgrounds">true</item>
<item name="android:startColor">@color/tm_basic</item>

其中windowLightStatusBar需要value-v23;tm_basic为SDK主要样式颜色,包括沉浸式状态栏的颜色也是去这个值的,建议填tm_basic

4:顶部标题加粗效果(文字title+返回icon)
在调用TooMeeManager.start()方法之前将TooMeeConstans中的IS_OPEN_TITLE_STYLE_BOLD静态变量置为true即可显示加粗效果,代码示例如下:
TooMeeConstans.IS_OPEN_TITLE_STYLE_BOLD=true;
5:混淆配置(复制这一行)
-keep class com.toomee.mengplus.** {*;}

三、进入单个游戏详情页

1:接入说明

首先通过API接口获取广告列表,可自行抽取需要的信息自己构建广告列表,然后通过sdk打开指定游戏详情页。

2:广告列表接口
3:拼接广告详情页url
3.1:接口参数及释义
参数 类型 说明
mid int 渠道标识,聚享玩提供
resource_id string 渠道方用户唯一标识,最长 32 位
sysver int iOS不用传,安卓10及以上系统传10,其他传9
oaid string iOS不用传,安卓10及以上需传
device string 安卓imei1值或iOS系统idfa值,安卓版本低于10需传
sign string 验签 sign=md5(mid+resource_id+token)(符号+为连接符,实际不存在)
注:sysver,device,oaid参数用以绑定用户游戏账号,请根据用户手机设备信息正确传参。
3.2 接口示例:

http://m.juxiangwan.com/game/18666?mid=1252&resource_id=11771000&sign=fef4992fd1aea91cf1a15fbbfe6a4374&sysver=9&device=861483032493013

4:打开广告详情页

传入 TooMeeManager.start(context, 广告详情页url)方法即可打开指定游戏的详情页