DU Ad Platform_SDK for Android 接入手册 Version: DuWeatherSDK_1.1.6 前提 : DuWeather SDK 需要依赖 DU Ad Platform_SDK HW 或 CW ( 含 ) 以上版本在接入 DuW

Size: px

Start display at page:

Download "DU Ad Platform_SDK for Android 接入手册 Version: DuWeatherSDK_1.1.6 前提 : DuWeather SDK 需要依赖 DU Ad Platform_SDK HW 或 CW ( 含 ) 以上版本在接入 DuW"

摄从
4 years ago
Views:

1 DU Ad Platform_SDK for Android 接入手册 Version: DuWeatherSDK_1.1.6 前提 : DuWeather SDK 需要依赖 DU Ad Platform_SDK HW 或 CW ( 含 ) 以上版本在接入 DuWeather 之前需要完成 HW 或 CW 初始化, 加载, 代码混淆三个部分 DU Ad Platform_SDK for Android 接入手册 1. 获取身份 2. 加载与配置 2.1 导入 SDK 文件 2.2 配置 AndroidManifest.xml 2.3 混淆代码 3. 初始化 4. 功能使用 4.1 卡片控件 4.2 桌面悬浮窗控件 4.3 天气通知栏 1. 获取身份请参照 HW 或 CW 版 DUADplatform SDK 文档第 3 章 ; 申请 DuWeather 广告位时, 需申请的广告位类型为天气通 2. 加载与配置请严格按照本章进行行配置, 否则有可能会出现运行行异常请参照 HW 或 CW 版 DUADplatform SDK 文档第 4 章, 完成后继续阅读本文档 2.1 导入 SDK 文件拷贝 SDK aar 包放到你的安卓工程文件根目录的 libs 目录下, 然后配置 build.gradle :

2 repositories { flatdir { dirs 'libs' dependencies { compile filetree(include: ['*.jar'], dir: 'libs') compile(name: 'DuappsAd-xW-xxx-release', ext: 'aar') compile(name: 'DAPSDK_Weather-release-xxx' ext: 'aar') * 注 : flatdir 指定的位置即为 aar 存放的位置 2.2 配置 AndroidManifest.xml 添加 DuWeather 的额外权限 : // 以下权限用于获取准确地理理位置下发天气数据没有该权限时 DuWeather 会使用模糊地理理位置, 可能导致信息下发不不准确 <uses-permission android:name="android.permission.access_wifi_state" /> // 以下权限用于桌面悬浮窗功能, 若不不使用该功能可不不用申请 <uses-permission android:name="android.permission.get_tasks"/> <uses-permission android:name="android.permission.system_alert_window" /> 添加 DuWeather 的 Activity, receiver, service:  <activity android:name="com.daps.weather.dapweatheractivity" android:screenorientation="portrait" /> <receiver android:name="com.daps.weather.reciver.dapweatherbroadcastreceiver"> <intent-filter android:priority="90000"> <action android:name="android.intent.action.user_present"/> //1.1 版本新增 <action android:name="com.daps.weather.broadcast"/> </intent-filter> </receiver> <service android:name="com.daps.weather.service.dapweathermsgservice" />

3 <service android:name="com.daps.weather.location.dapweatherlocationsservice" />  2.3 混淆代码请务必按如下混淆规则对应用代码进行行混淆, 否则有可能会出现运行行异常 : 将以下类添加到 proguard 配置 : -keep public class com.daps.weather.notification.dapweathernotification { *; -keep public class com.daps.weather.weathercard.dapweatherview { public <methods>; -keep public class com.daps.weather.dapweatheractivity { public <methods>; -keep public class com.daps.weather.service.dapweathermsgservice { *; -keep public class com.daps.weather.location.dapweatherlocationsservice { *; -keep public class com.daps.weather.dapweather { public <methods>; -keep public class com.daps.weather.weathercard.dapweatherenterimageview { public <methods>; -keep public class com.daps.weather.floatdisplay.floatdisplaycontroller { *; -keep public class com.daps.weather.base.sharedprefsutils { public static boolean issuspensionon(android.content.context); public static void setsuspensionon(android.content.context,boolean); -keep class com.daps.weather.bean.**{*; -keep class com.daps.weather.notification.dapweathernotification$weathernotificationlist ener { *; -keep attributes InnerClasses 注 : 混淆方法参见 Android 官方混淆文档 :${ android-sdk /tools/proguard/ 3. 初始化

4 3. 初始化 1. 创建 Json 文件, 将 Placement_ID 与广告位类型建立对应关系具体格式如下 : { "weather": [ { "pid": "YOUR_DAP_PLACEMENT_ID" ] 2. 在 application 的 OnCreate() 方法中使用 DapWeather.init() 接口 : public static void init(context context,int pid) Context context int pid ACTIVITY CONTEXT 天气通广告位 id 注 : 请在完成 DuAdNetwork.init 后进行行 DapWeather.init 代码示例例 : public void oncreate() { super.oncreate(); // 初始化 DAP SDK DuAdNetwork.init(this, getconfigjson(getapplicationcontext())); // 初始化天气 SDK DapWeather.init((Application) getapplicationcontext(), My_Weather_pid); 3. 设置定位的更更新时间 DapWeather.setLocationUpdateTime(), 默认 600 秒获取定位失败时, 天气功能将不不能使用该方法为设置定位失败后再次更更新的时间建议设置间隔在 1 小时以内接口 : public static void setlocationupdatetime(context context, int second)

5 Context context int second ACTIVITY CONTEXT 定位更更新时间, 单位为秒获取当前设置的定位更更新时间, 单位为秒 public static int getlocationupdatetime(context context) Context context ACTIVITY CONTEXT 4. 功能使用 4.1 卡片控件应用内卡片控件, 主要用于在 app 内部进行行天气显示 public DapWeatherView(Context context) 天气卡片控件, 可以添加到需要显示的布局中 public void load() 加载天气数据, 有数据自动填充 DapWeatherView 卡片代码示例例 :

// 卡片入口 RelativeLayout rl = (RelativeLayout) findviewbyid(r.id.demo_weather_view_rl); DapWeatherView mduweatherview = new DapWeatherView(this); rl.addview(mduweatherview); findviewbyid(r.id.btn_weather_view).

6 // 卡片入口 RelativeLayout rl = (RelativeLayout) findviewbyid(r.id.demo_weather_view_rl); DapWeatherView mduweatherview = new DapWeatherView(this); rl.addview(mduweatherview); findviewbyid(r.id.btn_weather_view).setonclicklistener(new View.OnClickListener() public void onclick(view view) { mduweatherview.load(); ); 4.2 桌面悬浮窗控件该控件为在手机桌面右侧显示的一个半透明天气悬浮窗点击后进入天气结果页注 : 在 android 6.0, 需要用户手动开启悬浮窗权限, 实现方式请参考 Demo

public void FloatDisplayController.setFloatSerachWindowIsShow(Context context, Boolean isshown) Context context Boolean isshown ACTIVITY CONTEXT 功能开关 True 表示功能开启代码示例例 : // 悬浮框入口 findviewbyid(r.id.btn_weather_suspension).

7 public void FloatDisplayController.setFloatSerachWindowIsShow(Context context, Boolean isshown) Context context Boolean isshown ACTIVITY CONTEXT 功能开关 True 表示功能开启代码示例例 : // 悬浮框入口 findviewbyid(r.id.btn_weather_suspension).setonclicklistener(new View.OnClickListener() public void onclick(view view) { FloatDisplayController.setFloatSerachWindowIsShow(getApplicationContext(), true); ); 4.3 天气通知栏该控件为定时推送的天气通知点击后进入天气结果页请在应用 Application 类或子类中进行行天气通知栏相关设置如果在 Activity 中注册通知栏回调, 当 Activity 被销毁时, 通知栏会没有点击和展示回调通知栏样式 : 暗色主题 : 亮色主题 :

注 : 通知栏是定时推送服务, 由百度服务器器控制 ; 7:30-12:00 推送当日天气 ; 13:00-20:30 推送升降温天气 ; 20:30-23:00 推送次日天气 ; 每个时间段只会推送一次天气通知, 通知栏功能开启后 SDK 会自动进行行通知加载相关接口 : public DapWeatherNotification.

8 注 : 通知栏是定时推送服务, 由百度服务器器控制 ; 7:30-12:00 推送当日天气 ; 13:00-20:30 推送升降温天气 ; 20:30-23:00 推送次日天气 ; 每个时间段只会推送一次天气通知, 通知栏功能开启后 SDK 会自动进行行通知加载相关接口 : public DapWeatherNotification.getInstance(Context context) 初始化天气通知栏功能 public void setongoing(boolean bool) 设置通知栏常驻 ( 不不可被用户忽略略 ),true 为常驻通知栏,false 为临时通知栏该功能默认为 true public void setautocancel(boolean bool) 设置点击通知栏后是否自动关闭通知栏,true 为自动关闭通知栏,false 为不不自动关闭通知栏该功能默认为 false, 只对临时通知栏 setongoing(false) 有效 public void setpushtodaytomorrowweather(boolean bool) 设置今天和明日天气推送功能 true 为功能开启,false 为功能关闭该功能默认为 true public void setpushelevatingtemperature(boolean bool) 设置升降温推送功能 true 为功能开启,false 为功能关闭

9 该功能默认为 true public void setclosednotification(boolean bool) 设置通知栏展示是否关闭设置关闭后已展示通知会被清除, 同时不不会再有新的通知 true 为通知栏关闭,false 为通知栏开启该功能默认为 false public void setnotificationstyle(int NotificationStyle) 设置通知栏整体主题颜色设置后通知栏样式会在下次刷新时改变 DapWeatherNotification.NOTIFICATIONSTYLE_DARK DapWeatherNotification.NOTIFICATIONSTYLE_WHITE 黑色主题白色主题通知栏监听设置 : 接口 : public void setnotificationclicklistener(weathernotificationlistener adlistener) WeatherNotificationListener adlistener 回调函数返回通知栏展示和点击事件 public interface WeatherNotificationListener { // 通知栏展示回调 public void onshow(int weathertype); // 通知栏点击回调 public void onclick(int weathertype); int weathertype 数值及其含义如下 : int weathertype 含义 1 当日天气通知展示 / 点击 2 升降温天气通知展示 / 点击 3 次日天气通知展示 / 点击

10 代码示例例 : mnotification.setnotificationclicklistener(new DapWeatherNotification.WeatherNotificationListener() public void onclick(int weathertype) { Log.e(TAG," 通知栏被点击了了 " + public void onshow(int weathertype) { Log.e(TAG," 通知栏展示了了 " + weathertype); );

DU Ad Platform_SDK 安卓接入指南 DU Ad Platform_SDK for Android 接入手册 ( 触发式广告 ) DUAd_SDK_Trigger v1.0 百度在线网络技术 ( 北京 ) 有限公司百度在线网络技术 ( 北京 ) 有限公司 - 1 -

DU Ad Platform_SDK 安卓接入指南 DU Ad Platform_SDK for Android 接入手册 ( 触发式广告 ) DUAd_SDK_Trigger v1.0 百度在线网络技术 ( 北京 ) 有限公司百度在线网络技术 ( 北京 ) 有限公司 - 1 - DU Ad Platform_SDK for Android 接入手册 ( 触发式广告 ) DUAd_SDK_Trigger v1.0-1 - 目录 1. 获取身份... 1 2. 加载与配置... 2 2.1 加载 SDK 文件... 2 2.2 配置 AndroidManifest.xml... 2 2.3 混淆代码... 3 3. 初始化... 4 4. 功能使用... 4 第 1 页共 1

DU Ad Platform_SDK for Android 接 入 手册 Version: DuWeatherSDK_1.1.6 前提 : DuWeather SDK 需要依赖 DU Ad Platform_SDK HW 或 CW ( 含 ) 以上版本 在接 入 DuW

DU Ad Platform_SDK for Android 接入手册 Version: DuWeatherSDK_1.1.6 前提 : DuWeather SDK 需要依赖 DU Ad Platform_SDK HW 或 CW ( 含 ) 以上版本在接入 DuW