隐私政策使用指导
不可见组件:应用首次启动时弹出隐私政策确认框,用户同意后记住选择、不再弹出;不同意可直接退出应用。
应用商店上架普遍要求「首次启动先征得隐私同意」,用这个组件一步完成。
快速上手
在 Screen1.Initialize 里调用一次显示(内容)(Show)即可——已经同意过的用户不会再看到弹窗:
各案例独立使用;组合到同一屏幕时,将同名事件的处理合并到一个事件积木中。
when Screen1.Initialize() {
隐私政策1.Show("https://example.com/privacy.html")
}
when 隐私政策1.OnAgreed() {
标签1.Text = "已同意,进入应用"
}
用户同意后触发同意时(OnAgreed);用户拒绝后触发拒绝时(OnRejected)并退出应用。
内容可以是网址、素材文件名(如 privacy.html)、本地文件路径、HTML 或纯文本,组件自动识别。
测试时想重新看到弹窗,调用一次复位(Reset)。
隐私政策页面应由应用开发者提供,内容应与应用实际收集、使用的数据保持一致。
搭建与测试
在设计器拖入本组件和案例涉及的按钮、标签、布局等组件,按案例中的名称重命名。先运行最小案例,确认事件返回,再增加业务逻辑。示例中的素材先上传到项目,服务器地址、令牌、文件路径换成自己的值。
可见组件需要有非零宽高;不可见工具组件必须由属性或方法启动。设计器展示样式不等于运行时已加载数据或绑定目标。联机测试应使用包含本组件的 AI 伴侣;涉及系统入口或权限的行为还要编译安装后验证。
案例:复位后测试本地内容
上传自己编写的 privacy.html;本案例用于重新测试确认流程,不要在每次启动时自动复位已保存的同意状态。
when 按钮_重新测试.Click() {
隐私政策1.Reset()
隐私政策1.Show("privacy.html")
}
when 隐私政策1.OnAgreed() {
标签1.Text = "用户已同意"
}
内容需与应用实际行为一致;同意后再启动需要同意的业务。素材、本地文件、网址和文本由 Show 自动识别。
属性、方法与事件速查
完整参数类型、默认值和平台说明见组件参考。下表按调用入口列出用途;有完成事件的方法在事件中读取结果。
| 入口 | 用途 |
|---|---|
是否已同意(HasAgreed) |
检查用户是否已经同意隐私政策。 |
复位(Reset) |
重置同意与拒绝状态:下次调用「显示」会重新弹出隐私政策。 |
重置隐私确认(编号)(ResetPrivacyConfirm) |
重置隐私确认框的显示状态 |
显示(内容)(Show) |
显示隐私政策弹窗。内容可以是网址、素材文件名(如 privacy.html)、本地文件路径、HTML 或纯文本,自动识别。已同意过则直接触发「同意时」,已拒绝过则直接触发「拒绝时」。 |
显示隐私确认对话框(编号,内容)(ShowPrivacyConfirmDialog) |
隐私确认弹窗。 |
同意时(OnAgreed) |
当用户同意隐私政策时触发。 |
隐私确认框关闭时(编号)(OnPrivacyConfirmClosed) |
当隐私确认框关闭时触发。 |
点隐私确认继续时(编号)(OnPrivacyConfirmContinue) |
当用户点击继续按钮时触发。 |
拒绝时(OnRejected) |
当用户拒绝隐私政策时触发。 |
常见问题与验收
| 检查项 | 操作与预期 |
|---|---|
| 初始化 | 对照案例检查是否已经调用加载、注册、连接或显示方法;仅拖入组件不会替你执行这些步骤。 |
| 结果返回 | 将成功事件和失败事件都接到标签,记录事件参数;异步操作完成前不读取结果属性。 |
| 输入配置 | 检查素材名大小写、网址是否为直接资源地址、文件是否存在、编号和索引是否在范围内。 |
| 平台与权限 | 按组件参考中的平台说明测试;授权被拒绝时应有明确提示,不继续假定操作成功。 |
| 最小案例 | 先验证页面中的最小案例,再验证第二个场景;重复操作、取消、返回屏幕后结果应符合事件说明。 |
完整 .aia 源码与操作指导
无需网络或账号,使用明确标为演示的本机政策文本。只有点击显示才打开弹窗;重置由独立按钮触发。此例演示同意状态和分项功能确认,不替代真实应用的政策内容。
导入 PrivacyPolicyAllFeatures.aia,连接最新伴侣,或编译独立安装包。真机/伴侣运行尚未实测。
| API / 功能 | 操作入口 | 预期结果 |
|---|---|---|
| Show / OnAgreed / OnRejected | 点显示,选择同意或拒绝 | 真实政策框及事件;再次显示按已记录状态处理 |
| HasAgreed | 点状态,重启应用再查 | 显示实际本机保存状态;拒绝时为假 |
| Reset | 点重置,再显示 | 重置同意与拒绝状态,能够重新体验两条分支 |
| ShowPrivacyConfirmDialog / OnPrivacyConfirmContinue / OnPrivacyConfirmClosed | 当前ID点功能确认、继续或关闭 | 展示真实ID事件;再次打开是否弹出按组件记录状态处理 |
| ResetPrivacyConfirm | 重置当前ID再显示 | 该功能确认可重新体验,不重置其他ID |
| 空输入与HTML | 清空内容/ID;或填自有HTML | 空输入不发起;HTML显示按组件规则处理 |
所有返回值均用于界面反馈,错误由底部错误区展示。设计器采用明确非默认配置,初始化与界面同步。API 覆盖检查按最终 AIA 检查方法、事件、属性读取与设置及设计器配置,不能替代真实设备验证。
隐私政策
导入方法:项目 → 导入项目(.aia)→ 选择下载的 .aia 源码文件。 无需网络或账号,使用明确标为演示的本机政策文本。只有点击显示才打开弹窗;重置由独立按钮触发。此例演示同意状态和分项功能确认,不替代真实应用的政策内容。 覆盖检查 9/9。首次载入及保存重开均0个错误,真实后台导入、安装包编译通过;真机/伴侣/硬件联调尚未实测。全部属性读写、方法与事件的操作入口和预期结果见组件指导。
扫码添加客服咨询