Active Storage 预览¶ ↑

一些非图像的 blob 可以被预览：也就是说，它们可以被呈现为图像。视频 blob 可以通过提取其第一帧来预览，PDF blob 可以通过提取其第一页来预览。

预览器从 blob 中提取预览图像。Active Storage 为视频和 PDF 提供了预览器。ActiveStorage::Previewer::VideoPreviewer 用于视频，而 ActiveStorage::Previewer::PopplerPDFPreviewer 和 ActiveStorage::Previewer::MuPDFPreviewer 用于 PDF。通过继承 ActiveStorage::Previewer 并实现所需的方法来构建自定义预览器。有关预览器要求的更多详细信息，请参阅 ActiveStorage::Previewer 文档。

为了选择 blob 的预览器，Active Storage 按顺序调用已注册预览器的 accept? 方法。它使用第一个 accept? 方法返回 true 的预览器来处理该 blob。在 Rails 应用程序中，通过在初始化程序中操作 Rails.application.config.active_storage.previewers 来添加或删除预览器。

Rails.application.config.active_storage.previewers
# => [ ActiveStorage::Previewer::PopplerPDFPreviewer, ActiveStorage::Previewer::MuPDFPreviewer, ActiveStorage::Previewer::VideoPreviewer ]

# Add a custom previewer for Microsoft Office documents:
Rails.application.config.active_storage.previewers << DOCXPreviewer
# => [ ActiveStorage::Previewer::PopplerPDFPreviewer, ActiveStorage::Previewer::MuPDFPreviewer, ActiveStorage::Previewer::VideoPreviewer, DOCXPreviewer ]

在 Rails 应用程序之外，请改用 ActiveStorage.previewers。

内置预览器依赖于第三方系统库。具体来说，内置视频预览器需要 FFmpeg。提供了两个 PDF 预览器：一个需要 Poppler，另一个需要 muPDF（1.8 或更高版本）。要预览 PDF，请安装 Poppler 或 muPDF。

这些库不是由 Rails 提供的。您必须自己安装它们才能使用内置预览器。在安装和使用第三方软件之前，请确保您了解这样做的许可影响。