Tdarr项目中的视频帧率检测问题分析与解决方案

问题背景

在使用Tdarr媒体处理工具时，用户遇到了一个关于视频帧率检测的问题。当尝试使用社区插件"Check Video Framerate"来检查视频帧率时，系统会抛出"Video framerate not found"的错误。这个问题主要发生在视频文件的元数据中不包含帧率信息的情况下。

问题分析

Tdarr的原始插件代码设计存在一个缺陷：它仅从视频文件的元数据(meta.VideoFrameRate)中获取帧率信息。然而，许多视频文件并不在元数据中存储帧率信息，而是将这一信息保存在视频流数据中。这导致了当插件无法在元数据中找到帧率时，就会抛出错误。

技术解决方案

通过分析视频文件的FFprobe数据结构，我们可以发现帧率信息实际上存储在视频流的r_frame_rate字段中。因此，正确的做法应该是：

1. 首先获取视频流数据
2. 从第一个视频流的r_frame_rate字段中提取帧率信息
3. 将字符串形式的分数帧率(如"30000/1001")转换为数值

修改后的插件代码核心部分如下：

var videos = args.inputFileObj.ffProbeData.streams.filter(row => row.codec_type === 'video');
var VideoFrameRate;
if (videos !== undefined && videos.length > 0) {
    VideoFrameRate = Number(eval(videos[0].r_frame_rate));
}

实现细节

1. 视频流筛选：通过过滤FFprobe数据中的streams数组，只保留codec_type为'video'的流
2. 帧率提取：从第一个视频流中获取r_frame_rate字段
3. 分数转换：使用eval函数将可能为分数形式的帧率(如"30000/1001")转换为数值
4. 错误处理：当没有视频流时抛出"Missing video tracks"错误，当无法获取帧率时抛出"Video framerate not found"错误

部署方法

对于需要自定义此插件的用户，可以将修改后的插件代码保存到Tdarr的本地插件目录中：

/var/lib/tdarr/server/Tdarr/Plugins/FlowPlugins/LocalFlowPlugins/video/CheckVideoFPS/1.0.0/index.js

技术要点

1. FFprobe数据结构：理解FFprobe返回的视频流数据结构是解决此类问题的关键
2. 帧率表示方式：视频帧率可能以分数形式存储，需要正确处理转换
3. 插件架构：Tdarr插件系统允许通过本地插件覆盖社区插件，提供了灵活的扩展方式

总结

通过对Tdarr视频帧率检测插件的分析和修改，我们解决了原始插件仅从元数据获取帧率信息的局限性。新的实现方案更加健壮，能够从视频流数据中正确提取帧率信息，提高了插件的兼容性和可靠性。这一案例也展示了在处理多媒体文件时，理解底层数据结构的重要性。