flame-core

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Flame Core Fundamentals

Flame Engine 核心基礎，涵蓋組件系統、輸入處理、碰撞檢測、相機、動畫與場景管理。

Flame Engine 核心基础，涵盖组件系统、输入处理、碰撞检测、相机、动画与场景管理。

Quick Start

快速开始

bash

flutter create my_game && cd my_game
flutter pub add flame
flutter pub add flame_audio       # Optional
flutter pub add flame_tiled       # Optional

dart

import 'package:flame/game.dart';
import 'package:flutter/material.dart';

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

class MyGame extends FlameGame with HasCollisionDetection {
  @override
  Future<void> onLoad() async {
    camera.viewfinder.anchor = Anchor.topLeft;
  }
}

bash

flutter create my_game && cd my_game
flutter pub add flame
flutter pub add flame_audio       # Optional
flutter pub add flame_tiled       # Optional

dart

import 'package:flame/game.dart';
import 'package:flutter/material.dart';

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

class MyGame extends FlameGame with HasCollisionDetection {
  @override
  Future<void> onLoad() async {
    camera.viewfinder.anchor = Anchor.topLeft;
  }
}

Reference Index

参考索引

Topic	File	Description
Components	`references/components.md`	組件生命週期、類型、最佳實踐
Input	`references/input.md`	觸控、鍵盤、搖桿輸入處理
Collision	`references/collision.md`	碰撞檢測、Hitbox 類型
Camera	`references/camera.md`	相機設置、跟隨、HUD
Animation	`references/animation.md`	精靈動畫、Effects 系統
Scenes	`references/scenes.md`	RouterComponent、Overlays、UI
Audio	`references/audio.md`	音效、背景音樂、AudioPool
Particles	`references/particles.md`	粒子系統、特效、爆炸效果
Performance	`references/performance.md`	效能優化、最佳實踐、常見問題
Debug	`references/debug.md`	除錯模式、日誌、效能監控

主题	文件	描述
组件	`references/components.md`	组件生命周期、类型、最佳实践
输入	`references/input.md`	触控、键盘、摇杆输入处理
碰撞	`references/collision.md`	碰撞检测、Hitbox 类型
相机	`references/camera.md`	相机设置、跟随、HUD
动画	`references/animation.md`	精灵动画、Effects 系统
场景	`references/scenes.md`	RouterComponent、Overlays、UI
音频	`references/audio.md`	音效、背景音乐、AudioPool
粒子	`references/particles.md`	粒子系统、特效、爆炸效果
性能	`references/performance.md`	性能优化、最佳实践、常见问题
调试	`references/debug.md`	调试模式、日志、性能监控

AI Usage Guide

AI 使用指南

需要了解組件系統？ → Read references/components.md
需要處理輸入？     → Read references/input.md
需要碰撞檢測？     → Read references/collision.md
需要相機設置？     → Read references/camera.md
需要動畫效果？     → Read references/animation.md
需要場景管理/UI？  → Read references/scenes.md
需要音效/音樂？    → Read references/audio.md
需要粒子特效？     → Read references/particles.md
需要效能優化？     → Read references/performance.md
需要除錯/日誌？    → Read references/debug.md

需要了解组件系统？ → 阅读 references/components.md
需要处理输入？     → 阅读 references/input.md
需要碰撞检测？     → 阅读 references/collision.md
需要相机设置？     → 阅读 references/camera.md
需要动画效果？     → 阅读 references/animation.md
需要场景管理/UI？  → 阅读 references/scenes.md
需要音效/音乐？    → 阅读 references/audio.md
需要粒子特效？     → 阅读 references/particles.md
需要性能优化？     → 阅读 references/performance.md
需要调试/日志？    → 阅读 references/debug.md

Component Types Quick Reference

组件类型速查

Type	Use Case
`Component`	Logic only
`PositionComponent`	Has position/size
`SpriteComponent`	Static image
`SpriteAnimationComponent`	Animated sprite
`SpriteAnimationGroupComponent`	Multiple states

类型	使用场景
`Component`	仅逻辑处理
`PositionComponent`	包含位置/尺寸
`SpriteComponent`	静态图片
`SpriteAnimationComponent`	精灵动画
`SpriteAnimationGroupComponent`	多状态

flame-core

Original

Translation

Flame Core Fundamentals

Flame Core Fundamentals

Quick Start

快速开始

Reference Index

参考索引

AI Usage Guide

AI 使用指南

Component Types Quick Reference

组件类型速查

Related Skills

相关技能