如何在iText 5.5中添加MP4视频并实现展示时自动播放？

问题分析 #

你当前的代码在嵌入视频时存在几个关键问题，导致视频无法正常播放或自动启动：

• 嵌入文件时未指定带后缀的文件名，PDF阅读器无法正确识别视频格式
• 直接使用PdfPCell作为视频显示区域的矩形参数，此时cell的布局位置尚未确定，可能导致视频控件无法正确渲染
• 未明确指定视频控件的显示尺寸

修正后的代码 #

final PdfPCell cell = new PdfPCell();
cell.setMinimumHeight(200f);

// 定义视频显示的矩形区域（基于cell的尺寸调整）
Rectangle rect = new Rectangle(0, 0, cell.getMinimumHeight(), cell.getMinimumHeight());

// 读取视频文件字节数组
byte[] videoBytes = IOUtils.toByteArray(ExtractService.getTempDir(id).resolve(mediaId).toUri().toURL());

// 创建嵌入的视频文件规范（指定带.mp4后缀的文件名）
PdfFileSpecification fs = PdfFileSpecification.fileEmbedded(
        writer, 
        null, 
        "embedded_video.mp4", // 必须指定带后缀的文件名
        videoBytes
);

// 创建屏幕注释（自动播放参数为true）
PdfAnnotation screenAnnotation = PdfAnnotation.createScreen(
        writer, 
        rect, 
        "Embedded MP4 Video", // 注释标题（可选）
        fs, 
        "video/mp4", 
        true // 自动播放开关
);

// 将注释添加到chunk
final Chunk chunk = new Chunk();
chunk.setAnnotation(screenAnnotation);

cell.addElement(chunk);

关键修改说明 #

• 指定带后缀的文件名："embedded_video.mp4"让PDF阅读器能准确识别文件类型，这是视频正常播放的前提
• 明确矩形区域：用Rectangle定义视频控件的显示尺寸，避免因cell布局未确定导致的控件渲染问题
• 合理设置注释标题：虽然可选，但有助于PDF阅读器识别控件用途

额外注意事项 #

• 并非所有PDF阅读器都支持嵌入式视频的自动播放功能，建议用Adobe Acrobat Reader测试（对PDF多媒体支持最完善）
• 确保MP4视频编码符合PDF阅读器支持的标准（H.264编码的MP4兼容性最佳）

内容的提问来源于stack exchange，提问作者Mani Afschar Yazdi