SoundQ - リファレンス

SoundQ - リファレンス

目次へ戻る

リファレンス


よくある質問

SoundQへのログインに問題がある

まず、SoundQに初めてログインした際に作成したものと同じアカウントでログインしていることを確認してください。SoundQアカウントは、ライブラリ購入用のオンラインストアなど、他のPSEアカウントとは異なる場合があります。その他に確認すべき項目は次のとおりです。

  • SoundQアカウントの作成時に使用したものと同じアカウント・ログイン方法を使用してください。例えば、Google や Facebook などの SSO(シングルサインオン)アカウントを使用した場合や、ユーザー名/パスワードを手動で入力した場合は、SoundQアカウントの作成時と同じ方法を使用してください。
  • ログインプロセスの正常な動作を妨げる可能性のあるブラウザーのプラグインや設定を無効にしてください。これには、ポップアップのブロック、URI経由でのブラウザーからのアプリ起動の無効化、ブラウザーのリダイレクトの妨害、ブラウザー内でのスクリプト実行の妨害を行う可能性のある、プラグイン・拡張機能・ブラウザー設定・ウイルス対策ソフトやファイアウォールの設定が含まれます。
  • 別のブラウザーでログインを試してください。新しいブラウザーをシステムの既定のブラウザーとして設定してください。SoundQはシステムの既定のブラウザーを使用してログインプロセスを起動します。
  • SoundQを経由せず、ブラウザーで直接 app.prosoundeffects.com にログインし、アカウント/ログインが有効かつ正しいことを確認してください。

参照: サインアップ/サインイン


サウンドエフェクトの再生時に音が出ない

SoundQのPreferences PanelのPlaybackタブで、正しいオーディオ出力デバイスが選択されていることを確認してください。その他に確認すべき項目は次のとおりです。

  • 「Follow System Audio Output」を無効にして現在の既定のオーディオ出力デバイスを上書きし、「Internal Speakers」や「Headphones」など動作確認済みの出力デバイスを選択してみてください。
  • SoundQのPreferences→Playbackタブで、サンプルレートとバッファサイズの設定がハードウェアと一致していることを確認してください。
  • DAWや他のサードパーティ製オーディオソフトウェアによってインストールされた可能性のある、仮想デバイス・アグリゲートデバイス・リルーティング/ループバックデバイスやドライバーなど、サードパーティ製のデバイス/ドライバーの使用は避けてください。

参照: Playback


サウンドエフェクトの再生中にポップノイズやクリックノイズが断続的に発生する

再生中のオーディオドロップアウト(ポップ音やクリック音)は、通常、オーディオバッファのアンダーラン、つまりオーディオデバイスがオーディオストリームのレンダリングに追いつけないことが原因です。ドロップアウトを避けるには、SoundQのPreferences→Playbackタブで「Follow System Audio Output」オプションを無効にし、10.0ミリ秒以上のより大きなAudio Buffer Sizeを選択してください。ドロップアウトが解消しない場合は、オーディオストリームがクリーンになるまでバッファサイズを少しずつ増やしてください。参照: Playback


DAWからSoundQの再生をモニタリングできますか?

はい。SoundQはほとんどのサードパーティ製仮想デバイスやルーティングソフトウェアに対応しています。ただし、そうすることで再生の問題が発生する可能性があり、オーディオデバイスのルーティングに関する知識がある程度必要です。対応している方法には、macOSでの機器セットの使用、新しいバージョンのPro ToolsにおけるAux I/Oプラグイン、LoopbackやSource Nexusなどのサードパーティ製ルーティングソフトウェア/ドライバーの使用が含まれます。参照: SoundQ / DAWのモニタリング設定


一度に複数のサウンドをエクスポートできますか?

可能な場合と不可能な場合があります。現在、SoundQはクラウドからのサウンドのダウンロード/エクスポートを一度に1つずつしか行えません。ただし、ローカルのサウンドについては、SHIFTまたはCMD/CTRLで複数選択した上で、エクスポートまたはフォルダやその他のアプリケーションへのドラッグ&ドロップにより、一括でエクスポートできます。クラウドのサウンドを一括でダウンロードす���には、PSE Download Managerアプリケーションを使用して、所有/ライセンス済みのPSEサウンドライブラリをダウンロードしてください。


SoundQアプリケーションを起動すると、空白・黒・または空のウィンドウになる

一部のグラフィックカードやドライバーではOpenGLハードウェアレンダリングが正しくサポートされておらず、これが原因でSoundQのUIが正しく描画・更新されない場合があります。幸い、SoundQは古いシステムやグラフィックス向けにSoftware Renderingにも対応しています。SoundQをソフトウェアレンダリングオプションで強制的に起動するには、まず次の場所にあるSoundQのoptionsファイルを見つけてください。

macOS: ~/Library/Application Support/Pro Sound Effects/SoundQ/settings/options.xml

Windows: %appdata%\Pro Sound Effects\SoundQ\settings\options.xml

TextEditやメモ帳(またはVSCodeなどXMLを開けるアプリ)でoptions.xmlファイルを開き、次の行/オプションを探してください。

<DefaultRenderer value="OpenGL Renderer"/>

既存の行を置き換えるか、その行が存在しない場合は追加してください。

<DefaultRenderer value="Software Renderer"/>

最後に、options.xmlへの変更を保存し、SoundQを再起動してください。


エラー: Pro Tools/Premiere/Reaperが見つかりません

「Premiere/Pro Tools/Reaper/<DAW>が見つかりません」というエラーを解決するには、次の可能性のある問題を確認してください。

  • 対応する拡張機能がインストールされていない、または正しくインストールされていない場合があります。SoundQを再インストールし、インストール時に目的の拡張機能にチェックが入っていることを確認したうえで、OSのセキュリティに関するプロンプトや警告を必ず承諾・許可してください。拡張機能は個別に手動でインストールすることもできますが、その場合はSoundQ開発チームからの追加のサポートファイルが必要になることがあります(support@prosoundeffects.com までご連絡ください)。参照: Premiereチェックリスト
  • 対象のDAW(Pro Tools、Premiereなど)が別の仮想デスクトップ/モニターで最大化されていると、通信が途切れてしまう不可解な不具合が存在します。対象のDAWを同じデスクトップに移動する、またはウィンドウを元に戻すことで問題が解決する場合があります。
  • 特にmacOSでは、SoundQが他のアプリケーションと通信するために特定の権限が必要となるため、アクセシビリティや権限の問題が発生している可能性があります。OSはSoundQのインストール時にこれらの権限を要求しますが、見落とされることもあります。SoundQを再インストールし、OSからの権限リクエストを必ず許可することで問題が解決する場合があります。参照: macOSのアクセス権限(権限を手動で修正する方法)

トラブルシューティング

macOSのアクセス権限

OSのセキュリティを保つため、macOSはアプリケーションに対して、特定のタスクの実行やファイルシステムの特定の場所へのアクセスなどについて許可を求めることを要求します。また、こうしたリクエストはユーザーまたは管理者が許可する必要があります。SoundQは一般的なタスクの実行に特定の権限を必要とし、必要な箇所で許可を求めます。

SoundQでこれらのタスクのいずれかを初めて実行する際、macOSはアプリケーションを許可するかどうかの確認を表示し、その判断はシステム環境設定のセキュリティとプライバシー設定に保存されます。操作を許可するOSのプロンプトが拒否・見逃し・無視された場合、SoundQアプリケーションはそのタスクを実行できず、許可が得られるまで権限を要求し続けます。


概要

macOSのセキュリティとプライバシーのオプションは優れていますが、しばしば分かりにくく、さらに厄介なことに挙動が気まぐれで、混乱に拍車をかけることがあります。さらに、macOS VenturaではこれらのオプションのUIが大幅に変更され、他のシステム環境設定と一緒にまとめられました。幸い、SoundQが必要とするオプション自体は変わっておらず、変更されたのはUIのみです。

ほとんどの場合、通常の状況下では、アプリケーションが特定の権限を要求すると、macOSはオプションを許可するためにユーザーにパスワードを求め、Security & Privacyの該当する権限にSoundQを黙って追加します。ただし、SoundQの初回起動時や、Pro Toolsなど別のアプリケーションへサウンドを送信するなど特別な権限が必要な操作を初めて実行しようとする際には、権限を手動で追加する必要がある場合があります。

アクセス権限の設定

SoundQが、DAWのタイムラインへのサウンド送信など必要な操作を実行するための権限を持っていないことを検知すると、SoundQは次の「Permissions Required」プロンプトを表示することがあります。

macOSのAccessibilityアクセスをPro Toolsへのスポット送信のために有効にする手順を示すSoundQのPermission Requiredダイアログ

SoundQの権限を設定するには、システム環境設定→セキュリティとプライバシーを開き、以下のダイアログに従って、必要な各権限カテゴリにすべての権限が正しく設定されていることを確認してください。各カテゴリのリストにSoundQを追加するには、リストの下にあるプラス[+]ボタンをクリックし、表示されたFinderウィンドウで /Applications/SoundQ を参照・選択するだけです。

📝 メモ: 一部の権限はSoundQアプリケーション名/項目の下に「ネスト」されている場合があるため、該当する場合はSoundQの項目を必ず展開してください。


Automation

他のアプリケーション(Pro Tools、Reaper、Premiereなどの他のDAW)との通信:

  • PIDを照会して現在のDAWのプロジェクトファイルとアセットを特定します。
  • 特定のオプションを指定してDAWのタイムラインへファイルを送信するための共通API関数を呼び出します。

📝 メモ: ここに表示されているネストされたオプションはすべてチェックされていることを確認してください。

macOSのSecurity and Privacy設定のAutomation項目でSoundQに対しPro Tools System Events Finderが許可された状態

Files and Folders

Files and Folders: ユーザーのドキュメントフォルダや一般的なファイルシステムの場所へのファイルの読み書き。

Full Disk Access

Full Disk Access: ローカル���データベースサービスをインスタンス化して通信し、ローカルおよびネットワーク上のサウンドライブラリにアクセスします。

SoundQ.appがFull Disk AccessにチェックされているmacOSのSecurity & Privacy設定のPrivacyタブ

Accessibility

Accessibility: ネイティブのApple Scriptコマンドを呼び出してDAWとその設定を検出します(spot to timelineサポートにおいて、おそらく最も重要な権限です)。

SoundQ.appがAccessibilityにチェックされているmacOSのSecurity & Privacy設定のPrivacyタブ

📝 メモ: macOS Venturaでは、Security & Privacy設定は他のシステム環境設定と統合されましたが、カテゴリとオプションは同じです。

macOS Venturaのプライバシーとセキュリティ設定でAutomationなどの項目が並んだ画面

古くなったアクセス権限

まれに、以前許可されたアプリケーションへの参照が、許可済みリストに追加された後になぜか「古く」なり、Security & Privacyの許可済みリストに表示されているアプリケーションに付与された権限へアクセスできなくなることがあるようです。多くの場合これは、以前許可されていたバージョンのSoundQが古い場所を指したまま、SoundQを新しい場所へインストールしたことの影響です。というのも「許可済み」アプリはアプリ単位ではなくパス単位で管理されているためです。

前述の「気まぐれな」挙動は、幸い稀ではあるものの、パスだけでなくそれ以外の要因によっても、OSがアプリケーションを「新しい」「別のもの」とみなし、権限が「古く」なってしまうことがあるようです。なぜこのようなことが起こるのか開発チームに情報提供いただける場合は、詳細な経緯とともに engineering@prosoundeffects.com までご連絡ください。開発チームの見立てでは、.plistやバージョン、コード署名の変更が関係しているのではないか、とのことです。理由が何であれ、SoundQはすでに許可済みリストに含まれているにもかかわらず、再び権限を要求し始めることがあります。

このような状況では、次の手順で(上記の)各権限カテゴリのリストをもう一度確認することで、SoundQの権限を再び「定着」させるのが最も確実な方法のようです。

  1. 各権限カテゴリのリストからSoundQの項目を削除します。
  2. SoundQをゴミ箱にドラッグしてアンインストールし、マシンを再起動します。
  3. SoundQを再インストールして起動し、再度権限を要求させます。
  4. 上記の手順に従ってSecurity & Privacyの権限を再確認し、SoundQが各カテゴリで許可されていることを確認します。

📝 メモ: 手順2と3は、すべての状況で必要というわけではありません。データベースはアプリケーションの外部にあるユーザーのデータフォルダに存在するため、削除せずに安全に実行できます。


データベース / MongoDB

背景

SoundQは単なる魅力的なサウンド検索エンジンにとどまらず、ローカル・ネットワーク・クラウドといった複数のソースにまたがる複数のサウンドエフェクトライブラリを整理・編集・共有するための強力なツールでもあります。もちろんSoundQはローカルからクラウドまですべてのソースを検索でき、すべてのソースから同時に結果を提供します。

インターネットに接続している間、SoundQはPSEおよびサードパーティ製ライブラリの検索、そしてユーザーコレクションのクラウド上での共有・同期の両方について、PSE APIに大きく依存しています。つまり、APIサーバーのデータベースには、すべてのユーザーアカウントのCollectionsツリーの完全なコピーが保存されています。

しかし、ローカルおよびネットワークリソースを検索するために、SoundQはローカルライブラリやユーザーコレクションにアクセスするための独自のローカルデータベースにも依存しています。そして、そのローカルのサウンド(メタデータ)をクラウドAPIと同期・共有し、ローカルとクラウドの両方のデータベースが同一の状態を保てるようにしています。実際、この仕組みには冗長性という利点もあり、いずれかのデータベースに何らかの理由で障害が発生しても、もう一方から常に復元できます。

技術的な詳細

ローカルとクラウドのデータベース間の互換性と柔軟性を実現するため、SoundQはMongoDBを使用しています。MongoDBは、データをJSONオブジェクトとして保存・交換する「NoSQL」ドキュメント型データベースであり、Collectionsの「ツリー」やSound FXの「オブジェクト」といった構造に特に適しています。ただし、この方式には欠点もあり、より確立されたSQLソリューションが提供するようなプラットフォームや連携面でのサポートに欠ける場合があります。

SoundQアプリケーションが起動すると、既定のポート27017を使用してlocalhost(127.0.0.1)上でデーモン、いわゆる「サービス」としてローカルMongoDBサーバーを起動します。SoundQはその後、MongoDBクライアントインターフェースを実装してMongoDBサーバーと通信し、データ(コレクション、サウンドなど)の保存・取得を行います。SoundQが終了する際は、キュー内のデータベース操作をフラッシュした後、MongoDBサービスもシャットダウンします。つまり、MongoDBは別のソフトウェアプログラムではありますが、SoundQの依存関係として、SoundQが実行されている間のみ動作します。

起こりうる問題と解決策

MongoDBサービスはSoundQの起動時に開始されるため、何らかの理由でMongoDBサービスが起動または応答に失敗した場合、データがない状態となり、SoundQも起動に失敗します。通常この状況は起動時に検知され、SoundQは別のポートで別のMongoDBインスタンスを起動して復旧するか、失敗してデータベースを起動できなかった理由を報告・ログに記録します。


Firewalls

MongoDBはlocalhost経由でTCP/IP接続を受け付ける「サーバー」であるため、一部のファイアウォールやウイルス対策ソフトが接続を検証またはブロックする可能性があります。ただし、localhostの「IP」はローカルホスト(この場合は特にSoundQ)からの接続しか受け付けられないため、MongoDBサービスが外部からシステムにセキュリティ上のリスクをもたらすことはありません。SoundQチームはOSやサードパーティ製のファイアウォール/ウイルス対策ソフトに関する問題の報告を確認していませんが、何らかの理由でファイアウォールやウイルス対策ソフトが実行ファイルのパスを「許可」リストに手動で追加する必要がある場合、そのパスは次のとおりです。

macOS: /Applications/SoundQ/Contents/mongod

Windows: C:\Program Files\Pro Sound Effects\SoundQ\Contents\Resources\mongod.exe

参照: 許可リストへのURL登録

Busy Port

もちろん、ローカルデータベースの管理にMongoDBを使用しているのはSoundQだけではなく、他のソフトウェアが使用する別のMongoDBインスタンスと競合する可能性もあります。例えば、Avid Interplayを使用するAvid Media Composerのエンタープライズ版やネットワーク版の一部は、オーディオやビデオの「アセット管理」のためにMongoDBサービスを呼び出すことがあります。

MongoDBサービスは通常、複数のアプリケーション間で共有できません。それぞれのクライアントとモデルにのみ知られる固有のアカウントやドキュメントを提供しており、サーバーとクライアントインターフェースの特定バージョンを必要とするデータベースを参照している場合もあるためです。そのため、別のアプリケーションがすでに同じlocalhost:portでMongoDBサービスを実行している場合、ポートがビジー状態となり、自身のサーバーインスタンスを起動できない他のアプリケーションに問題が生じる可能性があります。

幸い、SoundQはより高度な起動ルーチンを実装しており、SoundQ自身とその依存関係の両方が確実に読み込まれ、利用可能になるよう配慮しています。この場合、SoundQは自身に属さない別のMongoDBインスタンスを検知すると、別のポート(例: 27018、27019、…)を使用してサービスを実行します。あるいは、SoundQが自身に属する既存のサービスを見つけた場合は、新しいサービスを起動する代わりにその既存のサービスを使用します。さらに、応答しなくなった「自身が所有する」MongoDBサービスを見つけた場合は、そのサービスを安全にシャットダウンしようとします。まれに、サービスの起動または停止が何らかの理由で失敗する場合、SoundQは諦める前に数回試行します。

残念ながら、MongoDBサービスに依存する他のソフトウェアアプリケーションが、このような堅牢な起動ルーチンを実装していない場合もあり、SoundQ(または他の任意のアプリケーション)がすでに既定のポート(27017)でMongoDBインスタンスを起動していると、単純に失敗したり諦めたりすることがあります。そして、MongoDBの「クラスター」機能を除けば、MongoDBはこうしたケースを処理するための高度なサービス管理機能を提供していないようです。そのため、ワークステーションやDAW、あるいはワークフローが複数のMongoDB依存アプリケーションを実行している場合の回避策としては、より融通の利かないアプリケーションを先に起動して、それが唯一認識しているポート(既定: 27017)でMongoDBインスタンスを起動させ、最後にSoundQを起動することで、SoundQは静かに次に利用可能なポートで自身のMongoDBサービスを起動します。

Lockups

MongoDBやSoundQのMongoDBクライアントが、回復不能なエラーに遭遇してクラッシュしたりハングしたりする可能性もあります。前者の場合、SoundQは可能であればエラーを報告した後にシャットダウンします。後者の場合、SoundQは応答しなくなったサービスを検知し、再起動を試みたり、別のサービスインスタンスを起動したりすることで復旧できます。

何らかの理由でMongoDBサーバープロセスを手動で強制終了または再起動する必要がある場合、Windowsではタスクマネージャー、macOSではアクティビティモニタで「mongod」プロセスを検索し、タスクマネージャーのプロセスのコンテキストメニューから「タスクの終了」を選択するか、アクティビティモニタの「停止」ボタンを使うことで停止できます。

📝 メモ: 複数のアプリケーションによって起動された複数のmongodサービスが同時に実行されている場合があるため、注意して、停止したいサービスと親プロセスが一致していることを確認してください。タスクマネージャーでは、mongodはSoundQプロセスの下にネストして表示されます。またアクティビティモニタでは、「インスペクト」または「情報」ボタンをクリックすると親プロセスが表示されます。

Corruption

最後に、非常にまれなケースとして、ローカルデータベースが破損し、MongoDBサービスがデータベースを読み込めなくなり、その結果SoundQの起動も失敗することがあります。これは基本的に、MongoDBが理解できないデータベースやドキュメント構造を読み込もうとしたことを意味します。これは、もはやサポートされていない古いバージョンのデータベースの読み込みをMongoDBが求められた場合や、書き込み処理の中断などによってデータ自体が破損した場合に起こり得ます。この場合も、MongoDBはエラーの検証や修復をかなりうまく行うため極めてまれですが、こうした場合にこそ、クラウドAPIデータベースが提供する冗長性が役立ちます。すべての手段を尽くしても解決しない場合は、次の対応をしてください。

  • 「data」フォルダをコピー・圧縮し、DropboxやGoogle Driveなどのファイル共有サービス経由で共有して、破損したデータベースのバックアップを support@prosoundeffects.com に送付してください(データが非常に大きくなる場合があるため)。

macOS: ~/Library/Application Support/Pro Sound Effects/SoundQ/data

Windows: %appdata%\Pro Sound Effects\SoundQ\data

作業を継続するには、既存の「data」フォルダを削除してSoundQを再度起動してください。SoundQは新しいデータベースを作成し、ログイン後にクラウドからデータベースの同期を開始します。

📝 メモ: クラウドAPIデータベースは、ローカルシステム上のSoundQユーザーによって作成されたローカルの「System」Collectionsを認識していないため、クラウド経由では復元できません。ただし、「My Collections」配下のすべてのCollectionsは、最後の同期時点の状態に復元されます。


インターネット接続

SoundQは、社内・サードパーティを問わず複数のソースにまたがる複数の巨大なクラウドライブラリを検索するために、PSE APIに依存しています。これらのソースはすべてAPIおよびSoundQインターフェース内で自動的に集約されますが、各ソースはそれぞれ独自の接続上の問題や応答時間などの影響を受ける可能性があります。

SoundQは現在PSEサーバーからオーディオファイルを一括ダウンロードすることはありませんが、検索機能やコレクション同期などのバックグラウンドタスクでは、SoundQとPSE APIサーバー間で相当量のデータおよびメタデータの転送が発生します。

これらの要因を踏まえると、SoundQには最適なパフォーマンスと快適な使用感のために、高速で信頼性の高いインターネット接続が必要です。


Download Manager

SoundQへのログインに使用したアカウントでご購入いただいたPSEクラウドサウンドライブラリには、すべてSoundQからアクセスできます。SoundQは、ローカル/ユーザーライブラリに追加されたクラウドサウンドに関連するすべてのメタデータをダウンロード・キャッシュしますが、現在のところ関連するサウンドファイルを一括ダウンロードするオプションは提供していません。ワークフローによっては、お持ちのライブラリをローカル(内蔵・外付け・ネットワークドライブ)にダウンロードしておく必要がある場合があります。現在PSEでは、所有・購入済みのすべてのPSEオーディオライブラリのダウンロードを管理するための専用ツール「Download Manager」を提供しています。PSE Download Managerは、こちらのWebサイトからmacOSおよびWindows向けにダウンロード・インストールできます: Download Manager

接続のトラブルシューティング

SoundQでのサウンド検索時に、動作の遅さやタイムアウト(サーバーの応答不足により検索結果が0件になる場合)などの問題が発生する場合、考慮すべき要因がいくつかあります。

  • ファイアウォール/ウイルス対策ソフト: マシンにインストールされたファイアウォールやウイルス対策ソフトが、依存する1つ以上の接続やサービス(localhost上で実行されているローカルのmongoデータベースサービスなど)をブロックしている可能性があります。この問題を解決するには、許可リストへのURL登録に記載されているとおりすべてのソースドメイン/IPが許可リストに登録されていること、およびlocalhost:port(例: 127.0.0.1:27017)がmongoサービス用にアクセス可能・利用可能であることを確認してください。後者の場合、localhostのmongodへの接続がブロックされていると、SoundQが正常に起動できなくなることもあります。
  • サーバー負荷: 1つ以上のサウンドライブラリのソースサーバーがメンテナンス中であったり、サーバー負荷が高くなっていたりして、応答が遅くなったり空になったりする可能性があります。特定のライブラリソースがSoundQ内で遅い、または応答しない場合、そのソースサーバーにブラウザーウィンドウから直接アクセスしてみる(例: freesound.orgなどのURLを読み込む)ことで確認できることがよくあります。サーバーが混雑していない可能性が高い時間帯(例: 深夜)に再度接続を試してください。応答しないソースは、Collectionツリーでそのソースの選択を解除(チェックを外す)することで、SoundQの検索から除外することもできます。これにより、「調子の悪いソース」が他のソースの検索速度を低下させるのを防げます。
  • サーバーの所在地: クラウドおよびコロケーションサーバーは一定の冗長性を提供しますが、PSE APIデータベースサーバーは北米(米国)に設置されているため、SoundQクライアントとの接続には固有のレイテンシーが伴います。北米のサーバーとの接続が地理的に不利な地域(例: 日本、オーストラリアなど)にお住まいの場合は、より良いルーティングや高速な接続を提供できる可能性のある別のISPやサービスを検討する価値があるかもしれません。

接続の問題や特定のソースの問題が解消しない場合は、メールまたはSlackでPSE/SoundQサポートまでご連絡ください。


SoundQ拡張機能

SoundQ拡張機能は、SoundQのインストール時に既定でインストールされます。これらの拡張機能は任意であり、インストーラーでチェックを外すことでインストールをスキップできます。拡張機能のインストールに失敗した場合や、SoundQがDAWのタイムラインへサウンドをスポッティングしようとした際にターゲットアプリケーションが見つからないと報告する場合は、インストーラーを管理者権限で(例: 「管理者として実行」)再度実行し、拡張機能を適切な場所へインストールするための十分な権限がインストーラーにあることを確認してください。


Pro Tools

Pro Toolsの機能およびスポッティングのサポートは、現在別の拡張機能を必要とせず、Pro Toolsとのすべての通信はOSおよび/またはネイティブのスクリプトサポートを通じてSoundQによって直接処理されます。

現在のところ、Pro Tools拡張機能のインストールや機能に関して既知の問題はありません。問題が発生した場合は support@prosoundeffects.com までご報告ください。

Reaper

SoundQ Reaper Extensionは、他のサードパーティ製拡張機能と同様に、ReaperのUserPluginsディレクトリにインストールされます。

Windows: %APPDATA%/REAPER/UserPlugins

macOS: ~/Library/Application Support/REAPER/UserPlugins

何らかの理由でインストールに失敗する場合は、SoundQインストーラーを管理者として実行してみてください。

現在のところ、Reaper拡張機能のインストールや機能に関して既知の問題はありません。問題が発生した場合は support@prosoundeffects.com までご報告ください。

Premiere

SoundQ Premiere Extension(「PSE Premiere Panel」)は、SoundQとAdobe Premiere間の通信を実現するためにAdobe CEP(Common Extensibility Platform)エンジンを使用します。CEP拡張機能には、すべてのAdobe Creative Suiteアプリケーションに付属するAdobe Extension Managerが必要です。この拡張機能は、対応する製品がシステムにすでにインストールされていない限りインストールできません。

残念ながら、ほとんどの場合、SoundQインストーラーからExtension Managerを呼び出すことは現実的ではない、あるいは不可能です。そのためSoundQインストーラーには、Premiere拡張機能のインストールを容易にするために、Adobe ExManCmd(Extension Manager コマンドラインインターフェース)が同梱されています。

残念ながらExManCmdは、それがサポートを謳っているすべてのシナリオや要件をサポートしているわけではないようで、実際にはAdobe Premiereや対応製品がインストールされているにもかかわらず、それらが見つからないと主張してPremiere拡張機能のインストールに失敗する場合があります。次のチェックリストは、拡張機能とその依存関係が正しくインストールされているかどうかを確認するのに役立ち、問題や解決策のさらなる調査にも役立ちます。チェックリストで解決しない場合、サポートから、SoundQインストーラーが失敗した場合でも通常は動作する、拡張機能用の手動インストーラーを依頼できます。

  1. SoundQ Premiere Extensionが正しくインストールされていることを確認する
    • 最新のSoundQインストーラーを実行し(既存の設定は上書きされません)、コンポーネント選択の段階で「SoundQ Premiere Pro Plugin」オプションが選択されていることを確認してください。

Windows版SoundQインストーラーのコンポーネント選択画面 Reaper ExtensionとPremiere Pro Panelにチェックが入った状態

macOS版SoundQインストーラーのカスタムインストール画面 Reaper ExtensionとPremiere Extensionが選択された状態

⚠️ ご注意: インストール中に、以下のセキュリティに関するプロンプトが表示される場合があります。

  • Windows: UAC(ユーザーアカウント制御)ダイアログで「はい」をクリックしてインストールを許可します。
  • macOS: セキュリティダイアログでユーザーパスワードを入力してインストールを許可します。
  • インストールを完了し、インストーラーのログをデスクトップに保存してください。
    • Windows: 通常どおり「次へ」「完了」でインストールを進めます。次の場所にあるインストーラーログを見つけ、デスクトップへコピーしてください: C:\Users\<username>\AppData\Local\Temp\Setup Log 2023-MM-DD.txt。手順2へ進んでください。
    • macOS: 「次へ」をクリックし、「概要」ページに到達するまでインストールを続けます。「閉じる」をクリックする前に、「ウィンドウ」→「インストーラーログ」メニューを選択します。ログウィンドウで「すべてのログを表示」を選択し、ログをデスクトップに「保存」した後、手順2へ進んでください。

macOSのインストーラーログを保存するダイアログで保存先にデスクトップを指定した状態

  1. SoundQからPremiereへのサウンド転送を準備する
    • SoundQを起動し、続けてPremiereを起動します。
    • 転送するサウンドをSoundQで選択します。
    • SoundQで「Premiere」をSend Toターゲットとして選択します(パスのオプションは既定のままにしておきます)。
    • まだ送信(緑色の矢印)はクリックしないでください。

Send ToメニューでAdobe Premiereをターゲットに選択した状態

  1. SoundQ→PremiereのOS権限を確認する(Macのみ)
    • Appleメニュー(左上のメニューバー)から「システム設定」を開きます。
    • 「プライバシーとセキュリティ」タブに移動し、次のカテゴリでSoundQが追加・有効になっていることを確認します。
      • Files and Folders
      • Full Disk Access
      • Accessibility
      • Automation

📝 メモ: 「プライバシーとセキュリティ」パネルの見た目はmacOSのバージョンによって異なる場合がありますが、含まれるカテゴリは上記の4つと同じです(4つすべてを確認してください)。

macOSのプライバシーとセキュリティ設定のAutomation画面でSoundQに対しFinder System Events Pro Toolsが有効になっている状態

  1. SoundQ Premiere Extensionが正しく動作していることを確認する
    • Premiereの「ファイル」メニューから新規プロジェクト(.prproj)を開くか作成します。
    • 「ウィンドウ」→「拡張機能」メニューを選択し、拡張機能の一覧に「PSEPremierePanel」が含まれていることを確認します。

Premiere Proのウィンドウメニューから拡張機能を開きPSEPremierePanelが表示された状態

  1. SoundQからPremiereへのサウンドファイル転送を実行する
    • SoundQで「Send To」ターゲットとして引き続き「Premiere」が選択されていることを確認します。
    • ターゲットの隣にある緑色の矢印ボタンをクリックして転送を実行します。

📝 メモ: エラーが発生した場合は、エラーの文面をメモまたはスクリーンショットしてください。「Premiereが見つかりません」というエラーが表示される場合は、Premiereがフルスクリーンモードや最小化された状態になっていないか確認してください。

  1. Adobe CreativeCloudのログファイルを探し、デスクトップにコピーする
    • Windows: C:\Users\<username>\AppData\Local\Temp\CreativeCloud\ACC\ACC.log
    • macOS: /Users/<username>/Library/Logs/CreativeCloud/ACC/ACC.log
  1. Premiere Proのバージョンを確認する
    • 「ヘルプ」→「Premiere Proについて」メニューを選択し、スプラッシュ画面のスクリーンショットを作成します。
      • Windows: [Windowsキー]+[Shift]+[S]
      • macOS: [Command]+[Shift]+[4]
    • スクリーンショットをデスクトップに保存します。

バージョン23.1.0を示すAdobe Premiere Proのaboutスクリーン

  1. OSのバージョンを確認する
    • Windows: スタートメニューを右クリックして「システム」を選択します。Windowsの仕様の隣にある「コピー」をクリックし、メールの返信に貼り付けます。
    • macOS: Appleロゴ→「このMacについて」を選択し、macOSのバージョン番号をメールの返信にコピー&ペーストします。
  1. このチェックリストの中でデスクトップに保存したすべてのファイルを圧縮し、support@prosoundeffects.com への返信に添付する
    • 手順1のインストーラーログ
    • 手順6のCreative Cloudログ
    • 手順7のPremiereバージョン情報

それでも解決しない場合は、support@prosoundeffects.com にPremiereプラグイン用の手動インストーラー(.zip)を依頼できます。

  • 提供されたインストーラーに含まれるreadme.txtの手順に従ってください。

サポートへのお問い合わせ

理由や緊急度に応じて、開発者自身を含む適切なサポート担当者に連絡するためのチャネルをいくつかご用意しています。ほとんどのサポート案件では、サポートチームへメールを送ることが最善の方法です。通常24時間以内に返信があり、メールは問題解決までの経過を追跡するのにも役立ちます。サポートは、DiscordやSlackのチャンネルでも受けられるほか、ベータ版やフィードバックのチャンネルにアクセスして新機能について学んだり、提案したりすることもできます。DiscordやSlackは「公式」なサポートチャネルではありませんが、開発者は普段からここに出入りしており、チャットでリアルタイムに対応してくれる人が見つかることも珍しくありません。

特定の問題についてサポートに問い合わせる前に、問題解決に役立つログやスクリーンショットなど、追加情報を用意しておくことをおすすめします。いずれにせよ、次のいずれか(または複数)をお願いすることになる可能性が高いです。


ログファイル

SoundQのご使用中に問題が発生したほぼすべてのケースにおいて、アプリケーションのログファイルは問題の追跡に非常に役立ちます。SoundQは実行中、動作中に発生したエラーや警告を含む、さまざまな(ユーザーを特定できない)情報をログに記録します。ログには、SoundQのランタイム動作の詳細、およびデータベースやAPIとの通信内容が含まれます。問題が持続的かつ再現可能な場合は、Preferences Panelからログレベルを上げて追加情報を収集することもできます。参照: ログレベル

SoundQ.logファイルは、次の診断用フォルダにあります(参照: ユーザーデータ / ログ)。これらのファイルが見つからない場合は、隠しフォルダの表示を参照してください。

Windows: %AppData%\Pro Sound Effects\SoundQ\diagnosticlogs\soundq.log

macOS: ~/Library/Application Support/Pro Sound Effects/SoundQ/diagnosticlogs/soundq.log

画面録画 / キャプチャ

まず、問題をスクリーンショットで示すのが適切か、それとも録画によるデモンストレーションが適切かを判断してください。録画はできるだけ短く、要点を絞ったものにしてください。


macOS

スクリーンショットや録画を作成するには、Shift + Command + 5 を押してスクリーンショットツールバーを開きます。

画面を録画する:

  • ツールバーで録画のオプションを選択し、「収録」をクリックします。
  • 録画を停止するには、Command + Control + Escape を押します。

画面をキャプチャする:

  • ツールバーで「画面全体」または「選択したウィンドウ」を選び、SoundQアプリをクリックします。
Windows

スクリーンショットや録画を作成するには、スタートメニューの検索バーに「Snipping Tool」と入力します。

画面を録画する:

  • 上部のツールバーで録画ボタンを選択し、「新規」をクリックします。
  • 録画したい画面の範囲をドラッグ&ドロップで囲みます。
  • 「開始」をクリックして録画を開始し、録画終了時に「停止」をクリックします。

画面をキャプチャする:

  • 上部のツールバーで(録画ボタンの隣にある)切り取りボタンを選択し、「新規」をクリックします。
  • 「ウィンドウモード」を選択してSoundQアプリをクリックするか、キャプチャしたい画面の範囲をドラッグ&ドロップで囲みます。

キーボード / ショートカット

次の表は、SoundQで使用できるすべてのキーボードショートカットを、コマンドを受け取るUIコンポーネントごとにグループ化して示したものです。

📝 メモ: 「Main Window」のコマンドは、現在どのパネルにフォーカスがあるかに関わらず呼び出せるグローバルなショートカットです。各パネル固有のコマンドは、現在フォーカスがあるパネル(直前にクリックまたはTABで移動したコンポーネント)でのみ呼び出せます。


Main Window

操作ショートカット
次のパネルにフォーカスTab
前のパネルにフォーカスShift + Tab
Preferencesウィンドウを表示Cmd/Ctrl + ,
データベースを検索/
検索をクリアCmd/Ctrl + Return
Collections Panelの表示/非表示Cmd/Ctrl + 1
File Info Panelの表示/非表示Cmd/Ctrl + 3
Import Panelの表示/非表示Cmd/Ctrl + 4
アプリケーションを終了Cmd/Ctrl + q

Collections Panel

操作ショートカット
次のコレクションを選択↓
次のコレクションを選択に追加Shift + ↓
前のコレクションを選択↑
前のコレクションを選択に追加Shift + ↑
コレクションを展開(サブ項目を表示)→
コレクションを折りたたむ(サブ項目を非表示)←
範囲を選択に追加Shift + クリック
コレクションを選択に追加/削除Cmd/Ctrl + クリック
コレクションの次のページへスクロールPage Down
コレクションの前のページへスクロールPage Up
コレクションリストの末尾へスクロールEnd
コレクションリストの先頭へスクロールHome
現在の選択を削除Del
すべてのコレクションを選択(すべて検索)Cmd/Ctrl + a
すべてのコレクションの選択を解除(検索をクリア)Cmd/Ctrl + d

Results List

操作ショートカット
次の結果を選択↓
次の結果を選択に追加Shift + ↓
前の結果を選択↑
前の結果を選択に追加Shift + ↑
範囲を選択に追加Shift + クリック
結果を選択に追加/削除Cmd/Ctrl + クリック
結果の次のページへスクロールPage Down
結果の前のページへスクロールPage Up
現在読み込まれている結果の末尾へスクロールEnd
結果の先頭へスクロールHome
選択した結果をデータベースから削除Cmd/Ctrl + Del
選択した結果をデータベースから削除Cmd/Ctrl + Backspace
すべての結果を選択Cmd/Ctrl + a
サウンドをターゲット(コレクション)へ送信t
メタデータ項目を編集Opt/Alt + クリック
並べ替えをリセットCtrl + r

Waveform Panel

操作ショートカット
選択範囲を現在のエクスポートターゲットへ送信s
再生速度を設定0-9
Fade Inを編集d
Fade Outを編集g
現在のリージョン選択をクリアEsc
再生/一時停止Space
逆再生/順再生r
5秒巻き戻し←
5秒早送り→
先頭にシークReturn

許可リストへのURL登録

手動でのURL許可登録が必要なファイアウォール環境の場合、SoundQは標準的なHTTP/S通信(ポート80および443)のためにlocalhostに加え、次のドメイン/URLへのアクセスを必要とします。

  • www.prosoundeffects.com
  • teams.prosoundeffects.com
  • hello.prosoundeffects.com
  • prosoundeffects.b2clogin.com
  • prosoundeffects.blob.core.windows.net
  • api.prosoundeffects.com
  • soundplow.prosoundeffects.com
  • identity.prosoundeffects.com
  • cdn.prosoundeffects.com
  • api-staging.prosoundeffects.com
  • api-preview.prosoundeffects.com
  • api-beta.prosoundeffects.com
  • app.prosoundeffects.com
  • api.melod.ie
  • tracks.melod.ie
  • freesound.org

SoundQのアプリ / データの保存場所

インストール

SoundQは、アプリケーションのインストール場所とユーザーデータの保存場所についてOSのガイドラインに従います。アプリケーションは次のいずれかの単一の場所にインストールされます。

Windows: C:\Program Files\Pro Sound Effects\SoundQ\

macOS: /Applications/SoundQ/

アプリケーションが初めて実行されるまでは、ユーザーデータには何もインストールされません。初回実行時に、SoundQは標準的なユーザーデータの保存場所にデータベースと設定ファイルを作成します。

Windows: %APPDATA%\Pro Sound Effects\SoundQ\

macOS: ~/Library/Application Support/Pro Sound Effects/SoundQ/

📝 メモ: %APPDATA% とチルダ「~」は、ユーザーの現在のデータフォルダまたは「ホーム」ディレクトリを指すショートカットであり、次の場所に解決されます。

Windows: %APPDATA% → C:\Users\<username>\AppData\Roaming\

macOS: ~ → /Users/<username>/

<username>は現在のユーザー名です。


隠しフォルダの表示

Windows・macOSともに、既定でユーザーから特定のフォルダを隠していることは珍しくありません。これは主に、初心者がこれらのフォルダ内のものを誤って削除してしまうのを防ぐためのものですが、それ以外のユーザーにとっては煩わしく感じられることもあります。隠しフォルダを表示するには、次の手順に従ってください。

Windows:

  1. タスクバーからFile Explorerを開きます。
  2. 「表示」→「表示」→「隠しファイル」を選択します。

macOS:

  1. DockのLaunchpadからターミナルアプリを開きます。
  2. コマンドプロンプトで「defaults write com.apple.Finder AppleShowAllFiles true」と入力し、Returnキーを押します。
  3. 「killall Finder」と入力し、再度Returnキーを押します。

メインアプリケーション

SoundQのメインアプリケーションフォルダには、SoundQアプリケーション本体、ローカルデータベースサービス(mongod)、そして画像・フォント・翻訳・ドキュメントなど、実行時にアプリケーションが使用する各種サポートファイルが含まれます。これらの場所にはユーザー固有のデータは保存されておらず、これらの場所からSoundQをアンインストールしても、ユーザー固有のSoundQデータや設定が削除されることはありません。


Windows:

  • %PROGRAMFILES%
    • Pro Sound Effects
      • SoundQ
        • Contents
          • Resources
            • Images
            • Themes
            • Translations
          • mongod.exe
          • SoundQ.exe

    macOS:

    • /Applications
      • SoundQ.app
        • Contents
          • Resources
            • Images
            • Themes
            • Translations
          • mongod
          • macOS
            • SoundQ

      ユーザーデータ / ログ

      SoundQのすべてのユーザーデータと設定は、ユーザーのアプリケーションデータフォルダに保存されます。このフォルダの場所は通常OSによって指定され、OSのバージョンによって異なる場合があります。このフォルダには、サウンドや画像(アルバムアート)のキャッシュ、オフラインキー、アナリティクス、アプリケーションログ、そしてSoundQのユーザーコレクション用ローカルMongoDBデータベースを含むローカルデータベースフォルダなど、あらゆるものが含まれています。このフォルダには、バージョンアップデート時にSoundQインストーラーが作成したデータベースのバックアップも保存されます。このディレクトリ内で特に重要なフォルダは次のとおりです。

      • Analytics: アプリケーションの起動パラメータ、オーディオデバイスと設定、メモリおよびCPUの統計情報など、特定の分析イベントを記録します。このフォルダは削除しても問題ありません。
      • Data: MongoDBのローカルデータベースファイルはすべてこのフォルダに含まれています。このフォルダの削除は自己責任で行ってください。削除すると、ユーザーが作成したSystem Collectionsとサウンドの参照(実際のサウンドファイルは削除されません)がすべて削除されます。データベースが破損している場合は、削除する前にサポートまでご連絡ください。このフォルダが削除されると、新しい(空の)データベースが作成され、クラウドベースのコレクションはクラウドから再同期されます。
      • Diagnostic Logs: このフォルダには、SoundQの実行時における重要なログ情報が含まれており、テクニカルサポートが問題やバグを追跡・修正するためのエラー・警告・一般的なタスクを記録します。
      • Settings: このフォルダには、オーディオデバイス設定やPreferences Panelからのその他のユーザー固有オプションなど、グローバルおよびユーザー固有のアプリケーション設定と情報を保存する設定ファイルが含まれます。設定には、アプリケーションの直前のサイズや位置、以前選択・展開されていたコレクションなど、セッション固有のデータも含まれます。このフォルダを削除すると、すべての設定が既定値にリセットされ、次回のSoundQセッション時にフォルダが再作成されます。
      • data.YYY.MM.DD_backup: ファイル名のタイムスタンプ時点でのMongoDBコレクションデータベースの完全なバックアップです。これは安全に削除するか、「data」にリネームしてバックアップを復元することができます。参照: バックアップとダウングレード

      Windows:

      • %APPDATA%
        • Pro Sound Effects
          • SoundQ
            • Analytics
            • data
            • diagnosticlogs
            • Settings

      macOS: