エンジンのログ
flutter_scene は、伝えることを Flutter の debugPrint で書き出します。アプリのログの横に出る、素の行です。スターターはそれらを、ロガー flutter_scene のもとでアプリケーションのログに取り込みます。
使う理由
素の行には時刻もレベルもなく、絞ることもできず、アプリのログが出る場所にも届きません。ロガーのレコードになれば、エンジンのメッセージは時刻とレベルを持ち、アプリのログと同じ場所に出て (デバッグパネルの Logs タブにも)、他のロガーと同じように設定できます。
例
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...
# 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 を元に戻します。