在许多应用场景中，我们可能需要播放一段GIF动画来吸引用户注意力，但又不希望它无限循环，而是在播放一次后停留在最后一帧或切换为一张静态图片。Glide作为Android上流行的图片加载库，提供了强大的功能来满足这一需求。
1. 集成Glide库
首先，确保你的Android项目中已经集成了Glide库。在项目的build.gradle（模块级别）文件中添加以下依赖：
dependencies {
implementation 'com.github.bumptech.glide:glide:4.12.0' // 使用最新稳定版本
annotationProcessor 'com.github.bumptech.glide:compiler:4.12.0'
}完成依赖添加后，同步你的项目。
2. 布局文件中的ImageView
在你的布局文件（例如activity_main.xml）中，添加一个ImageView来显示GIF和后续的静态图片。
请注意，android:src在这里可以作为占位符或默认图片，实际的GIF和静态图片将通过代码加载。
3. 核心实现：GIF单次播放与动画结束回调
实现GIF单次播放并在结束后切换为静态图片的关键在于利用GifDrawable的setLoopCount(1)方法和registerAnimationCallback方法。
我们将在加载GIF时设置一个RequestListener，在该监听器的onResourceReady回调中，获取到GifDrawable实例。然后，我们可以设置循环次数为1，并注册一个Animatable2Compat.AnimationCallback。当GIF动画播放完毕时，onAnimationEnd方法将被调用，我们可以在其中加载静态图片。
以下是具体的Java代码实现：
import android.graphics.drawable.Drawable;
import android.os.Bundle;
import android.widget.ImageView;
import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;
import androidx.vectordrawable.graphics.drawable.Animatable2Compat;
import com.bumptech.glide.Glide;
import com.bumptech.glide.load.DataSource;
import com.bumptech.glide.load.engine.DiskCacheStrategy;
import com.bumptech.glide.load.engine.GlideException;
import com.bumptech.glide.load.resource.gif.GifDrawable;
import com.bumptech.glide.request.RequestListener;
import com.bumptech.glide.request.RequestOptions;
import com.bumptech.glide.request.target.Target;
public class MainActivity extends AppCompatActivity {
private ImageView imageView;
// 假设你的GIF资源ID是R.drawable.fuseev4
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main); // 替换为你的布局文件
imageView = findViewById(R.id.fuse);
// 调用方法加载GIF
loadGifAndThenImage();
}
private void loadGifAndThenImage() {
Glide.with(this)
.asGif() // 指定加载GIF
.load(R.drawable.fuseev4) // 你的GIF资源
.apply(RequestOptions.diskCacheStrategyOf(DiskCacheStrategy.NONE)) // 避免缓存问题，确保GIF每次都完整加载
.listener(new RequestListener() {
@Override
public boolean onLoadFailed(@Nullable GlideException e, Object model, Target target, boolean isFirstResource) {
// GIF加载失败时的处理
if (e != null) {
e.printStackTrace();
}
return false; // 返回false让Glide处理错误
}
@Override
public boolean onResourceReady(GifDrawable resource, Object model, Target target, DataSource dataSource, boolean isFirstResource) {
// GIF资源准备就绪
resource.setLoopCount(1); // 设置GIF只播放一次
// 注册动画结束回调
resource.registerAnimationCallback(new Animatable2Compat.AnimationCallback() {
@Override
public void onAnimationEnd(Drawable drawable) {
super.onAnimationEnd(drawable);
// GIF动画播放结束后，加载静态图片
// 这里我们加载与GIF相同的资源作为Bitmap，通常会显示GIF的最后一帧或其静态表示
Glide.with(imageView.getContext())
.asBitmap() // 指定加载为Bitmap
.load(R.drawable.fuseev4) // 你的静态图片资源 (可以与GIF相同或不同)
.into(imageView);
}
});
return false; // 返回false让Glide将GifDrawable显示到ImageView
}
})
.into(imageView);
}
} 代码解析：
- Glide.with(this).asGif().load(R.drawable.fuseev4): 这行代码指示Glide加载R.drawable.fuseev4作为GIF。
- RequestOptions.diskCacheStrategyOf(DiskCacheStrategy.NONE): 为了确保GIF每次都从头开始播放，并且避免潜在的缓存问题，我们设置了不使用磁盘缓存。对于GIF单次播放后切换为静态图的场景，这通常是一个好的实践。
-
listener(new RequestListener
()) : 注册一个监听器来捕获GIF的加载状态。 -
onResourceReady(GifDrawable resource, ...): 当GIF资源准备好并可以显示时，这个方法会被调用。
- resource.setLoopCount(1): 这是设置GIF只播放一次的关键。
- resource.registerAnimationCallback(new Animatable2Compat.AnimationCallback() { ... }): 注册一个回调，用于监听GIF动画的生命周期事件。
- onAnimationEnd(Drawable drawable): 当GIF动画播放完毕时，此方法会被调用。在这个方法内部，我们再次使用Glide加载相同的资源，但这次是作为Bitmap (.asBitmap())，并将其设置到ImageView中。这样，GIF播放结束后，ImageView就会显示该资源的静态图片形式。
4. 注意事项
- Glide版本兼容性: Animatable2Compat.AnimationCallback是在Glide 4.x版本中引入的。请确保你的Glide版本是4.x或更高。
- 上下文管理: 在onAnimationEnd回调中，使用imageView.getContext()来获取上下文是一个安全的做法，可以避免因Activity生命周期结束而导致的内存泄漏或空指针异常。
- 资源选择: 在onAnimationEnd中加载的静态图片资源可以与GIF资源相同（如示例所示，这样通常会显示GIF的最后一帧或其默认静态表示），也可以是完全不同的静态图片资源，具体取决于你的需求。
- 性能考量: DiskCacheStrategy.NONE会禁用磁盘缓存，这意味着每次加载GIF时都需要重新从资源中解码。如果GIF文件较大或加载频率很高，可能会对性能产生轻微影响。在某些情况下，可以考虑使用DiskCacheStrategy.DATA或DiskCacheStrategy.RESOURCE，但可能需要更复杂的逻辑来处理缓存的GIF循环计数。对于单次播放后切换的场景，NONE通常是合适的选择。
- 异常处理: 在onLoadFailed中添加适当的错误处理逻辑，例如显示一个默认图片或日志记录，以提高应用的健壮性。
5. 总结
通过利用Glide的GifDrawable提供的setLoopCount()和registerAnimationCallback()方法，我们可以轻松实现在Android应用中GIF动画的单次播放，并在动画结束后自动切换为静态图片。这种方法提供了灵活且高效的解决方案，适用于需要动态展示内容但又不希望其持续循环的场景。
