Flame框架中FPSCounter未识别报错问题求助

问题现象 #

运行Flutter Flame应用时出现如下报错：

lib/main.dart:19:50: Error: Type 'FPSCounter' not found.
class MyGame extends FlameGame with TapDetector, FPSCounter {
                                                 ^^^^^^^^^^

按照官方文档要求让MyGame继承FlameGame并混入FPSCounter后触发该错误，调整依赖后问题仍存在。

核心原因 #

1. 导入包错误：FPSCounter不属于Flame核心库，而是位于独立的flame_fps包中，默认导入的Flame核心库不包含这个类。
2. 版本适配问题：若使用Flame新版本（如3.x及以上），官方文档的示例可能未同步更新，FPSCounter的实现方式或位置已发生变动。

可行解决方案 #

方案1：引入flame_fps依赖 #

1. 在pubspec.yaml中添加依赖：

dependencies:
  flame: ^1.8.0 # 确保版本与flame_fps兼容
  flame_fps: ^0.2.0

2. 在代码中补充导入：

import 'package:flame_fps/flame_fps.dart';

方案2：用Flame内置FPS统计替代（无需额外包） #

FlameGame自带fps属性，可直接用于统计帧率，无需引入额外依赖：

class MyGame extends FlameGame with TapDetector {
  final TextPaint _textPaint = TextPaint(style: TextStyle(color: Colors.white));

  @override
  void render(Canvas canvas) {
    super.render(canvas);
    // 直接使用内置fps值，默认统计最近100帧的平均帧率
    _textPaint.render(canvas, 'FPS: ${fps.toStringAsFixed(1)}', Vector2(10, 50));
  }
}

方案3：同步版本与官方文档 #

如果使用Flame新版本，先查看对应版本的官方API文档，确认FPS统计的正确实现方式；若坚持使用FPSCounter，需核对flame_fps包是否支持当前Flame版本。

修正后完整代码（方案1） #

import 'package:flame/events.dart';
import 'package:flame/game.dart';
import 'package:flame/flame.dart';
import 'package:flame/input.dart';
import 'package:flame_fps/flame_fps.dart'; // 新增导入
import 'package:flutter/material.dart';
import 'package:intl/intl.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  Flame.device.fullScreen();

  runApp(
      GameWidget(
          game: MyGame()
      )
  );
}

class MyGame extends FlameGame with TapDetector, FPSCounter {
  final TextPaint _textPaint = TextPaint(style: TextStyle(color: Colors.white));

  @override
  Future<void> onLoad() async {
    super.onLoad();
    print('<game loop> onLoad() called');
  }
  
  @override
  void update(double dt) {
    super.update(dt);
  }
  
  @override
  void render(Canvas canvas) {
    super.render(canvas);
    
    canvas.drawPaint(Paint()..color = Colors.red);
    // 使用FPSCounter的fps方法统计最近120帧的平均帧率
    final fpsCount = fps(120);
    _textPaint.render(canvas, 'FPS: ${fpsCount.toStringAsFixed(1)}', Vector2(10, 50));
  }

  @override
  void onTapUp(TapUpInfo info) {
  }
}

内容的提问来源于stack exchange，提问作者M H