← 返回开屏动画组件参考 · 全部使用指导

开屏动画使用指导

开屏动画是一个不可见工具组件。屏幕初始化后自动弹出一张全屏图片，倒计时结束或用户点击 「跳过」后收起，适合做开屏推广图、欢迎页或引导页。

图片可以直接用项目素材，也可以填文件路径或 http/https 地址（支持 GIF 动图）。 默认显示 5 秒、显示剩余秒数、允许跳过；图片加载成功后才开始计时。

联机调试需要使用包含该组件的新版本 AI 伴侣。安卓与鸿蒙都支持，积木写法相同。 开屏动画依赖网络图片时，请先确认应用已申请互联网权限。

快速上手

最简单的用法不需要任何代码块：把组件拖入屏幕，在设计器里选好图片即可。 需要知道广告何时结束、或按原因做不同处理时，再连已关闭（原因）（Closed）事件：

when 开屏动画1.Closed(原因) {
  if 原因 == "finished" {
    标签1.Text = "欢迎回来"
  }
}

关闭原因有三种：finished（倒计时自然结束）、skipped（用户点了跳过）、dismissed（代码调用关闭）。 不需要自动弹出时，把「启动时显示」设为假，之后用显示（Show）方法手动弹出。

使用建议

• 素材图响应最快；网络图首次显示会有加载等待，超时走加载失败（消息）（LoadFailed）。
• 开屏推广图建议「显示时长 3–5 秒 + 允许跳过」，不要强制用户看完整倒计时。
• 想做「点击广告跳转详情页」：连被点击（Clicked）事件，先关闭广告再打开目标屏幕。
• GIF 会循环播放直到倒计时结束；把「显示倒计时」保持打开，用户才能感知剩余等待时间。

案例：按钮手动打开欢迎图

上传 welcome.gif，增加开屏动画、显示按钮和标签。关闭启动时自动显示，点击按钮显示，关闭事件显示结束原因。

when Screen1.Initialize() {
  开屏动画1.ShowOnStart = false
  开屏动画1.Picture = "welcome.gif"
}
when 按钮1.Click() {
  开屏动画1.Show()
}
when 开屏动画1.Closed(原因) {
  标签1.Text = 原因
}
when 开屏动画1.LoadFailed(消息) {
  标签1.Text = 消息
}

显示时应覆盖整个屏幕，GIF 连续播放；点击跳过后返回原界面。使用缩放方式属性选择完整显示、裁切铺满或拉伸，按图片长宽比检查横竖屏效果。

完整 .aia 源码与操作指导

下载 .aia 源码

开屏图片、倒计时、跳过和主动关闭的完整操作，默认首次打开不自动遮挡。自带真实ad.png；“2秒主动关闭”只在真实图片显示成功事件后启用计时器，不把加载等待算作显示时间。

导入 StartupAdAllFeatures.aia，连接最新伴侣，或编译独立安装包。真机／伴侣运行尚未实测。

所有返回值均用于界面反馈，错误由底部错误区展示。设计器采用明确非默认配置，初始化与界面同步。API 覆盖检查按最终 AIA 检查方法、事件、属性读取与设置及设计器配置，不能替代真实设备验证。

开屏图片与倒计时

导入方法：项目 → 导入项目（.aia）→ 选择下载的 .aia 源码文件。 开屏图片、倒计时、跳过和主动关闭的完整操作，默认首次打开不自动遮挡。自带真实ad.png；“2秒主动关闭”只在真实图片显示成功事件后启用计时器，不把加载等待算作显示时间。 覆盖检查 34/34。首次载入及保存重开均0个错误，真实后台导入、安装包编译通过；真机／伴侣／硬件联调尚未实测。全部属性读写、方法与事件的操作入口和预期结果见组件指导。

推荐测试

先点“显示”，等待5秒自然结束，检查关闭原因为finished；再次显示点“进入应用”，应为skipped。点“显示成功2秒后主动Dismiss”，图显示成功才启动计时器，关闭应为dismissed。广告盖住操作区期间不要试图点击底下的关闭按钮，主动关闭测试已经由实际计时器完成。

默认允许跳过、显示倒计时、完整显示原图；更改配置后先应用，再显示。图片加载失败期间不启动倒计时，也不伪造Shown。异常后点恢复，再显示。启动显示偏好用本工程独立名称保存；开启后重开自动显示，测试完关闭该偏好并应用。

网络测试：在电脑解压本AIA并启动 python3 -m http.server 8769 --bind 0.0.0.0 --directory 解压目录/assets，手机填写 http://电脑实际IPv4:8769/ad.png；地址换成实际IP，测试404用missing.png。电脑手机同一局域网，是否显示以真实图像及Shown事件为准。图片复制自仓库aiplayapp/assets/app-icon.png，未修改字节。