软件系统升级设计说明书.doc

1、 百度联盟移动应用推广 SDK 3.01百度联盟移动应用推广 SDK用户手册 (Android 版) 3.0百度在线网络技术（北京）有限公司（版权所有,翻版必究） 百度联盟移动应用推广 SDK 3.02目录一、 简介 .3二、 运行环境 .3三、 SDK 包导入及权限配置 .31. 申请应用的 APPSID 和计费名 .32. 导入 JAR 包 .33. 配置 AndroidManifest.xml.3四、 广告视图 .41. 横幅 Banner 广告 .42. 插屏广告 .53. 轮盘广告 .64. 开屏广告 .65. 推广墙 .96. 视频广告 .10五、 代码混淆 .11六、 联系我们

2、.12附件 1：申请 APP ID .13百度联盟移动应用推广 SDK 3.03一、 简介百度移动推广 SDK(Android)是百度官方推出的移动推广 SDK 在 Android 平台上的版本（以下简称 SDK） 。SDK 的发行版本（完整下载包为 Baidu_MobAds_SDK.zip）中包括 JAR 包、javadoc 文档、示例以及您正在阅读的用户手册。 以下使用代表 Baidu_MobAds_SDK.zip 解压后的根目录。 JAR 包：/Baidu_MobAds_SDK.jar，开发时导入工程中； 文档：/Baidu_MobAds_SDK_Doc，提供 javadoc 帮助信息；

3、 示例：/Baidu_MobAds_SDK_Demo，多个示例程序代码，帮助您迅速熟悉 SDK 的使用方式； 用户手册：本文档。二、 运行环境可运行于 Android 2.2（API Level 8）及以上版本。三、 SDK 包导入及权限配置1. 申请应用的 APPSID 和计费名登录百度联盟网站后进行申请，您获取的 APP ID 适用于文档中的“BaiduMobAd_APP_ID”详见 附 件 1 。2. 导入 JAR 包将百度推广的 jar 包复制到您工程的 Libs 目录下，并按如下步骤将其导入： 右键点击你的工程，然后选择“Properties”； 在工程属性对话框左边选择“Java

4、Build Path”； 在工程属性对话框主窗口选择“Libraries”； 点击“Add JARs”，添加百度推广 jar 包。3. 配置 AndroidManifest.xml 添加 APPID下文中的BaiduMobAd_APP_ID内容中填写您的：APP ID.或使用代码设置 AdView.setAppSid(context, “e866cfb0”);/第二个参数需改为您的APPID代码设置与配置文件设置是等价的，您只需要在一个地方设置即可。特注：（1）meta-data标签一定要在 application标签下；（2）将APPSid设置成百度联盟网站上获取的APP ID，即可广告调试

5、，并且开始为您的APP 计费；（ 3）只有您提交的应用通过审核后，才会获得有效的APP ID。 添加AppActivity申明百度联盟移动应用推广 SDK 3.04 添加权限另外，一些额外的权限可以让您应用获得更精准的广告投放，一份完整的权限配置范例如下：四、 广告视图百度推广 SDK 支持横幅广告、插屏广告、开屏广告、视频广告、轮盘广告等多种广告形式。详细嵌入步骤如下:百度联盟移动应用推广 SDK 3.051. 横幅 Banner 广告在Activity的onCreate函数中：详见 Demo 项目中的 BannerAdActivity 类 注：若您需要使用 AdViewListener 监

6、听器，需要注意 onAdReady 函数回调时是广告资源已经缓存完毕，但是此刻广告还没有渲染出来，若需要根据广告请求状态，对广告视图可见性做切换时，可使用 onAdShow 函数。2. 插屏广告插屏广告的调用流程与 Banner 广告不同。插屏广告需要提前预加载广告 (调用 loadAd 函数)；在需要展示的RelativeLayout your_original_layout = new RelativeLayout(this);setContentView(your_original_layout);/人群属性AdSettings.setKey(new String“baidu”,”中国”

7、);/创建广告viewString adPlaceID = “Your_adPlaceId“;/重要：请填上你的广告位IDadView = new AdView(this,adPlaceId);/设置监听器adView.setListener(new AdViewListener()/将adView添加到父控件中（注：该父控件不一定为您的根控件，只要该控件能通过addView添加广告视图即可）RelativeLayout.LayoutParams rllp = new RelativeLayout.LayoutParams();Rllp.addRule(RelativeLayout.ALIGN

8、_PARENT_BOTTOM)your_original_layout.addView(addView,rllp);setContentView(R.layout.interstitialad);String adPlaceId = “Your_adPlaceId“;/重要：请填上您的广告位IDinterAd=new InterstitialAd(this, adPlaceId);interAd.setListener(new InterstitialAdListener();interAd.loadAd();Button btn=(Button)this.findViewById(R.id.

9、btn_interstitial);btn.setOnClickListener(new OnClickListener()Overridepublic void onClick(View arg0) if(interAd.isAdReady()interAd.showAd(InterstitialAdActivity.this);elseinterAd.loadAd(););百度联盟移动应用推广 SDK 3.06时候，可以调用 showAd 函数来显示插屏广告。示例如下：详见Demo项目中的InterstitialAdActivity类注：在“多次展示”插屏广告的场景中，为了让广告及时展现，

10、推荐在InterstitialAdListener监听器的onAdDismissed方法中额外调用一次 interAd.loadAd();视频前贴片插屏广告视频前贴片出现在视频播放之前，有5s倒计时，倒计时结束广告自动关闭。AdSize对应InterstitialForVideoBeforePlay。视频暂停插屏广告视频暂停贴片出现在视频播放暂停时，可以自定义大小，没有倒计时功能。AdSize对应InterstitialForVideoPausePlay。这两种广告形式创建插屏对象使用InterstitialAd(Context context, AdSize adSize, String p

11、ositionId)，加载广告使用loadAdForVideoApp(int width, int height)，展示广告使用showAdInParentForVideoApp(Activity activity, RelativeLayout parent)。广告关闭会回调接口onAdDismissed()。注：广告请求参数width和height以及显示广告时传入的 parent宽高大小要合理，不能过小。3. 轮盘广告转盘广告为在您的 activity 页面显示一个转盘浮标；用户点击后，可展开为一个轮盘形式，其中直接列出了多个下载类广告。使用方式如下：详见Demo中的IconsAdAct

12、ivity类。注：轮盘会在您的activity 销毁时自动销毁，故不必担心内存泄漏问题。4. 开屏广告开屏广告在您的应用启动时使用，嵌入在您的应用启动页 Activity 中，此类广告展现开始 5s 后自动关闭。开屏分为实时开屏和缓存开屏。实时开屏是成功请求到广告后立即展现，默认可点击；缓存开屏是成功请求到广告后缓存下来，在下次打开应用时再展现，默认不可点击。另外，可通过构造函数来设置是否接受点击类型的广告。构造函数如下：SplashAd(Context context, ViewGroup viewParent, SplashAdListener rlistener, String posi

13、tionId, boolean canClick, SplashType splashType);其中，枚举类型：SplashType.CACHE 表示缓存开屏； SplashType.REAL_TIME 表示实时开屏。其中，canClick 参数表示是否接受点击类型的广告， 若该参数设置为 true，广告填充率会更高。创建缓存开屏时，splashType 需指定为 SplashType.CACHE，positionId 当前填空即可。创建实时开屏时，splashType 需指定为 SplashType. REAL_TIME，positionId 当前填空即可。RelativeLayout r

14、lMain=new RelativeLayout(this);setContentView(rlMain);String adPlaceId = “Your_adPlaceId“;/重要：请填上您的广告位IDIconsAd iconsAd=new IconsAd(this, adPlaceId, new intR.drawable.music, R.drawable.music_close );iconsAd.loadAd(this);百度联盟移动应用推广 SDK 3.07缓存开屏使用方式如下：Overrideprotected void onCreate(Bundle savedInstan

15、ceState) super.onCreate(savedInstanceState);setContentView(R.layout.splash);RelativeLayout adsParent = (RelativeLayout) this.findViewById(R.id.adsRl);SplashAdListener listener=new SplashAdListener() Overridepublic void onAdDismissed() Log.i(“CSplashActivity“, “onAdDismissed“);jumpWhenCanClick();/ 跳转

16、至您的应用主界面Overridepublic void onAdFailed(String arg0) Log.i(“CSplashActivity“, “onAdFailed“);jump();Overridepublic void onAdClick() Log.i(“SplashActivity“, “onAdClick“);/设置开屏可接受点击时，该回调可用;String adPlaceId = “Your_adPlaceId“;/重要：请填上您的广告位IDnew SplashAd(this, adsParent, listener, adPlaceId, true, SplashTy

17、pe.CACHE);百度联盟移动应用推广 SDK 3.08实时开屏使用方式如下：Overrideprotected void onCreate(Bundle savedInstanceState) super.onCreate(savedInstanceState);setContentView(R.layout.splash);RelativeLayout adsParent = (RelativeLayout) this.findViewById(R.id.adsRl);SplashAdListener listener=new SplashAdListener() Overridepub

18、lic void onAdDismissed() Log.i(“RSplashActivity“, “onAdDismissed“);jumpWhenCanClick();/ 跳转至您的应用主界面Overridepublic void onAdFailed(String arg0) Log.i(“RSplashActivity“, “onAdFailed“);jump();Overridepublic void onAdPresent() Log.i(“RSplashActivity“, “onAdPresent“);Overridepublic void onAdClick() Log.i(

19、“RSplashActivity“, “onAdClick“);/设置开屏可接受点击时，该回调可用;/* 构造函数：* new SplashAd(Context context, ViewGroup adsParent,* SplashAdListener listener,String adPlaceId, boolean canClick, SplashType splashType);*/String adPlaceId = “Your_adPlaceId“;/重要：请填上您的广告位IDnew SplashAd(this, adsParent, listener, adPlaceId,

20、true, SplashType.REAL_TIME);百度联盟移动应用推广 SDK 3.095. 推广墙创建推广墙对象需传入入口图片，用户点击该图片后，进入推广墙页面。当前广告位 id 可以为空。public class RecommendAdActivity extends ActivityRecommendAd recommendAd;Overrideprotected void onCreate(Bundle savedInstanceState) super.onCreate(savedInstanceState);setContentView(R.layout.recommend_

21、layout);ImageView iconToBind = (ImageView)this.findViewById(R.id.iv_icon1);String adPlaceId = “Your_adPlaceId“;/重要：请填上您的广告位IDRecommendAd.Builder builder = new RecommendAd.Builder(iconToBind, adPlaceId);builder.setEventListener(new RecmdEventListener()Overridepublic void onIconBindFailed(String reaso

22、n) Log.i(“RecommendAd-DEMO “, “onIconBindFailed: “ + reason);Overridepublic void onIconShow() Log.i(“RecommendAd-DEMO “, “onIconShow“););recommendAd = builder.build();recommendAd.load(this);Overrideprotected void onDestroy() recommendAd.destroy();super.onDestroy();百度联盟移动应用推广 SDK 3.0106. 视频广告视频广告可设置视

23、频的宽高比、视频时长以及是否显示倒计时，视频是实时加载，所以播放视频前需要先缓存几秒钟，使用时先将 VideoAdView 加载到屏幕上，然后调用 requestAd 加载视频广告，视频准备好后会回调onVideoPrepared，这时可以调用 startVideo 立即播放视频或者等待合适时机再播放。public class VideoAdActivity extends Activity private static final String TAG = VideoAdActivity.class.getSimpleName();private VideoAdView videoAdVie

24、w;private Button button;Overridepublic void onCreate(Bundle savedInstanceState) super.onCreate(savedInstanceState);/ 此处设置可防止出现视频第一次播放前屏幕闪一下的问题getWindow().setFormat(PixelFormat.TRANSLUCENT);setContentView(R.layout.video);/ 广告位id，在http:/ adPlaceId = “Your_adPlaceId“;videoAdView = new VideoAdView(this, adPlaceId);videoAdView.setListener(new VideoAdViewListener() Overridepublic void onVideoStart() Log.w(TAG, “onVideoStart“);Overridepublic void onVideoPrepared() Log.w(TAG, “onVideoPrepared“);videoAdView.startVideo();Overridepublic void onVideoFinish() Log.w(TAG, “onVideoFinish“);