android-SDK接入说明
<h4>一、接入说明</h4>
<p>开发者需拥有自己原生页面开发的app,通过接入SDK实现丰富的广告集成,开发者只需要增加一个入口的方式就可获得丰富的广告资源进行变现;</p>
<p><strong>安卓版本(V2.1.9)</strong></p>
<h4>二、使用方式</h4>
<p>SDK采用远程库Maven库接入方式,在项目根目录增加jcenter()库,然后增加如下依赖语句:implementation 'com.toomee:jxwSDK-Android:2.1.9'同步即可依赖。</p>
<p>demo下载地址:<a href="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=abb62d16a9c75545c41885bdf78df091" title="[JXW_Demo2.zip">JXW_Demo2.zip</a></p>
<p>sdk下载地址:<a href="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=4b272ec5cd8e7457bc57cc8ae5ddde5d" title="[jxw_sdk.aar">jxw_sdk.aar</a></p>
<h5>1:主入口api类:TooMeeManager类</h5>
<p>init()方法初始化,参数如下</p>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>一:上下文 Context</td>
<td>String</td>
<td>开发者Id</td>
</tr>
<tr>
<td>二:mid</td>
<td>String</td>
<td>从我们服务端或商务获取</td>
</tr>
<tr>
<td>三:resource_id</td>
<td>String</td>
<td>用户唯一标识,保证唯一性(一般以贵方用户ID作为resource_id)</td>
</tr>
<tr>
<td>四:token</td>
<td>String</td>
<td>从我们服务端或商务获取</td>
</tr>
<tr>
<td>五:自定义字段(必传)</td>
<td>String</td>
<td>自定义参数oaid(移动安全联盟oaid)和android_id(安卓设备码,传imei1),安卓10及以上机型必传oaid,安卓10以下机型必传android_id</td>
</tr>
<tr>
<td>六:图片加载类实例</td>
<td>object</td>
<td>你们定义一个类,实现 TooMeeImageLoader 接口,SDK内部图片加载都交给外部处理</td>
</tr>
</tbody>
</table>
<h6>屏蔽指定模块:shield字段表示不展示某个板块,多版块同时屏蔽用符号"_"连接,比如屏蔽益智和手游:shield,ispuzzle_ismobile</h6>
<h6>筛选指定模块:show字段表示展示某个板块,多版块同时展示用符号"_"连接,比如只展示益智和手游:show,ispuzzle_ismobile</h6>
<h6>游戏标签支持四种,isfast 快赚标签,ispuzzle 益智标签,isfish 捕鱼标签,ismobile 手游标签</h6>
<h5>1.1:正常使用</h5>
<pre><code>先调用 TooMeeManager.init()方法传入指定参数初始化一些信息,之后调用 TooMeeManager.start(context)方法即可</code></pre>
<p>注:调用init()函数前,请动态判断手机存储权限和获取手机识别码权限</p>
<h5>2:定制SDK内部主题颜色</h5>
<p>目前主要几种主题颜色定义如下,如需要修改,可直接在你们 color 里面定义相同名称进行覆盖</p>
<pre><code class="language-html"><!--主题色 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></code></pre>
<h5>3:沉浸式状态栏</h5>
<p>如果要实现沉浸式状态栏,请增加 values-v21 和 values-v23 两个文件夹,增加 app 的 style,并增加如下定义:</p>
<pre><code class="language-html"><item name="android:windowLightStatusBar">true</item>
<item name="android:windowDrawsSystemBarBackgrounds">true</item>
<item name="android:startColor">@color/tm_basic</item></code></pre>
<p>其中windowLightStatusBar需要value-v23;tm_basic为SDK主要样式颜色,包括沉浸式状态栏的颜色也是去这个值的,建议填tm_basic</p>
<h5>4:顶部标题加粗效果(文字title+返回icon)</h5>
<pre><code>在调用TooMeeManager.start()方法之前将TooMeeConstans中的IS_OPEN_TITLE_STYLE_BOLD静态变量置为true即可显示加粗效果,代码示例如下:
TooMeeConstans.IS_OPEN_TITLE_STYLE_BOLD=true;</code></pre>
<h5>5:混淆配置(复制这一行)</h5>
<pre><code class="language-java">-keep class com.toomee.mengplus.** {*;}</code></pre>
<h4>三、进入单个游戏详情页(仅针对渠道想自行设计游戏列表部分,没有这个需求可不看这部分)</h4>
<h5>1:接入说明</h5>
<p>首先通过API接口获取广告列表,可自行抽取需要的信息自己构建广告列表,然后通过sdk打开指定游戏详情页。</p>
<h5>2:广告列表接口</h5>
<ul>
<li>见文档目录api方式》<a href="https://www.showdoc.com.cn/1265763821273032?page_id=6356039092185680" title="见文档目录api方式广告列表新版接口">获取游戏列表</a></li>
</ul>
<h5>3:拼接广告详情页url</h5>
<h6>3.1:接口参数及释义</h6>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>mid</td>
<td>int</td>
<td>渠道标识,聚享玩提供</td>
</tr>
<tr>
<td>resource_id</td>
<td>string</td>
<td>渠道方用户唯一标识,最长 32 位(一般以贵方用户ID作为resource_id)</td>
</tr>
<tr>
<td>sysver</td>
<td>int</td>
<td>iOS不用传,安卓10及以上系统传10,其他传9</td>
</tr>
<tr>
<td>oaid</td>
<td>string</td>
<td>iOS不用传,安卓10及以上需传</td>
</tr>
<tr>
<td>device</td>
<td>string</td>
<td>安卓imei1值或iOS系统idfa值,安卓版本低于10需传</td>
</tr>
<tr>
<td>sign</td>
<td>string</td>
<td>验签 <strong>sign=md5(mid+resource_id+token)</strong>(符号+为连接符,实际不存在)</td>
</tr>
</tbody>
</table>
<h5>注:sysver,device,oaid参数用以绑定用户游戏账号,请根据用户手机设备信息正确传参。</h5>
<h6>3.2 接口示例:</h6>
<p><a href="http://m.juxiangwan.com/game/18666?mid=1252&resource_id=11771000&sign=fef4992fd1aea91cf1a15fbbfe6a4374&sysver=9&device=861483032493013">http://m.juxiangwan.com/game/18666?mid=1252&resource_id=11771000&sign=fef4992fd1aea91cf1a15fbbfe6a4374&sysver=9&device=861483032493013</a></p>
<h5>4:打开广告详情页</h5>
<p>传入 TooMeeManager.start(context, 广告详情页url)方法即可打开指定游戏的详情页</p>