iflyAd

来自于:科大讯飞立即使用

addBannerAd addInterstitialAd addNativeVideoAd addSplashVideoAd addRewardedVideoAd addPatchVideoAd removeAdView

概述

iflyAd 封装了讯飞广告sdk,通过此模块可展示讯飞下发的广告。

使用此模块之前建议先配置 config.xml 文件,配置完毕,需通过云端编译生效,配置方法如下:

Android配置meta-data

  • 配置示例:
  1. <meta-data
  2. name="IFLYTEK_APPKEY_AD"
  3. value="" />
  • 字段描述:

value:(必须配置)讯飞平台创建应用的appId

使用此模块之前 iOS 必须先配置 config 文件,配置方法如下:

  • 名称:iflyAd
  • 参数:appId
  • 配置示例:
  1. <feature name="iflyAd">
  2. <param name="appId" value="544e2b86" />
  3. </feature>
  • 字段描述:

    appId:讯飞平台创建应用的appId

iOS平台配置 plist 文件

  1. <key>NSAppTransportSecurity</key> <dict>
  2. <key>NSAllowsArbitraryLoads</key> <true/>
  3. </dict>

addBannerAd

添加Banner广告

addBannerAd({params}, callback(ret, err))

params

adIdAndroid:

  • 类型:字符串
  • 描述:android广告位id,讯飞平台为每个广告位分配的广告位id 在讯飞后台申请。

adIdIOS:

  • 类型:字符串
  • 描述:ios广告位id,讯飞平台为每个广告位分配的广告位id 在讯飞后台申请。

rect:

  • 类型:JSON对象
  • 描述:广告控件位置参数
  • 内部字段:
  1. {
  2. x:0, //数字类型;左上角X轴坐标 默认值:0
  3. y:0, //数字类型;左上角Y轴坐标 默认值:0
  4. width:300, //数字类型;banner的宽度 默认值:屏幕宽度
  5. height:200 //数字类型;banner的高度 默认值:50
  6. }

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(可选项)是否将模块视图固定到窗口上,不跟随窗口上下滚动
  • 默认值:true(不随之滚动)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;广告请求成功/失败
  3. id:1, //数字类型;广告控件id
  4. action:'', //字符串类型;取值‘recive’/成功获取广告、‘click’/广告被点击、 ‘close’/广告被关(iOS不支持)闭、‘exposure’/广告曝光(iOS不支持)、'cancle'/广告下载取消(iOS不支持)、‘submit’/广告下载确认(iOS不支持)
  5. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. errorCode:0 //数字类型;错误码,详情请参考讯飞广告文档
  3. msg:'' //错误信息
  4. }

示例代码

  1. var iflyAd= api.require('iflyAd');
  2. iflyAd.addBannerAd({
  3. adId:''
  4. rect:{},
  5. },function(ret, err) {
  6. });

可用性

Android系统,IOS系统

可提供的1.0.0及更高版本

addInterstitialAd

添加插屏广告,大开不可用removeAdView移除

addInterstitialAd({params}, callback(ret, err))

params

adIdAndroid:

  • 类型:字符串
  • 描述:android广告位id,讯飞平台为每个广告位分配的位以id 在讯飞后台申请。

adIdIOS:

  • 类型:字符串
  • 描述:ios广告位id,讯飞平台为每个广告位分配的位以id 在讯飞后台申请。

backClose:(iOS不支持)

  • 类型:布尔类型
  • 描述:(可选项)back健是否可以关闭
  • 默认值:true

fixedOn:(iOS不支持)

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

fixed:(iOS不支持)

  • 类型:布尔
  • 描述:(可选项)是否将模块视图固定到窗口上,不跟随窗口上下滚动
  • 默认值:true(不随之滚动)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;广告请求成功/失败
  3. action:'', //字符串类型;取值‘recive’/成功获取广告、‘click’/广告被点击、 ‘close’/广告被关闭(android不支持)、‘exposure’/广告曝光(iOS不支持)、'cancle'/广告下载取消(iOS不支持)、‘submit’/广告下载确认(iOS不支持)
  4. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. errorCode:0 //数字类型;错误码,详情请参考讯飞广告文档
  3. msg:'' //错误信息
  4. }

示例代码

  1. var iflyAd= api.require('iflyAd');
  2. iflyAd.addInterstitialAd({
  3. adId:'',
  4. rect:{},
  5. },function(ret, err) {
  6. });

可用性

Android系统,IOS系统

可提供的1.0.0及更高版本

addNativeVideoAd

添加信息流视频广告(可暂停,可全屏,可静音,不可跳过)

addNativeVideoAd({params}, callback(ret, err))

params

adIdAndroid:

  • 类型:字符串
  • 描述:android广告位id,讯飞平台为每个广告位分配的位以id 在讯飞后台申请。

adIdIOS:

  • 类型:字符串
  • 描述:ios广告位id,讯飞平台为每个广告位分配的位以id 在讯飞后台申请。

rect:

  • 类型:JSON对象
  • 描述:广告控件位置参数
  • 内部字段:
  1. {
  2. x:0, //数字类型;左上角X轴坐标 默认值:0
  3. y:0, //数字类型;左上角Y轴坐标 默认值:0
  4. width:300, //数字类型;banner的宽度 默认值:屏幕宽度
  5. height:200 //数字类型;banner的高度 默认值:100
  6. }

backClose:(iOS不支持)

  • 类型:布尔类型
  • 描述:(可选项)back健是否可以关闭
  • 默认值:true

playAuto:(iOS不支持)

  • 类型:布尔类型
  • 描述:(可选项)自动播放
  • 默认值:true

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(可选项)是否将模块视图固定到窗口上,不跟随窗口上下滚动
  • 默认值:true(不随之滚动)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;广告请求成功/失败
  3. id:1, //数字类型;广告控件id
  4. action:'', //字符串类型;取值‘recive’/成功获取广告、‘click’/广告被点击(iOS不支持)、'cancle'/广告下载取消(iOS不支持)、‘submit’/广告下载确认(iOS不支持)、‘startPlay’/缓冲完成开始播放、‘skip’/跳过广告(iOS不支持)、‘playError’/播放出错、'playComplete'/播放完毕、
  5. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. errorCode:0 //数字类型;错误码,详情请参考讯飞广告文档
  3. msg:'' //错误信息
  4. }

示例代码

  1. var iflyAd= api.require('iflyAd');
  2. iflyAd.addNativeVideoAd({
  3. adId:'',
  4. rect:{},
  5. },function(ret, err) {
  6. });

可用性

Android系统,IOS系统

可提供的1.0.0及更高版本

addSplashVideoAd

添加开屏视频广告(不可暂停,全屏,可静音,可跳过)

addSplashVideoAd({params}, callback(ret, err))

params

adIdAndroid:

  • 类型:字符串
  • 描述:android广告位id,讯飞平台为每个广告位分配的位以id 在讯飞后台申请。

adIdIOS:

  • 类型:字符串
  • 描述:ios广告位id,讯飞平台为每个广告位分配的位以id 在讯飞后台申请。

backClose:(iOS不支持)

  • 类型:布尔类型
  • 描述:(可选项)back健是否可以关闭
  • 默认值:true

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(可选项)是否将模块视图固定到窗口上,不跟随窗口上下滚动
  • 默认值:true(不随之滚动)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;广告请求成功/失败
  3. id:1, //数字类型;广告控件id
  4. action:'', //字符串类型;取值‘recive’/成功获取广告、‘click’/广告被点击(iOS不支持)、'cancle'/广告下载取消(iOS不支持)、‘submit’/广告下载确认(iOS不支持)、‘startPlay’/缓冲完成开始播放、‘skip’/跳过广告(iOS不支持)、‘playError’/播放出错、'playComplete'/播放完毕、
  5. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. errorCode:0 //数字类型;错误码,详情请参考讯飞广告文档
  3. msg:'' //错误信息
  4. }

示例代码

  1. var iflyAd= api.require('iflyAd');
  2. iflyAd.addSplashVideoAd({
  3. adId:'',
  4. rect:{},
  5. },function(ret, err) {
  6. });

可用性

Android系统,IOS系统

可提供的1.0.0及更高版本

addRewardedVideoAd

添加激励视频广告(不可暂停,全屏,可静音,不可跳过)

addRewardedVideoAd({params}, callback(ret, err))

params

adIdAndroid:

  • 类型:字符串
  • 描述:android广告位id,讯飞平台为每个广告位分配的位以id 在讯飞后台申请。

adIdIOS:

  • 类型:字符串
  • 描述:ios广告位id,讯飞平台为每个广告位分配的位以id 在讯飞后台申请。

backClose:(iOS不支持)

  • 类型:布尔类型
  • 描述:(可选项)back健是否可以关闭
  • 默认值:true

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(可选项)是否将模块视图固定到窗口上,不跟随窗口上下滚动
  • 默认值:true(不随之滚动)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;广告请求成功/失败
  3. id:1, //数字类型;广告控件id
  4. action:'', //字符串类型;取值‘recive’/成功获取广告、‘click’/广告被点击(iOS不支持)、'cancle'/广告下载取消(iOS不支持)、‘submit’/广告下载确认(iOS不支持)、‘startPlay’/缓冲完成开始播放、‘skip’/跳过广告(iOS不支持)、‘playError’/播放出错、'playComplete'/播放完毕、
  5. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. errorCode:0 //数字类型;错误码,详情请参考讯飞广告文档
  3. msg:'' //错误信息
  4. }

示例代码

  1. var iflyAd= api.require('iflyAd');
  2. iflyAd.addRewardedVideoAd({
  3. adId:'',
  4. rect:{},
  5. },function(ret, err) {
  6. });

可用性

Android系统,IOS系统

可提供的1.0.0及更高版本

addPatchVideoAd

添加贴片视频广告(不可暂停,全屏,可静音,可跳过)

addPatchVideoAd({params}, callback(ret, err))

params

adIdAndroid:

  • 类型:字符串
  • 描述:android广告位id,讯飞平台为每个广告位分配的位以id 在讯飞后台申请。

adIdIOS:

  • 类型:字符串
  • 描述:ios广告位id,讯飞平台为每个广告位分配的位以id 在讯飞后台申请。

backClose:

  • 类型:布尔类型
  • 描述:(可选项)back健是否可以关闭
  • 默认值:true

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(可选项)是否将模块视图固定到窗口上,不跟随窗口上下滚动
  • 默认值:true(不随之滚动)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;广告请求成功/失败
  3. id:1, //数字类型;广告控件id
  4. action:'', //字符串类型;取值‘recive’/成功获取广告、‘click’/广告被点击(iOS不支持)、'cancle'/广告下载取消、‘submit’/广告下载确认、‘startPlay’/缓冲完成开始播放、‘skip’/跳过广告、‘playError’/播放出错、'playComplete'/播放完毕、
  5. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. errorCode:0 //数字类型;错误码,详情请参考讯飞广告文档
  3. msg:'' //错误信息
  4. }

示例代码

  1. var iflyAd= api.require('iflyAd');
  2. iflyAd.addPatchVideoAd({
  3. adId:'',
  4. rect:{},
  5. },function(ret, err) {
  6. });

可用性

Android系统,IOS系统

可提供的1.0.0及更高版本

removeAdView

移除广告(iOS不支持插屏广告)

removeAdView({params}, callback(ret, err))

params

id:

  • 类型:数字类型
  • 描述:添加广告控件时返回的id

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;控件移除成功/失败
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'' //错误信息
  3. }

示例代码

  1. var iflyAd= api.require('iflyAd');
  2. iflyAd.removeAdView({
  3. id:0
  4. },function(ret, err) {
  5. });

可用性

Android系统,IOS系统

可提供的1.0.0及更高版本