VSA-Mainapp-Release

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. VRChatが起動中でないか確認
    • 「VRChat状態を考慮」が有効な場合、VRChat起動中は圧縮が一時停止します
  4. タスクマネージャーでプロセスを確認
    • VSAのプロセスが応答しているか確認
    • 応答なしの場合は再起動してください

ギャラリーが重い

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

解決方法:

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

アプリが起動しない

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

解決方法:

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

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

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

解決方法:

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

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

通知が表示されない

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

解決方法:

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

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

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

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

解決方法:

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

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

Google Driveアップロードが失敗する

症状: お気に入い写真のアップロードに失敗する、またはエラーが表示される

解決方法:

  1. ネットワーク接続を確認
    • インターネット接続が有効か確認
    • Wi-Fi接続を確認
  2. Google Driveのストレージを確認
    • Google Driveのストレージ容量が満杯でないか確認
    • 満杯の場合は不要なファイルを削除
  3. 認証を再度実施
    • アカウント画面で「ログアウト」をクリック
    • 「Google Driveでログイン」で再度ログイン

詳細はお気に入い機能ガイドを参照してください。

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

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

解決方法:

  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のバージョン
      • 関連するログファイル

既知の問題

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