mirror of
https://github.com/flame-engine/flame.git
synced 2025-11-02 20:13:50 +08:00
39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
# Input
|
|
|
|
In order to handle user input, you can use the libraries provided by Flutter for regular apps: [Gesture Recognizers](https://flutter.io/gestures/).
|
|
|
|
However, in order to bind them, use the `Flame.util.addGestureRecognizer` method; in doing so, you'll make sure they are properly unbound when the game widget is not being rendered, and so the rest of your screens will work appropriately.
|
|
|
|
For example, to add a tap listener ("on click"):
|
|
|
|
```dart
|
|
Flame.util.addGestureRecognizer(new TapGestureRecognizer()
|
|
..onTapDown = (TapDownDetails evt) => game.handleInput(evt.globalPosition.dx, evt.globalPosition.dy));
|
|
```
|
|
|
|
Where `game` is a reference to your game object and `handleInput` is a method you create to handle the input inside your game.
|
|
|
|
If your game doesn't have other screens, just call this after your `runApp` call, in the `main` method.
|
|
|
|
Here are some example of more complex Gesture Recognizers:
|
|
|
|
```dart
|
|
MyGame() {
|
|
// other init...
|
|
|
|
Flame.util.addGestureRecognizer(createDragRecognizer());
|
|
Flame.util.addGestureRecognizer(createTapRecognizer());
|
|
}
|
|
|
|
GestureRecognizer createDragRecognizer() {
|
|
return new ImmediateMultiDragGestureRecognizer()
|
|
..onStart = (Offset position) => this.handleDrag(position);
|
|
}
|
|
|
|
TapGestureRecognizer createTapRecognizer() {
|
|
return new TapGestureRecognizer()
|
|
..onTapUp = (TapUpDetails details) => this.handleTap(details.globalPosition);;
|
|
}
|
|
```
|
|
__ATTENTION:__ `Flame.util.addGestureRecognizer` must be called after the `runApp`, otherwise Flutter's `GestureBinding` will not be initialized yet and exceptions will occur.
|