JavaFX播放长时长GIF未播完就提前循环的问题如何解决

问题原因 #

你遇到的提前循环问题和GIF时长无关，是JavaFX内置GIF解码器的默认帧数量限制导致的：为了避免超大体积GIF占用过多内存，JavaFX默认仅加载GIF的前100帧，你的GIF总共有216帧，超过限制后解码器会自动截断后续帧，从头开始循环，刚好对应你提到的绿色圆圈首次出现的位置。

解决方案 #

方案1：修改JVM启动参数（无代码改动，最快生效） #

直接在JavaFX应用的VM启动参数中添加如下配置，调高GIF最大帧数限制即可：

-Djavafx.gif.maxFrames=300

你可以根据自己的GIF帧数调整参数值，只要大于等于GIF实际帧数即可，你现有业务代码不需要做任何修改。

方案2：代码自定义GIF解码（无需修改启动配置，兼容性更强） #

如果不方便修改启动参数，可以手动读取GIF全帧后用JavaFX动画组件控制播放，示例代码如下：

import javax.imageio.*;
import javax.imageio.metadata.*;
import org.w3c.dom.NodeList;
import java.awt.image.BufferedImage;
import javafx.animation.*;
import javafx.embed.swing.SwingFXUtils;
import javafx.scene.image.*;
import javafx.util.Duration;
import java.io.*;
import java.util.*;

// 替换原有tutorialView初始化逻辑
List<Image> frames = new ArrayList<>();
List<Integer> delays = new ArrayList<>();
try (InputStream inputStream = getClass().getResourceAsStream("你的GIF资源路径")) {
    ImageReader reader = ImageIO.getImageReadersByFormatName("gif").next();
    reader.setInput(ImageIO.createImageInputStream(inputStream));
    int frameCount = reader.getNumImages(true);
    for (int i = 0; i < frameCount; i++) {
        // 读取单帧并转为JavaFX可用的Image
        BufferedImage bufferedImage = reader.read(i);
        frames.add(SwingFXUtils.toFXImage(bufferedImage, null));
        // 读取单帧播放延迟
        IIOMetadata metadata = reader.getImageMetadata(i);
        IIOMetadataNode root = (IIOMetadataNode) metadata.getAsTree(metadata.getNativeMetadataFormatName());
        NodeList delayNodes = root.getElementsByTagName("DelayTime");
        if (delayNodes.getLength() > 0) {
            // GIF原始单位是1/100秒，转为毫秒
            delays.add(Integer.parseInt(delayNodes.item(0).getTextContent()) * 10);
        }
    }
} catch (IOException e) {
    e.printStackTrace();
}

// 组装动画
ImageView tutorialView = new ImageView(frames.get(0));
Timeline gifTimeline = new Timeline();
int totalDelay = 0;
for (int i = 0; i < frames.size(); i++) {
    int currentIndex = i;
    totalDelay += delays.get(i);
    KeyFrame frame = new KeyFrame(Duration.millis(totalDelay), e -> tutorialView.setImage(frames.get(currentIndex)));
    gifTimeline.getKeyFrames().add(frame);
}
gifTimeline.setCycleCount(Animation.INDEFINITE); // 设置循环播放
gifTimeline.play();

你原有点击事件弹出窗口的逻辑不需要做任何改动，直接使用新初始化的tutorialView即可。

内容的提问来源于stack exchange，提问作者Michelle