第25章 提取媒体元数据

提取媒体元数据

Cloudreve 支持从视频、音频和图片中提取元数据，并将其存入文件属性，以优化展示效果和文件搜索体验。

提取逻辑

当新上传的文件满足以下任一条件时，Cloudreve 会在上传完成后自动开始提取元数据：

• 存储策略启用了原生媒体信息提取器，即文件扩展名属于「存储策略设置 -> 媒体信息提取」中配置的扩展名列表。
• 存储策略未启用原生媒体信息提取器，但通过「存储策略设置 -> 提取媒体元数据」中的「代理媒体提取」功能启用了代理媒体信息提取器。

所有提取任务由统一队列管理，可在「设置 -> 队列 -> 媒体元数据提取」中配置队列参数。任务执行期间，Cloudreve 会按流水线模式依次尝试每个提取器：

提取器	说明
存储策略原生	基于存储服务商的媒体服务能力，提取图片 EXIF 或音频/视频流参数。若使用此提取器，后续提取器将不再执行。
EXIF	内置。从图片中提取 EXIF 信息，包括宽高、GPS 坐标、拍摄者、版权信息、软件、相机、镜头、曝光参数、拍摄时间及照片方向等。若源文件位于第三方存储，将尝试通过 Range 请求仅下载必要部分，避免下载整个文件。
音频元数据	内置。提取音频格式、类型、艺术家、专辑、作曲者、流派等信息。若源文件位于第三方存储，将尝试通过 Range 请求仅下载必要部分，避免下载整个文件。
FFProbe	需第三方依赖。提取音频/视频流参数，包括时长、码率、帧率、编解码器、音轨、章节等。若源文件位于第三方存储，将尝试通过 Range 请求仅下载必要部分，避免下载整个文件。
反向地理编码	依赖 EXIF 提取器及外部 Mapbox 服务。将 EXIF 中的 GPS 坐标转换为文本地址信息，无需下载整个文件。

可在「设置 -> 媒体处理 -> 提取媒体元数据」中启用各项提取器。

提取器代理

可在「设置 -> 媒体处理 -> 提取媒体元数据 -> 代理媒体提取」中启用代理媒体元数据提取功能，使 Cloudreve 能够处理并提取媒体元数据。

用途

不同类型的媒体元数据用途如下：

EXIF

• 搜索
• 在文件详情侧边栏中展示

音频元数据

• 搜索
• 在文件详情侧边栏中展示
• 在音乐播放器中展示

音视频流参数

• 搜索
• 在文件详情侧边栏中展示
• ArtPlayer 进度条中可显示章节信息

注意：仅 Cloudreve 的 FFProbe 可提取章节数据，存储策略原生提取器无法提取章节。

反向地理编码

• 搜索
• 在文件详情侧边栏中展示