讯飞移动广告平台Android SDK接入指南

科大讯飞股份有限公司iFLYTEKCO.,LTD讯飞移动广告平台AndroidSDK接入指南讯飞移动广告平台http://www.voiceads.Grf中国最大的移动交互式广告平台。平台凭借优质的广告资源、精准的数据分析、高效稳定的收益效果、智能多维的交互形式，为开发者带来强悍稳定的变现能力，致力于构建一个高质、高效的广告技术服务平台。讯飞移动广告平台聚焦移动广告聚合优化，通过先进的收入优化算法和简单易用的管理界面，帮助开发者快速实现应用变现，大幅提高移动广告收入。独创的智能语音交互广告，打破了传统广告交互形式，让广告变得更生动有趣，从而带来极致的广告体验和最高效的广告收益。概述欢迎使用讯飞移动广告平台。通过本文档，您可以在几分钟之内轻松完成移动广告的集成过程。集成过1.0~1.6版本SDK的开发者朋友，请先阅读SDK2.0集成注意事项，方便您快速集成。集成说明2.1申请appid在/l网站中注册成为开发者并创建一款应用，您将获得一个appid，用于标识您的应用。2.2导入SDK下载最新版SDK的zip包，将其中的libs文件夹下jar文件复制到本地工程libs子目录下。Eclipse用户右键点击工程根目录，选择Properties->JavaBuildPath->Libraries，然后点击AddExternalJARs...选择指向jar的路径，点击OK，即导入成功。2.3配置AndroidManifest文件打开AndroidManifest.xml文件，增加如下权限:权限用途INTERNET允许程序联网和发送统计数据的权限ACCESS_NETWORK_STATE允许应用检测网络连接状态READ_PHONE_STATE允许应用以只读的方式访问手机设备的信息，通过获取的信息来唯一标识用户ACCESS_WIFI_STATE允许程序访问Wi-Fi网络状态信息WRITE_EXTERNAL_STORAGE写sd卡的权限，用于缓存广告所用到的图片，节省流量，并可获得更好的用户体验READ_EXTERNAL_STORAGE读sd卡的权限，意义同WRITE_EXTERNAL_STORAGEACCESS_FINE_LOCATION获取设备的上传数据时的位置信息，提高统计精准度GET_TASKS获取当前应用的运行信息WAKE_LOCK唤醒手机，保证广告正常下载meta-data用途IFLYTEK_APPKEY_AD用来唯一标识您的应用，请将以下示例代码中your_appid替换为您在讯飞移动广告平台申请的应用appido代码示例:

<manifest......><application......><activity....../><!--请注意添加单引号--><meta-dataandroid:name="IFLYTEK_APPKEY_AD"android:value="'your_appid'"/></application>androidandroidandroidandroidandroidandroidandroidandroidandroidandroidandroidandroidname="android.permission.INTERNET"/>name="android.permission.READ_PHONE_STATE"/>name="android.permission.ACCESS_NETWORK_STATE"/>name="android.permission.ACCESS_WIFI_STATE"/>name="android.permission.WRITE_EXTERNAL_STORAGE"/>name="android.permission.READ_EXTERNAL_STORAGE"/>name="android.permission.ACCESS_FINE_LOCATION"/>name="android.permission.GET_TASKS"/>name="android.permission.WAKE_LOCK"/><uses-permission<uses-permission<uses-permission<uses-permission<uses-permission<uses-permission<uses-permission<uses-permission</manifest>2.4组件声明<manifest......><application......><serviceandroid:name="com.iflytek.voiceads.update.DownloadService"/></application></manifest>2.5添加旗帜广告旗帜广告，即Banner广告，可以将该广告视图放于任何可以容纳的位置（容纳的容器或位置必须在屏幕内并且尺寸等于或大于广告视图，推荐放在界面的顶部或底部）。旗帜广告具备轮播功能，默认15秒轮播一次。为了提高应用体验效果，开发者可以为放置广告的Layout自定义背景色或背景图片。〃创建旗帜广告：adId：开发者在广告平台(/)申请的广告位IDIFLYBannerAdbannerAd=IFLYBannerAd.createBannerAd(Activity.this,adId);//设置广告尺寸bannerAd.setAdSize(IFLYAdSize.BANNER);〃设置为调试模式bannerAd.setParameter(AdKeys.OEBUQMOOE,"true");〃下载广告前，弹窗提示bannerAd.setParameter(AdKeys.00如NLOA七ALERT,"true");〃请求广告，添加监听器bannerAd.loadAd(mAdListener);LinearLayoutlayout_ads=(LinearLayout)findViewById(R.id.tayou^adview);layout_ads.removeAllViews();layout_ads.addView(bannerAd);IFLYAdListenermAdListener=newIFLYAdListener(){^OverridepublicvoidonAdReceive(){〃成功接收广告，调用广告展示接口。注意：该接口在回调中才能生效bannerAd.showAd();}@OverridepublicvoidonAdFailed(AdErrorerror){//广告请求失败//error.getErrorCode():错误码，error.getErrorDescription():错误描述}^OverridepublicvoidonAdClick(){//广告被点击}^OverridepublicvoidonAdClose(){//广告被关闭}};2.6添加插屏广告插屏广告，是一种开发者可以在界面过场时请求并根据需要进行展示的间质性广告形式。用户通过点击插屏广告右上角的叉号图片，将广告取消。目前，插屏广告不支持横屏模式。〃创建插屏广告：adId：开发者在广告平台(/)申请的广告位IDIFLYInterstitialAdinterstitialAd=IFLYInterstitialAd.createInterstitialAd(Activity.this,adId);//设置广告尺寸interstitialAd.setAdSize(IFLYAdSize.INTERSTITIAL);〃点击手机后退键，是否销毁广告："true":销毁，"false":不销毁，默认销毁interstitialAd.setParameter(AdKeys.BAC史KE七ENABLE,"true");//添加监听器，请求广告interstitialAd.loadAd(mAdListener);IFLYAdListenermAdListener=newIFLYAdListener(){^OverridepublicvoidonAdReceive(){〃成功接收广告，调用广告展示接口。注意：该接口在回调中才能生效interstitialAd.showAd();}@OverridepublicvoidonAdFailed(AdErrorerror){//广告请求失败//error.getErrorCode():错误码，error.getErrorDescription():错误描述}^OverridepublicvoidonAdClick(){//广告被点击}^OverridepublicvoidonAdClose(){//关闭广告}};2.7添加全屏广告全屏广告，一种覆盖整个屏幕进行广告展示的广告类型。广告展示一定时间后退出展示，展示时间可设置。全屏广告的全屏显示可以通过移除标题栏和状态栏实现，代码参考Demo。〃创建全屏广告：adId：开发者在广告平台(/)申请的广告位IDIFLYFullScreenAdfullScreenAd=IFLYFullScreenAd.createFullScreenAd(Activity.this,adId);//设置广告尺寸fullScreenAd.setAdSize(IFLYAdSize.FULLSCREEN);〃设置全屏广告展示时间，单位为ms。默认广告展示5000ms后消失fullScreenAd.setParameter(AdKeys.SHO^_n^E_FULLSCREEN,"6000");//添加监听器，请求广告fullScreenAd.loadAd(mAdListener);IFLYAdListenermAdListener=newIFLYAdListener(){^OverridepublicvoidonAdReceive(){〃成功接收广告，调用广告展示接口。注意：该接口在回调中才能生效fullScreenAd.showAd();}@OverridepublicvoidonAdFailed(AdErrorerror){//广告请求失败//error.getErrorCode():错误码，error.getErrorDescription():错误描述}^OverridepublicvoidonAdClick(){//广告被点击}^OverridepublicvoidonAdClose(){//关闭广告2.8接口说明2.8.1错误码列举了广告请求失败的错误原因，在onAdFailed(AdErrorer中返回。错误码描述70200广告请求成功70204请求成功，但是无广告内容70400无效的广告位ID70403当日广告请求次数达到上限70500服务错误71001未知错误

71002无效的广告请求，比如：请求频率过快71003网络错误71004Permission未设置71005Appid为空71006无效的Appid71007广告位ID为空71008广告页面加载超时71009广告页面加载异常71010手机无浏览器2.8.2广告尺寸IFLYAdSize表示请求的广告尺寸，具有width和height两个属性，单位为dip。须使用SDK提供的尺寸类型：IFLYAdSize.BANNER,IFLYAdSize.INTERSTITIAL,IFYAdSize.FULLSCREEN。2.8.3对外接口（1）publicvoidsetAdSize（IFLYAdSizeadSize）设置要请求的广告大小（在第一次请求广告前设置）。（2）publicvoidsetParameter（Stringkey,Stringvalue）广告参数设置，请参考2.8.4。（3）publicvoidloadAd（IFLYAdListenerlistener）请求广告。（4）publicvoidshowAd（）展示广告。2.8.4广告可设置参数参数说明适用范围APPID广告应用ID旗帜、插屏、全屏DEBUG_MODE设置是否调试模式，调试模式下可查看log，默认调试模式旗帜、插屏、全屏BACK_KEY_ENABLE点击手机后退键是否销毁插屏广告，默认销毁广告插屏SHOW_TIME_FULLSCREEN全屏广告展示时间，范围5000〜10000，默认5000；如果设为-1，则使用叉号方式退出全屏广告全屏DOWNLOAD_ALERT弹出下载广告提示框，默认不弹提示框旗帜、插屏、全屏使用示例：bannerAd.setParameter(AdKeys.APPID,"544e2c99");bannerAd.setParameter(AdKeys.DEBUG_MODE,"true");interstitialAd.setParameter(AdKeys.BACK_KEY_ENABLE,"true");fullScreenAd.setParameter(AdKeys.SHOW_TIME_FULLSCREEN,"6000");bannerAd.setParameter(AdKeys.DOWNLOAD_ALERT,"true");2.8.5事件监听添加广告时，可以通过一些监听事件接收广告当前状态。广告监听事件类IFLYAdListener定义的具体事件函数如下表：监听事件事件描述onAdReceive广告请求成功onAdFailed广告请求失败，同时返回错误码及描述onAdClick广告被点击onAdClose广告被关闭混淆代码工程混淆设置：如需打包或者生成APK的时候进行混淆，在proguard.cfg中添加如下代码:-keepclasscom.iflytek.voiceads.**｛七｝常见问题Q:adUnitId是什么？A:adUnitId，即广告位ID，是讯飞移动广告平台为每个广告位分配的唯一标识符。Q:可以自己设置广告的请求地址吗？A:请求地址封装于SDK内部，不允许用户自行设置。Q:SDK都支持哪些android版本？A:要求采用android2.3或更高版本。Q:如何查看广告SDK版本？A:利用Version.getVersion(可获得广告SDK版本号。SDK2.0集成注意事项AndroidManifest.xml中请勿漏写权限声明，请参考2.3。AndroidManifest.xml中需添加DownloadService，请参考2.4。新增设置选项，请参考2.8.4：广告下载前，可以设置弹出下载提示框，旗帜、插屏、全屏广告设置方式相同。如：bannerAd.setParameter(AdKeys.DOWNLOAD_ALERT,"true");全屏广告展示时间设置，有效设置范围为5000~10000和-1。设为-1时，通过点击全屏广告右上角的叉号控件退出广告。如：fullScreenAd.setParameter(AdKeys.SHOW_TIME_FULLSCREEN,"6000");主流合作媒体WiFi万能钥匙WiFi万能钥匙是最好用的智能手机免费WiFi管理工具，云端数据库内置千万Wi-Fi热点数据包括中国电信百万ChinaNet热点数据，帮你随时随地免费连上附近WiFi热点，轻轻松松免费上网社交聊天、学习、购物、看电影、看视频、看新闻资讯、看美图、看搞笑段子、玩游戏、听音乐、看漫画、找女朋友！WiFi万能钥匙——连接免费WiFi的上网神器，扫除无网断网状态，提高移动办公效率，尤其适合学生、商务、移动人群和重度网虫。懒人听书懒人听书是国内最受欢迎的有声阅读应用，通过两年的发展目前已积累上亿用户，是国内使用人数最多的移动互联网音频类产品。懒人听书有声正版阅读资源丰富，每天不断录制更新，内容适用于不同年龄人群的手机用户使用，老人、白领、学生、儿童都可以在懒人听书上找到自己喜欢的资源。快手看片快手看片是下载量第一的聚合视频软件，免费高清在线播放，万部电影，18种分类：电视剧，电影，综艺，动漫，纪实，微电影，轻视频，韩剧，欧美频道，浪漫爱情，动作战争，热点精选，新闻，咨询，音乐，搞笑，体育一网打尽。完整收录了优酷、土豆、腾讯视频、搜狐视频、新浪、酷六、奇艺、乐视、芒果卫视、56、CNTV、PPTV等各大视频网络内容。好豆菜谱好豆菜谱是中国美食大全，提供多种菜系的做法，以及针对不同人群的食谱，是下厨房必备的美食菜谱软件。好豆菜谱拥有中国最全的优质菜谱数据40多万道，包含人群分类和疾病调理的药膳食疗，提供各种健康饮食指导建议。爱生活，爱美食，爱做菜，爱下厨，使用好豆菜谱，开启幸福生活！微信锁微信锁是一款微信隐私卫士，专注锁定微信社交隐私空间，对微信信息安全实现前“锁”未有的加密保护。微信锁（微信伴侣），即使在亲朋好友、同事把玩你手机，也可以很好的伪装，不用担心会泄露你的微信聊天记录、朋友圈、微信支付及红包隐私信息。围棋宝典围棋宝典含大量精解专辑