1. はじめに
今回、初めて「Antigravity」という自走型AIツールを使い、初めてのFlutter、そして初めてのWebアプリのデプロイに挑戦しました。
作成したアプリは、任意の画像を使って遊べるパズルゲームです。

この記事では、AIを使った爆速開発のメリットと、Webアプリ特有(特にiOS Safari)の強烈な洗礼を浴びて、開発時間の2倍をデバッグに溶かした記録をまとめます。
2. なぜこの技術構成・テーマにしたのか?
パズルゲームにした理由
純粋に「友人に作ってほしい」とリクエストされたのがきっかけです。
なぜWebアプリ(Flutter Web)なのか?
理由は大きく2つあります。
プラットフォームの指定がなかったから
今回、特にプラットフォーム等の指定が無かったので、特定のOSや端末に縛られず、URLを共有するだけで誰のブラウザでも動くWebアプリが最適だと判断しました。
自走型AIの「マルチプラットフォーム対応力」を試したかったから
AIが「PC・Android・iOSの様々なブラウザ環境で、破綻せずに動くコードをどこまで書けるのか」という検証も兼ねていました。
【使用技術・ツール】
フロントエンド: Flutter (Web)
開発AI: Antigravity (自走型AI)
ホスティング: Vercel
パッケージ: audioplayers (BGM用), soundpool (SE用), interactive_viewer (スマホ操作用)
3. 実装編:AIの力でコア機能は一瞬で完成
ゲームの基本ロジック(画像の分割、ドラッグ&ドロップ、クリア判定)の実装自体は、Antigravityとのやり取りでわずか3〜4時間程度で終わりました。
スマホでもPCでも遊べるように InteractiveViewer を導入し、ピンチイン・ピンチアウトや画面移動に対応。
ここまでの開発はAIがほぼ全自動でコードを生成してくれたため、非常にスムーズで特に苦労せず作成できました。
しかし、本当の戦いはここからでした。
4. iOS Web Audio対応(実装の倍の時間が溶けた)
PCやAndroidでは完璧に動いたのですが、iPhone(iOS Safari、Chrome等)でテストした途端、以下の現象に遭遇しました。
音量調整スライダーが一切効かない
BGMは鳴るが、効果音(SE)が最初の一回(クリック音)しか鳴らない
クリア音が鳴らず、エラーで裏側の処理が止まりリザルトBGMまで消える
結果的に、このiOS対応のデバッグだけで6〜8時間(実装の倍以上の時間)を費やすことになりました。
ぶつかった壁と解決策の変遷
❌ 失敗1:その都度AudioPlayerを生成する(Spawn & Dispose)
最初はSEが鳴るたびにインスタンスを生成していましたが、iOSは「ユーザーの直接のタップ(Click/Tap)」と完全に同時でないと音の再生をブロックするため、ドラッグ時やクリア時の音が全滅しました。
❌ 失敗2:音量0で一斉再生ハック(Silent Unlock Hack)
「最初のタップ時に全SEを音量0で鳴らして許可を得る」というハックを試しましたが、iOSはプログラムからのVolume操作をOSレベルで無視する仕様になっており、6つの効果音が同時爆音再生されるという大事故が起きました。
✅ 最終結論:ハイブリッドAudio構成(soundpool + 低遅延プレロード)
最終的に、iOSの極悪なオーディオ制限を突破するため、以下のアーキテクチャに行き着きました。
SEは soundpool パッケージを使う
HTML5の 要素(audioplayers)を諦め、Web Audio APIのバッファに直接音声データを叩き込む soundpool に移行。これにより「音源の差し替えによるブロック」を回避し、ドラッグ時の音も鳴るようになりました。
BGMは audioplayers を低遅延モードで事前読み込み(Preload)
リザルトのループBGMは重いため soundpool には入れず、PlayerMode.lowLatency を指定。さらに、iOSのデコード遅延による「タイムアウトエラー」を防ぐため、パズルプレイ中の裏側で setSource を使ってコッソリBGMを事前読み込みしておくという手法を取り入れました。
① ハイブリッド構成(BGMとSEのエンジンの使い分け)の部分
Future<void> init() async {
// (中略:ボリューム設定の読み込みなど)
await _bgmPlayer.setReleaseMode(ReleaseMode.loop);
// iOSのWeb Audio API回線を共有・維持するため、BGMは低遅延モードを強制
await _bgmPlayer.setPlayerMode(PlayerMode.lowLatency);
// リザルト用BGMプレイヤーも同様に初期化
await _resultBgmPlayer.setReleaseMode(ReleaseMode.loop);
await _resultBgmPlayer.setPlayerMode(PlayerMode.lowLatency);
// SE用はHTML5の<audio>を避け、Soundpool(Web Audio APIバッファ)を使用する
_pool = Soundpool.fromOptions(options: const SoundpoolOptions(
streamType: StreamType.notification,
maxStreams: 4, // 複数の効果音が重なって鳴るように設定
));
// (以下略:rootBundleを使ってSEをメモリに直接解凍する処理)
}
② BGMの事前読み込み(プレロード)の部分
// iOSのデコード遅延によるタイムアウト(BGMが鳴らないバグ)を防ぐための事前読み込み処理
Future<void> preloadResultBgm() async {
try {
// ユーザーがパズルをプレイしている裏側で、リザルトBGMをメモリに解凍しておく
// setSourceを呼ぶことでバックグラウンドでデコードが走る
await _resultBgmPlayer.setSource(AssetSource('sounds/result_bgm.mp3'));
} catch (e) {
print('BGM Preload Error (ignored): $e');
}
}
// パズルクリア時は、すでに解凍済みのプレイヤーをresume()するだけでラグなく即座に再生される
5. デプロイ時の罠(401エラー)
ローカルで完璧に動いたのでVercelにデプロイしたところ、画面が真っ白に。
コンソールを見ると manifest.json 401 (Unauthorized) 等のエラーが出ていました。
これはプログラムのバグではなく、Vercelの「プレビュー用URL」にかかっているセキュリティロック(Vercel Authentication)や、Vercelに正常なフォルダを指定してないことが原因でした。
本番用URL(Production)でアクセスするか、設定でロックを外すことでセキュリティロックは解決、デプロイ設定でビルド済みファイルが入ってるフォルダを指定して無事に解決し、デプロイできました。
6. おわりに
AIの力を使えば、ゼロ知識からでも数時間でアプリの形を作れる素晴らしい時代になりました。しかし、「iOS特有の仕様」や「環境依存のラグ」といった泥臭いバグは、AIに任せきりにできず、人間が実機でテストし、観察し、仮説を立ててデバッグする必要がありました。
「なぜ遅延するのか?」「なぜ直後の処理まで止まるのか?」と深く潜って原因を特定し、Webアプリとして完全な状態まで持っていけたことは、非常に大きな経験になりました。
↓作成したアプリです
https://kadai-puzzlegame.vercel.app/
↓リポジトリです
https://github.com/Petaf000/Kadai

