隐私政策使用指导

← 返回隐私政策组件参考 · 全部使用指导

隐私政策使用指导

不可见组件:应用首次启动时弹出隐私政策确认框,用户同意后记住选择、不再弹出;不同意可直接退出应用。

应用商店上架普遍要求「首次启动先征得隐私同意」,用这个组件一步完成。

快速上手

在 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 源码与操作指导

下载 .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个错误,真实后台导入、安装包编译通过;真机/伴侣/硬件联调尚未实测。全部属性读写、方法与事件的操作入口和预期结果见组件指导。

文档反馈