如何通过vlcj获取RTSP流播放时的实时FPS与比特率？

我完全理解你的困扰——用vlcj播放RTSP流时，现有的getTrackInfo、getRate、getFps方法要么返回null要么数据不准，但VLC本身明明能实时显示比特率。其实问题出在你用的方法不适合获取动态实时统计数据，下面给你几个可行的解决方案：

1. 先确保在正确时机获取TrackInfo #

你调用getTrackInfo(TrackType.VIDEO)返回null，大概率是因为调用时机太早——媒体还没完成解析和加载。你需要监听媒体准备完成的事件，等媒体真正就绪后再获取轨道信息：

mediaPlayer.addMediaPlayerEventListener(new MediaPlayerEventAdapter() {
    @Override
    public void mediaPlayerReady(MediaPlayer mediaPlayer) {
        // 此时调用getTrackInfo应该能拿到数据了
        List<TrackInfo> videoTracks = mediaPlayer.getTrackInfo(TrackType.VIDEO);
        if (videoTracks != null && !videoTracks.isEmpty()) {
            TrackInfo videoTrack = videoTracks.get(0);
            // 这里可以拿到媒体的标称帧率、比特率等静态信息
            float nominalFps = videoTrack.rate();
            long nominalBitrate = videoTrack.bitrate();
            System.out.printf("标称帧率: %.2f, 标称比特率: %d kbps%n", nominalFps, nominalBitrate / 1000);
        }
    }
});

不过要注意，这里拿到的是媒体流的标称值，不是播放过程中动态变化的实时数据。如果需要实时更新的数值，得用下面的方法。

2. 使用MediaStats获取实时统计数据 #

vlcj提供了MediaStats类，专门用来获取播放过程中的实时统计数据，包括实时FPS、比特率、丢帧数等。不过要先开启VLC的统计功能：

步骤1：初始化MediaPlayerFactory时添加统计参数 #

// 添加--stats参数开启统计功能
MediaPlayerFactory factory = new MediaPlayerFactory("--stats");
EmbeddedMediaPlayer mediaPlayer = factory.mediaPlayers().newEmbeddedMediaPlayer();

步骤2：定时获取并更新实时数据 #

因为统计数据是动态变化的，你需要定时（比如每秒一次）去获取并更新UI：

// 用定时任务每秒获取一次统计数据
ScheduledExecutorService statsExecutor = Executors.newSingleThreadScheduledExecutor();
statsExecutor.scheduleAtFixedRate(() -> {
    MediaStats stats = mediaPlayer.getMediaStats();
    if (stats != null) {
        // 提取视频流的实时统计数据
        MediaStats.Video videoStats = stats.video();
        float realTimeFps = videoStats.fps();
        long realTimeBitrate = videoStats.bitrate(); // 单位是bps，转成kbps需除以1000
        
        // 注意：如果是Swing/JavaFX UI，要在UI线程更新内容
        // Swing示例：
        SwingUtilities.invokeLater(() -> {
            fpsDisplay.setText(String.format("实时FPS: %.2f", realTimeFps));
            bitrateDisplay.setText(String.format("实时比特率: %d kbps", realTimeBitrate / 1000));
        });
        
        // 控制台测试输出
        System.out.printf("实时FPS: %.2f, 实时比特率: %d kbps%n", realTimeFps, realTimeBitrate / 1000);
    }
}, 0, 1, TimeUnit.SECONDS);

步骤3：记得关闭定时任务 #

当播放器停止或销毁时，要关闭定时任务避免内存泄漏：

mediaPlayer.addMediaPlayerEventListener(new MediaPlayerEventAdapter() {
    @Override
    public void mediaPlayerStopped(MediaPlayer mediaPlayer) {
        statsExecutor.shutdown();
    }
});

3. 优化RTSP流播放参数（可选） #

对于RTSP流，添加一些VLC参数可以让统计数据更稳定，比如调整缓存：

MediaPlayerFactory factory = new MediaPlayerFactory(
    "--stats",
    "--rtsp-caching=100" // 设置100ms缓存，减少卡顿，让统计更准确
);

为什么之前的方法不准确？ #

• getFps()返回的是媒体的标称帧率（比如视频封装时的固定帧率），不是实际播放的实时帧率；
• getRate()返回的是播放速率（比如1.0是正常速度，2.0是倍速），和帧率无关；
• getTrackInfo需要等媒体完成解析才能返回有效数据，太早调用会返回null。

内容的提问来源于stack exchange，提问作者Null Pointer