🆘 困った時(トラブルシュート)

「あれ、動かない?」を症状から引けるようにまとめたよ 🆘 詳しくは各章にリンク。

⬛ 画面が真っ黒 / 何も出ない

• まずページを再読み込み(初回ロードに失敗してることがある)
• 最初にマイクを「許可しない」にした 👉 VJam は Micなしで起動できる。許可を戻す手順は 「間違ってマイクを拒否した」 を見てね
• ブラウザが古い / 省電力モードだと WebGL が無効なことも 👉 Chrome の最新版で試す
• 広告ブロックなどの拡張機能を一時オフにしてみる

🔇 音に反応しない

• 映像は動くのに反応しない / 音は鳴ってるのに反応しない 👉 マイクが入ってない or 入力ソース違い。マイク許可を確認 → ページ再読み込み。音声ファイルなら [AUDIO] が playing か確認(→ 「🔊 音を取り込む」 章)
• マイク許可を戻す場所が見つからない 👉 アドレスバーの 🔒 / マイクアイコン、Chrome の Site settings、iPhone Safari の aA / サイト設定を確認。アプリ内ブラウザなら Safari / Chrome で開き直す
• 特定の音だけ反応してない気がする 👉 見た目だけでは使っている音域は分からない。まず反応が大きい別プリセットで入力自体を確認。マイクなら静かな場所で声を出して、反応があるかチェック 🎤

🚫 ボタン / タップに反応しない

• まず画面を1回タップ / クリックしてから(音の開始にはユーザー操作が必要)
• 音声ファイル系の操作は、ファイルを読み込んでから

📂 ファイルを読み込めない / ドロップできない

• 対応形式か確認(画像=PNG/JPG/GIF、動画=MP4、音声=MP3/WAV)
• スマホは D&D でなく IMPORT / AUDIO ボタンから選ぶ
• うまくいかない時はページ再読み込み後にもう一度

📱 iPhone / Safari で動かない

• 音が入らない / 再生されない 👉 iOS は制約が強い。画面を1回タップしてから始める(自動再生ブロック対策)
• ホーム画面に追加したPWA版で不安定なら、Safariで https://vjam.art を直接開き直す(→ 「📲 PWA / アプリインストール」 章)
• それでもダメ 👉 PC + Chrome / Edge を試す(WebMIDI や外部出力などはPC向き)

🐢 重い / カクつく

• 重いプリセット・テキストエフェクト(3D系)を避ける
• 他の重いアプリ・タブを閉じる
• 配信/録画してるなら解像度・FPS を下げる
• Cockpit の FPS 表示が赤(45未満)なら黄信号 🚥

🔴 録画できない / 音が入らない

• 音が入らない 👉 音入り録画は音声ファイル再生が必須。マイク/デモだと入らない。Silent を選ぶか音声ファイルを読み込む(→ 「🔴 録画」 章)
• 保存されない(スマホ) 👉 出てくる「保存」リンクを、閉じる前にタップ

🎹 MIDI がつながらない

• ブラウザを Chrome / Edge に(Safari は WebMIDI 非対応が多い)
• ページ再読み込み / USB 抜き差し / 他アプリ(DAW)が MIDI を掴んでないか(→ 「🎹 MIDI」 章)

📺 外部モニタ / 配信で映らない

• プロジェクターに映らない 👉 ケーブル接続 / OS がモニタを認識してるか / 拡張表示か(→ 「📺 プロジェクター」 章)
• 配信で真っ黒 👉 OBS のキャプチャ方式を変える(ウィンドウ → 画面キャプチャ)。PROJ ウィンドウキャプチャが安定(→ 「📡 配信」 章)

🔄 とりあえず困ったら

• ページを再読み込み(ハードリロード)で直ることが多い
• それでもダメなら Chrome の最新版で試す

🔗 関連

• 音・マイク・BPM → 「🔊 音を取り込む」
• 画像 / 動画 / 音声ファイルの読み込み → 「🖼️ 画像」 / 「🎬 動画」
• 録画の保存や音 → 「🔴 録画」
• 外部出力 / OBS → 「📺 プロジェクター」 / 「📡 配信」
• MIDI が反応しない → 「🎹 MIDI」
• 本番前に先回りして確認 → 「✅ 本番前チェック」