Flameの法則 v1.14.0 対応
Hello World ライフサイクル 四角形 直線 デバッグ表示 円 移動 ジョイスティック テキスト テキストボタン オーバーレイ スプライト アニメーション パララックス タップ パーティクル 物理演算 衝突判定 ポリゴン サウンド エフェクト テキストボックス カスタムペインター スクリーンヒットボックス ルーター プライオリティ キーボードイベント キーボードリスナー カメラ スプライトシート 発光 反転 バリュールート 円弧 スプライトウィジェット スケールモード ポーズ タイムスケール 波紋 アニメーションティッカー ローディングビルダー エラービルダー バックグラウンドビルダー パスファインディング タイマー HSVカラー

PR 第8章にFlameが載ってる模様

マルチプラットフォーム対応 最新フレームワーク Flutter 3入門

エラービルダー

2023-08-14

ErrorBuilder

GameWidgetのerrorBuilderプロパティに Widget を指定することで、 ゲームがエラーになった時の表示を変更することができます。

公式ドキュメント https://docs.flame-engine.org/latest/flame/game_widget.html#GameWidget-errorBuilder
APIリファレンス https://pub.dev/documentation/flame/latest/game/GameWidget/errorBuilder.html

表示する

GameWidgetのerrorBuilderプロパティでTextを返します。 待ち時間がわかりやすいようにローディングビルダーと同じ設定もしています。

error/page.dart 
  @override
  Widget build(BuildContext context) {
    return GameWidget<ErrorGame>(
      game: game,
      loadingBuilder: (context) => const Center(
        child: CircularProgressIndicator(),
      ),
      errorBuilder: (context, error) => Center(
        child: Text(
          error.toString(),
          style: const TextStyle(
            color: Colors.white,
            decoration: TextDecoration.none,
          ),
        ),
      ),
    );
  }

10 秒待った後、Errorをthrowします。

error/game.dart 
  @override
  Future<void> onLoad() async {
    super.onLoad();

    await Future<void>.delayed(
      const Duration(seconds: 10),
    );

    throw 'Error';
  }

この方法でエラー画面が表示できます。

© 2023 tnantoka