FAQ/トラブルシューティング

🏠 ドキュメントトップ ⚖️ 利用規約 🔒 プライバシーポリシー

よくある質問と、問題が発生した場合の解決方法をまとめています。

注意（Integral対応状況） Integral対応は現在進行中です。Integral関連のカメラパラメータは一部の数値が正しく記録・表示されない場合があります。

よくある質問

画像が表示されない

症状: ギャラリーに画像が表示されない、またはサムネイルが読み込まれない

解決方法:

  1. フォルダが正しくインポートされているか確認
    • サイドバーの「インポート」から、フォルダが追加されているか確認
    • フォルダのステータスが「有効」になっているか確認
  2. 画像ファイルがPNG形式か確認
    • VSAはPNGファイルのみをサポートしています
    • JPGやその他の形式は自動的にスキップされます
  3. ファイルが破損していないか確認
    • 画像ビューアで開けるか確認してください
  4. リロードを試す
    • ギャラリー画面のリロードボタン（更新アイコン）をクリック

メタデータが取得できない

症状: ワールド名やユーザー名が「不明」と表示される

解決方法:

  1. VRChatが起動していたか確認
    • メタデータはVRChatからリアルタイムで取得されます
    • VRChatを起動せずに撮影した場合、メタデータは記録されません
  2. VSAがバックグラウンドで動作していたか確認
    • 撮影時にVSAが起動している必要があります
  3. OSC設定を確認
    • VRChatのOSC設定が有効になっているか確認
    • 対応カメラ（VirtualLens2/Integral）のOSC出力が有効か確認
  4. ログファイルを確認
    • VRChatのログファイルが正常に出力されているか確認
    • 場所: %LOCALAPPDATA%Low\VRChat\VRChat\

JXL圧縮が進まない

症状: 圧縮処理が開始されない、または途中で止まる

解決方法:

  1. ディスク容量を確認
    • 圧縮には入力ファイルサイズの約1.2倍の空き容量が必要です
  2. ファイルのアクセス権を確認
    • 入力フォルダの読み取り権限
    • 出力フォルダの書き込み権限
  3. 自動アーカイブの状態を確認
    • JXL圧縮画面で自動アーカイブが有効か確認します
    • アーカイブ管理画面の「問題あり」に再試行できる処理がないか確認します
  4. タスクマネージャーでプロセスを確認
    • VSAのプロセスが応答しているか確認
    • 応答なしの場合は再起動してください

ギャラリーが重い

症状: スクロールがカクカクする、読み込みが遅い

解決方法:

  1. サムネイルサイズを調整
    • 大きいサムネイルは処理負荷が高くなります
    • ズームアウトして小さいサムネイルで表示してみてください
  2. 他のアプリケーションを終了
    • メモリ使用量が多い場合、パフォーマンスが低下します
  3. ソートモードを確認
    • ソート中は全データを読み込むため、遅くなる場合があります
  4. データベースを最適化
    • 長期間使用すると、データベースが断片化する場合があります
    • 設定画面からデータベースの最適化を実行できます

アプリが起動しない

症状: VSAをクリックしても起動しない

解決方法:

  1. 既存のプロセスを終了
    • タスクマネージャーでVSAのプロセスが残っていないか確認
    • 残っている場合は終了させてから再起動
  2. 管理者権限で実行
    • 右クリック > 「管理者として実行」を試す
  3. 設定ファイルをリセット
    • 設定ファイルが破損している可能性があります
    • %APPDATA%\vsa-mainapp フォルダを削除して再起動

Steam版VRChatの起動時にVSAを起動したい

WindowsのSteam版VRChat（App ID 438100）では、初回セットアップの「起動方法」またはゲーム関連設定から「Steam連携」を有効にしてください。SteamのLaunch OptionsへVSAを追加し、VRChat起動時にVSAを最小化状態で開始します。VSAが起動できなくてもVRChatの起動は継続します。

Steamが起動中の場合はファイルを安全に更新できないため、「終了してから再試行」と表示されます。Steamを完全に終了してから再度有効化してください。既存の別アプリ用wrapper、cmd/PowerShell、複雑な記法、複数の%command%は安全のため自動変更しません。既存の設定はSteam側を優先します。

VSAをアンインストールした後もVRChatが起動する

アンインストーラーは、VSAが管理していたLaunch Optionsが変更されていない場合に元の値へ戻してから削除します。Steamが起動中、または別のアプリがLaunch Optionsを変更している場合は上書きせず、アンインストールだけを続行します。

その場合は、アンインストール前にSteamのVRChatプロパティを開き、vsa-mainapp.exe と --minimized を含むVSA由来の部分だけを削除してください。別アプリのwrapperやVRChat本来の引数は残してください。

ゲーム側設定が見つからない

症状: ゲーム側設定パネルが表示されない、またはアクセスできない

解決方法:

  1. サイドバーを確認
    • 左側のサイドバーに「ゲーム側設定」メニューが表示されているか確認
    • 表示されない場合は、設定画面を開いてください
  2. 設定画面から開く
    • サイドバーの歯車アイコン（⚙️）をクリックして設定画面を開く
    • 左側のメニューから「ゲーム側設定」を選択

詳細はゲーム側設定ガイドを参照してください。

通知が表示されない

症状: デスクトップ通知が表示されない、または音が出ない

解決方法:

  1. VSAの通知設定を確認
    • 設定画面 > 「通知」パネルを開く
    • 「デスクトップ通知」が有効になっているか確認
  2. Windowsの通知設定を確認
    • Windowsの設定 > システム > 通知とアクション
    • VSAのアプリケーションが「許可」になっているか確認
  3. 集中モードを確認
    • Windowsの集中モードが有効になっていないか確認
    • 有効な場合は通知がブロックされることがあります

詳細は設定画面完全ガイドを参照してください。

ショートカットが動作しない

症状: キーボードショートカットを押しても反応がない

解決方法:

  1. ショートカット設定を確認
    • 設定画面 > 「ショートカット」パネルを開く
    • 登録されているキーの組み合わせを確認
  2. VSAウィンドウがアクティブか確認
    • VSAウィンドウをクリックして最前面に持ってくる
    • 他のアプリケーションがアクティブになっていないか確認
  3. Windowsショートカットの競合を確認
    • Alt + TabなどのWindowsショートカットとの競合がないか確認
    • 競合している場合は別のキーの組み合わせに変更

詳細はキーボードショートカット一覧を参照してください。

クラウド保存が失敗する、または利用できない

症状: お気に入い写真のクラウド保存に失敗する、メニューが表示されない、またはエラーが表示される

解決方法:

  1. ロールアウトとプランを確認
    • クラウド保存は段階的公開です。アカウント画面でプランと連携状態を確認
    • 未提供の環境ではメニューが表示されません
  2. ネットワーク接続を確認
    • インターネット接続が有効か確認
    • Wi-Fi接続を確認
  3. 再サインイン
    • アカウント画面の案内に従いログアウト後、再度サインイン
  4. ローカルバックアップ
    • 重要なお気に入りは favorites.db を別途バックアップ

料金・上限はアプリ内表示と利用規約に従います。詳細はお気に入り機能ガイドとアカウント管理ガイドを参照してください。

セットアップウィザードをスキップしたい

症状: 初回起動時のセットアップウィザードをスキップして、すぐにアプリを使いたい

解決方法:

  1. 「スキップ」ボタンをクリック
    • 各ステップに表示されている「スキップ」ボタンをクリック
    • またはウィザード側の「スキップ」ボタンで全ステップをスキップ
  2. デフォルト設定でアプリが起動
    • スキップした場合、デフォルト設定でアプリが起動します
    • 後から設定画面で変更可能

詳細は初回セットアップガイドを参照してください。

トラブルシューティング

VRChatログの場所確認

VRChatのログファイルは以下の場所にあります:

%LOCALAPPDATA%Low\VRChat\VRChat\

Windowsエクスプローラーのアドレスバーにこのパスを入力してアクセスできます。

ログファイル名は output_log_日付_時刻.txt の形式です。

OSC通信の確認

OSC通信が正常に動作しているか確認する方法:

  1. VRChatの設定を開く
  2. OSCセクションに移動
  3. 「OSC」が有効になっているか確認
  4. 必要に応じて「OSCデバッグコンソール」を有効にして通信を確認

データベースの再構築

データベースに問題がある場合、再構築が必要になることがあります。

注意: この操作を行うと、お気に入り設定などの情報が失われます。

  1. VSAを終了
  2. %APPDATA%\vsa-mainapp\database フォルダを削除
  3. VSAを再起動
  4. フォルダを再インポート

ログファイルの確認

VSAのログファイルは以下の場所にあります:

%APPDATA%\vsa-mainapp\logs\

問題が発生した場合、このログファイルにエラー情報が記録されています。

問い合わせ先

上記の方法で解決しない場合は、以下の方法でお問い合わせください:

  1. GitHubのIssues
    • バグ報告や機能リクエストはGitHubのIssuesで受け付けています
    • ログファイルを添付していただけると、問題の特定が容易になります
  2. ログファイルの添付
    • 問い合わせの際は、以下の情報をお伝えください:
      • 発生した問題の詳細
      • 再現手順
      • VSAのバージョン
      • Windowsのバージョン
      • 関連するログファイル

既知の問題

以下は現在把握している既知の問題です。今後のアップデートで修正予定です。