`CameraComponent.follow` follows the local position of a nested target

未关闭
#4,238 0 条评论 0 个 reaction 已指派 1 人 在 GitHub 查看

维护者通常 1 天内回复

@ufrshubham 已经在做这个了。

开始于 2026年11月19日。

  • #4239 来自 @ufrshubham —— 未关闭

评估

这个 Issue 还没有评估数据。

描述

bug
What happened?

FollowBehavior moves its owner towards target.position (follow_behavior.dart#L55-L58), which is the target's position relative to its parent. When the target is a child of another PositionComponent, that isn't where the target is in the world, so CameraComponent.follow points the camera at the wrong place.

For example, with a knight that is a child of a moving platform and stands at (32, 30) on it, the camera looks at (32, 30) in the world, wherever the platform is. As the platform moves, the camera stays where it is and the knight leaves the screen. follow(target, snap: true) has the same problem, since it sets the viewfinder's position to target.position too (camera_component.dart#L389).

The same happens when a FollowBehavior is used between two components with different parents, e.g. a follower in one container following a target in another.

What do you expect?

The camera follows the target wherever it is in the component tree, as it does for a direct child of the world.

How can we reproduce this?
  1. Add a PositionComponent (the platform) to the world, and move it.
  2. Add the component to follow as a child of the platform.
  3. Call camera.follow(knight). The camera follows the knight's position on the platform, not its position in the world.
What steps should take to fix this?

FollowBehavior will convert the target's position into the coordinate system of the owner's position when the target is a PositionComponent with another parent than the owner: into world coordinates through absolutePosition for an owner that isn't a PositionComponent, such as the camera's Viewfinder, and through absoluteToLocal and positionOf for a PositionComponent owner. When the target and the owner have the same parent, target.position is used as before. CameraComponent.follow will use the same position for snap.

Targets that aren't PositionComponents, such as a PositionProviderImpl, are followed at their position as given, as before. Until the fix is released, a nested target can be followed with camera.follow(PositionProviderImpl(getValue: () => knight.absolutePosition)).

Do have an example of where the bug occurs?
import 'package:flame/components.dart';
import 'package:flame/game.dart';
import 'package:flame/palette.dart';
import 'package:flutter/widgets.dart';

void main() => runApp(GameWidget(game: ReproGame()));

class ReproGame extends FlameGame {
  @override
  Future<void> onLoad() async {
    world.add(RectangleComponent(size: Vector2.all(2000)));
    final platform = MovingPlatform(position: Vector2(100, 100));
    final knight = RectangleComponent(
      position: Vector2(32, 30),
      size: Vector2(16, 28),
      anchor: Anchor.bottomCenter,
      paint: BasicPalette.red.paint(),
    );
    world.add(platform..add(knight));
    camera.follow(knight, snap: true);
  }
}

class MovingPlatform extends RectangleComponent {
  MovingPlatform({super.position})
    : super(size: Vector2(64, 40), anchor: Anchor.center);

  @override
  void update(double dt) {
    position.x += 100 * dt;
  }
}

https://github.com/user-attachments/assets/eb723755-e2dc-4399-aaae-994319cf2c19

Expected: the red knight stays at the center of the screen while the platform carries it. Actual: the camera stays at (32, 30) and the knight moves off the screen.

Relevant log output
Nothing is logged or thrown.
Execute in a terminal and put output into the code block below
[√] Flutter (Channel stable, 3.50.0, on Microsoft Windows [Version 10.0.22631.6199], locale en-US)
    • Flutter version 3.50.0 on channel stable
    • Framework revision ab2912035e (10 days ago), 2026-11-09 08:50:21 -0800
    • Engine revision 371f77202a
    • Dart version 3.14.0
    • DevTools version 2.61.0

[√] Windows Version (11 Pro 64-bit, 23H2, 2009)
[√] Android toolchain - develop for Android devices (Android SDK version 36.1.0)
[√] Chrome - develop for the web
[√] Visual Studio - develop Windows apps (Visual Studio Community 2026 18.11.2)
[√] Connected device (3 available)
[√] Network resources

• No issues found!
Affected platforms

All

Other information

No response

Are you interested in working on a PR for this?
  • I want to work on this
主要语言
Dart
星标
10.8k
派生
1.1k
平均合并
2 天 4 小时
30 天内合并 PR
61

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

flame-engine/flame 的其他 Issue

查看 flame-engine/flame 的全部 Issue

相似的 Issue

更多 Dart Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。