AVM3.0重要更新:隐私政策提示框的快捷实现

发布时间:2022-07-13 16:23

根据工信部要求,应用需要向用户展示采集用户数据的隐私政策说明,对于该政策,应用一般的做法是在首页加载之前弹出隐私政策提示框,用户同意隐私政策协议后再进入首页,在用户同意之前不进行用户数据采集操作。 为方便开发者快速实现这一逻辑,引擎新增了privacyPromptMode 配置项。


更新内容: config.xml 新增了 privacyPromptMode  配置项:


取值范围:

none       // 不使用隐私政策弹框

custom      // 自定义隐私政策弹框


默认值:none

描述:若配置为 custom,表示应用添加了隐私政策弹框,应用在第一次启动时引擎会查找 widget/pages/privacy/privacy.stml 文件是否存在,若存在则会先显示该页面,开发者可在该页面实现自定义的隐私弹框,此时一些操作如版本和云修复检测、模块初始化等会被延后;若 privacy.stml 文件不存在,则会正常加载首页,引擎会认为开发者在首页实现了隐私政策弹框,此时版本和云修复检测会被延后。等用户同意隐私政策后,前端需调用 api.agreedPrivacy 方法,通知引擎用户已同意隐私政策,引擎会记录状态并执行之前延后的操作。

配置示例:

<preference name="privacyPromptMode" value="custom"/>


实施指南:


一、配置支持隐私政策提示框

首先需要在 config.xml 里面配置 privacyPromptMode 字段为 custom,配置示例:

<preference name="privacyPromptMode" value="custom"/>


提示:  config.xml 配置后,须先提交代码,再重新编译loader,或测试版、正式版。



二、实现隐私政策提示框

1、在首页加载之前弹出

想要在首页加载之前显示隐私政策提示框,需创建一个 privacy.stml 文件放置在项目 pages/privacy 目录下,在该页面内自定义实现隐私政策提示框,引擎会在应用启动时去加载和显示该页面,用户同意隐私政策协议后方能进入首页,在用户同意协议之前,一些操作如版本和云修复检测、模块初始化等都会被延后。

在附件下载 “隐私弹框示例 stml 页面”,stml 页面语法可参考stml 页面介绍。

2、在首页加载之后弹出

当应用启动时若检测到 privacy.stml 文件不存在,则会正常加载首页,前端可在首页弹出隐私政策提示框,在用户同意隐私政策协议之前版本和云修复检测会被延后。


三、同意隐私政策协议

在用户同意隐私协议之后,前端需调用 api.agreedPrivacy 方法,通知引擎用户已同意隐私政策,引擎会记录状态并执行之前延后的操作,如果首页还未加载则将会进入首页。


官方原帖子:https://developer.yonyou.com/thread-212907-1-1.html