將開場動畫邏輯封裝為可複用的 SplashAnimationHelper 類,支援:多幀圖片序列動畫 / 單圖縮放淡入、自定義播放時長、並行執行耗時初始化任務 (SDK 初始化、資料預載)、動畫結束自動跳轉目標 Activity、螢幕方向鎖定。適用於需要品牌動畫展示的商業級 App。
public class SplashAnimationHelper {
// 動畫資源資料類
public static class AnimationFrame {
public final int resId; // Drawable 資源 ID
public final long durationMs; // 幀持續時間
public final float alphaStart; // 起始透明度 0-1
public final float alphaEnd; // 結束透明度 0-1
public AnimationFrame(int resId, long durationMs, float alphaStart, float alphaEnd) {
this.resId = resId; this.durationMs = durationMs; this.alphaStart = alphaStart; this.alphaEnd = alphaEnd;
}
}
private final Activity activity;
private final ImageView imageView;
private final List frames;
private final long totalDurationMs;
private final Runnable onAnimationEnd;
private final Runnable heavyInitTask; // 耗時初始化任務 (背景執行緒)
private final int orientation; // ActivityInfo.SCREEN_ORIENTATION_PORTRAIT 等
private Handler handler = new Handler(Looper.getMainLooper());
private int currentFrameIndex = 0;
private boolean isAnimating = false;
public SplashAnimationHelper(Activity activity, ImageView imageView,
List frames, long totalDurationMs,
Runnable heavyInitTask, Runnable onAnimationEnd,
int orientation) {
this.activity = activity;
this.imageView = imageView;
this.frames = frames;
this.totalDurationMs = totalDurationMs;
this.heavyInitTask = heavyInitTask;
this.onAnimationEnd = onAnimationEnd;
this.orientation = orientation;
}
public void start() {
// 1. 鎖定螢幕方向
activity.setRequestedOrientation(orientation);
// 2. 啟動背景耗時任務
if (heavyInitTask != null) {
Executors.newSingleThreadExecutor().execute(heavyInitTask);
}
// 3. 開始動畫循環
isAnimating = true;
playNextFrame();
}
private void playNextFrame() {
if (!isAnimating || currentFrameIndex >= frames.size()) {
onAnimationEndInternal();
return;
}
AnimationFrame frame = frames.get(currentFrameIndex);
// 簡易實作:直接設圖 + 動畫透明度漸變
imageView.setImageResource(frame.resId);
imageView.setAlpha(frame.alphaStart);
imageView.animate()
.alpha(frame.alphaEnd)
.setDuration(frame.durationMs)
.withEndAction(() -> {
currentFrameIndex++;
playNextFrame();
})
.start();
}
private void onAnimationEndInternal() {
isAnimating = false;
handler.post(() -> {
activity.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED); // 解鎖方向
if (onAnimationEnd != null) onAnimationEnd.run();
});
}
public void skip() {
isAnimating = false;
handler.removeCallbacksAndMessages(null);
onAnimationEndInternal();
}
}
public class SplashActivity extends AppCompatActivity {
private SplashAnimationHelper splashHelper;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_splash_anim); // 僅含一個全螢幕 ImageView
ImageView ivAnim = findViewById(R.id.iv_splash_anim);
// 定義動畫幀 (此處為單圖縮放淡入示例,可擴充為多幀序列)
List frames = new ArrayList<>();
frames.add(new SplashAnimationHelper.AnimationFrame(R.drawable.splash_logo, 1500, 0f, 1f)); // 淡入
frames.add(new SplashAnimationHelper.AnimationFrame(R.drawable.splash_logo, 1000, 1f, 1f)); // 停留
frames.add(new SplashAnimationHelper.AnimationFrame(R.drawable.splash_logo, 500, 1f, 0f)); // 淡出
splashHelper = new SplashAnimationHelper(
this,
ivAnim,
frames,
3000, // 總時長 3 秒
this::heavyInit, // 背景執行耗時初始化
this::navigateToMain, // 動畫結束跳轉
ActivityInfo.SCREEN_ORIENTATION_PORTRAIT // 鎖直向
);
splashHelper.start();
// 點擊螢幕跳過
ivAnim.setOnClickListener(v -> splashHelper.skip());
}
private void heavyInit() {
// 初始化 SDK、預載資料、檢查更新等
Crashlytics.init(this);
EventBus.getDefault().register(this);
// 模擬耗時
SystemClock.sleep(1500);
}
private void navigateToMain() {
startActivity(new Intent(this, MainActivity.class));
finish();
overridePendingTransition(android.R.anim.fade_in, android.R.anim.fade_out);
}
@Override
protected void onDestroy() {
super.onDestroy();
if (splashHelper != null) splashHelper.skip();
}
}
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="https://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@color/white">
<ImageView
android:id="@+id/iv_splash_anim"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:scaleType="centerInside"
android:contentDescription="@string/app_name" />
</FrameLayout>
若設計稿為 After Effects 動畫,強烈建議導出 Lottie JSON,使用 LottieAnimationView 播放,體積小、不失真、支援互動:
// 依賴
implementation "com.airbnb.android:lottie:6.1.0"
// 佈局
<com.airbnb.lottie.LottieAnimationView
android:id="@+id/lottie_view"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:scaleType="centerCrop"
app:lottie_rawRes="@raw/splash_animation"
app:lottie_loop="false"
app:lottie_autoPlay="true" />
// 代碼
lottieView.addAnimatorListener(new Animator.AnimatorListener() {
@Override public void onAnimationEnd(Animator animation) { navigateToMain(); }
// ... 其他方法空實作
});