# 启动动画

应用启动时显示图片或视频启动画面。

**位置:**[编辑通用配置](/zh/guide/app-actions/edit-common-config/)编辑器中的 **启动画面** 卡片。

## 选项

- **启用** —— 打开启动画面(`splashEnabled`)。
- **媒体** —— 选一张图片(`image/*`)或一个视频(`video/*`)。
- **时长** —— 启动画面显示多久(`splashConfig.duration`)。
- **点击跳过** —— 允许点击跳过(`clickToSkip`)。
- **显示倒计时** —— 独立显示剩余秒数倒计时(`showCountdown`)。
- **方向** —— 启动画面方向(`orientation`)。
- **铺满屏幕** —— 裁剪铺满 vs 适应(`fillScreen`)。
- **启用音频** —— 用于视频启动画面(`enableAudio`)。
- **视频裁剪** —— 为视频启动画面设置起止裁剪区间(`videoStartMs`/`videoEndMs`)。
- **清除媒体** —— 移除所选启动媒体。

## 说明

- 当状态栏可见时,倒计时/跳过胶囊自动落在其下方,绝不被遮挡;纯全屏时保持在顶部角落。
- 启动媒体被打包进导出的 APK(并可加密)。