本文へスキップ

トラブルシューティング ​

デプロイがリモート JavaScript で止まる ​

vf deploy は CDN JavaScript、リモート WASM、リモート Worker スクリプトをブロックします。

よくある原因:

  • HTML に <script src="https://cdn..."> がある。
  • コードに await import("https://cdn...") がある。
  • 任意のローカル AI プロバイダーが静的 import され、実際には使わなくても同梱物に入っている。

解決:

  • 依存関係をローカルビルドに同梱する。
  • 使っていないプロバイダー / import をデプロイ用ビルドから外す。
  • AI は hub.ai.generateText(...) または hub.ai.chat(...) 経由で呼ぶ。

VifuHub capability を使う ​

Agent Runtime のホスト機能は VifuHub 名前空間から呼び出します。

ts
await hub.ai.generateText({
  model: "basic",
  messages: [{ role: "user", content: "Give a hint." }]
});

hostConnected が false のまま ​

  • Agent Runtime の iframe 内で開いているか確認します。
  • await hub.ready() を呼んでいるか確認します。
  • 通常のローカルブラウザーでは false のままで正常です。
  • VifuHub SDK bridge 初期化後に hub.status() を確認します。

リソースが読めない ​

  • data、media、bundle.include がマニフェストにあるか確認します。
  • マニフェストの id / path を hub.resources.* に渡します。

同じゲームが更新されない ​

vf deploy はサインイン中の所有者とデプロイ名で更新先を決めます。

  • 同じアカウント / API 環境でログインしているか確認します。
  • --name を変えると別ゲームとして扱われます。
  • dev と production は別環境です。

マニフェストが拒否される ​

公開 V1 では id、entry、play、runtime、services、devices、resources、permissions、capabilities、browser、security を書きません。

代わりに main.url、build.output、ai、data、media、bundle、save などの公開フィールドを使ってください。