找回密码
 立即注册
搜索

快应用开发常见问题汇总 - oppo

0
回复
469
查看
[复制链接]

1

主题

17

帖子

90

积分

 楼主| 2023-7-10 17:31:37 显示全部楼层 |阅读模式

本帖记录OPPO侧快应用开发常见问题,不定期更新,欢迎阅读


快应用广告

    OPPO快应用广告开发文档 

    

    Q. 使用广告接口时报错:

"errCode\":2000,\"errMsg\".\" the preview release does not support ad-related features, please use the corresponding vendor quick-app engine"

    A. 请使用OPPO引擎调试广告,详见 区分联盟预览版和OPPO内置引擎 , 并保证快应用已经上线。

    

    Q. 广告1003报错排查:

    A. 1003 无广告返回:

        1. 检查是否为OPPO手机,须使用OPPO手机

        2. 可降低请求频率,间隔10s查看是否正常返回广告

        3. 检查是否所有类型广告都返回1003,可联系商务处理

       4. 【建议】使用广告预览功能(路径:广告联盟-工具中心-广告预览),将手机IMEI号与广告位ID绑定生成预览信息,再进行广告测试

    

    Q. 原生广告信息流2.0,点击广告,只有第一次触发了onadclick事件,再次点击无效,这是为什么?

    A. 这是广告产品逻辑,adclick 目前是第一次才触发,因为开发者通常是按照回调计算扣费,一个广告重复点击实际只扣费一次。

    

    Q. 原生信息流2.0广告经常报inter error request,detail:,rawError=[1035]?

    A. 广告服务端的限制,设备级别的频控,建议降低请求广告次数,或者多准备几台手机调试。

        

    Q. 广告点击事件只回调了一次,后续点击不生效:

    A. 非bug,正常广告逻辑。

    

    Q.  【激励视频广告】是否支持在当条视频播放未结束时,提前加载下一条视频广告?

    A. 不支持。需要上一条视频回调了close事件,才能加载下一条视频广告。

    

    Q. 【激励视频广告】如何获知用户是否已经获取奖励?

    A. 在OPPO6.9版本引擎,对应联盟版本 1117 ,激励视频广告onClose() 事件的 isEnded 参数即表示用户是否领取了奖励。

        

组件

    Q. OPPO侧是否已经支持小说组件?

    A. OPPO引擎6.6版本,对应联盟版本 1114 开始支持。

        

    Q. 【加桌组件】加桌成功后为什么会触发app和页面的onShow生命周期?

    A. 正常系统逻辑。在加桌成功后系统添加桌面图标期间,快应用生命周期会出现暂停,此时就会调用onHide周期,图标添加完成后,快应用状态重新恢复,调用onShow生命周期,请开发者自行适配。

    

接口

    Q. 如何获取跳转快应用时携带的参数?

    A. 通过router.push携带在params字段上的参数,或者deeplink链接携带的的参数,均可以在在目标页面中在   public (应用外传参)或 protected (应用内传参)下定义 key 名相同的属性实现获取。

    

    Q. 在快应用页面运行的情况下,再次跳转该页面,携带的参数没有更新

    A. 需要在 onRefresh 生命周期里重新获取新的携带参数。详见文档 onRefresh()  介绍。    

    

    Q. 【account 账号】调用 account.authorize() 报错 "code = 2020003, errMsg=Invalid client"

    A. 需要先开通账号服务。详见文档 OPPO快应用帐号服务开启指南

    

    Q. 如何获取设备安卓版本号?

    A.  device.getInfo()  接口。

    osVersionName:获取系统版本字符串。如11,12等;

    osVersionCode:对应关系参考android官方 SDK_INT。

    

    Q. 如何获取用户的openId?

    A.  account.authorize()  接口。

    调用时不传scope,即可实现对openid的静默获取。使用该接口的前提是需要开通账号服务。参考文档:https://open.oppomobile.com/new/developmentDoc/info?id=12398

    

    Q. 快应用如何拉起原生应用?

    A. router.push 接口, uri 参数的格式为 "app:" + app包名

    

    Q. 如何拉起默认浏览器打开某个链接?

    A. router.push 接口, uri 参数的格式为 ''heytapbrowser://webpage/view?url=" + encode之后的链接。

    

    Q. system.file、system.storage 接口写入文件是否有大小限制

    A. system.file、system.storage 接口写入文件均无大小限制

    

    Q. system.file、system.storage 接口写入的文件,清缓存后都会被删除吗

    A. 会。ystem.file写文件只能写到internal:// 下,internal 都是跟应用绑定的路径,一旦快应用清除缓存,对应的路径都会被删除掉

    

框架配置

    Q. 调用 this.$page.setSecure(true) 不生效,仍可截屏和录屏

    A. OPPO 暂不至此此特性。

    

    Q. 如何自行适配暗色模式?

    A. 在manifest文件中配置 themeMode 为 -1(跟随系统主题模式),在页面中通过 onConfigurationChanged(1060+) 生命周期监听系统主题模式的变化,从而在代码逻辑中去适配不同颜色的方案即可。若想取消部分组件的自动返色,设置组件上的 forceDark="f

alse" 即可。

    Q. 如何让页面滚动指定长度的px

    A. 若需要页面滚动指定长度的px,即 this.$page.scrollBy() , top 传入 「需滚动长度的px」 * (screenWidth/designWidth)

    Q. 如何让页面滚动指定长度的px

    A. 若需要页面滚动指定长度的px,即 this.$page.scrollBy() , top 传入 「需滚动长度的px」 * (screenWidth/designWidth)

    

    Q. onPageScroll 生命周期返回的 scrollTop 不准确?

    A. 并非不准确,而是scrollTop的值,根据 screenWidth/designWidth 进行了缩放。

    

其他

    Q. 新版快应用卡片调试工具:

    A. 支持在负一屏的卡片中心添加卡片,欢迎使用:https://open.oppomobile.com/new/developmentDoc/info?id=12287    

回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册