如何使用Apache POI创建含链接视频的PPTX文件及相关问题咨询

阿华AIGC实验室

2026-5-11

解决方案：用Apache POI创建带链接视频的PPTX文件

你遇到的问题很典型——TestMovieShape是针对旧版二进制PPT（.ppt）的HSLF API编写的，而.pptx属于OOXML格式，得用XSLF系列的API来处理。另外媒体控件不可见通常是因为没正确配置媒体形状的属性，或是OOXML结构不完整。下面是具体的解决步骤和代码示例：

1. 核心区别：HSLF vs XSLF

HSLF：对应微软Office 97-2003的二进制PPT格式（.ppt），也就是你找到的示例所用的API
XSLF：对应Office Open XML格式（.pptx），这是我们创建PPTX必须用到的API

2. 实现带链接视频的PPTX代码示例

下面是基于POI 4.1.2的完整代码，能创建包含链接视频的PPTX，同时确保媒体控件可见：

import org.apache.poi.xslf.usermodel.*;
import java.io.FileOutputStream;
import java.io.IOException;

public class LinkedVideoPPTX {
    public static void main(String[] args) throws IOException {
        // 创建PPTX文档
        try (XMLSlideShow ppt = new XMLSlideShow()) {
            // 创建幻灯片
            XSLFSlide slide = ppt.createSlide();
            
            // 创建媒体形状，设置视频显示区域
            XSLFMediaShape mediaShape = slide.createMediaShape();
            mediaShape.setAnchor(new java.awt.Rectangle(100, 100, 640, 480));
            
            // 设置视频链接（本地路径或网络URL都可以，本地建议用绝对路径）
            mediaShape.setSource("file:///C:/demo-video.mp4");
            
            // 设置媒体类型，确保PPT识别为视频
            mediaShape.setContentType("video/mp4");
            
            // 强制启用播放控件显示
            mediaShape.getXmlObject().getShowControls().setVal(true);
            
            // 保存PPTX文件
            try (FileOutputStream out = new FileOutputStream("linked-video.pptx")) {
                ppt.write(out);
            }
        }
    }
}

3. 解决媒体控件不可见的关键要点

强制启用控件：必须调用mediaShape.getXmlObject().getShowControls().setVal(true)，这是让PPT打开时显示播放控件的核心设置
路径有效性：本地视频要用正确的绝对路径，网络视频要确保URL可访问，否则PPT找不到视频源，控件可能被隐藏或显示错误
媒体类型匹配：setContentType要和视频格式对应（比如video/avi对应AVI，video/mov对应MOV等），否则PPT可能无法识别为视频
Office安全提示：打开生成的PPT时，可能会提示“禁用的内容”，需要点击“启用内容”才能加载视频和显示控件，这是Office的安全机制，无法通过POI绕过