
# エンジンのログ

`flutter_scene` は、伝えることを Flutter の `debugPrint` で書き出します。アプリのログの横に出る、素の行です。スターターはそれらを、ロガー `flutter_scene` のもとでアプリケーションのログに取り込みます。

## 使う理由

素の行には時刻もレベルもなく、絞ることもできず、アプリのログが出る場所にも届きません。ロガーのレコードになれば、エンジンのメッセージは時刻とレベルを持ち、アプリのログと同じ場所に出て (デバッグパネルの Logs タブにも)、他のロガーと同じように設定できます。

## 例

```text
2026-11-13T19:35:55.592+02:00  INFO 48654 --- [main] flutter_scene : Unpacking glTF (nodes: 1, meshes: 1, materials: 1, skins: 0, animations: 0)
2026-11-13T19:35:55.933+02:00  WARN 48654 --- [main] flutter_scene : pipeline build took 66ms mid-frame. Draw this material once during a load screen...
```

```yaml
# lib/resources/application.yml
logging:
  level:
    flutter_scene: warn    # うまくいかなかったことだけ
```

## レベル

問題を伝えるメッセージ (失敗した、飛ばされた、見つからない、フレームの途中でビルドされたプログラム) は警告です。残りは `info` です。

## どのメッセージがエンジンのものか

`debugPrint` は Flutter 全体で一つの関数なので、エンジンのメッセージは次のように見分けられます。

- エンジンがメッセージを始める言葉で (`flutter_scene:`、`fscene:`、`glTF import:`...)。
- リリースビルド以外では、呼び出しがどこから来たかで。

それ以外はすべて、これまでどおり `debugPrint` に進みます。捕まえられないもの: エンジンが `print` で書き出す少数の行。

## プロパティ

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.flutter.scene.engine-log` | bool | `true` | エンジンのメッセージをアプリケーションのログのレコードにするかどうか。`false` は `debugPrint` に手を付けない |
| `logging.level.flutter_scene` | ログレベル | ルートの値 | エンジンのロガーのレベル。他のロガーと同じ |

Bean は `sceneEngineLog` (`SceneEngineLog`) です。シーンがオンで、`engine-log` が `false` でないときに存在し、アプリケーションが閉じるときに `debugPrint` を元に戻します。

## 関連項目

- [デバッグタブ](debug-tab.md)
- [デバッグパネル](../spring-boot-starter-flutter/debug-panel.md): Logs タブ
- [spring_boot_starter_logging](../spring-boot-starter-logging/index.md)
- [すべてのプロパティ](properties.md)
