Wwise Authoring APIの初期化
Wwise Authoring API（WAAPI）の実行は、選択したプロトコルと言語によって異なります。しかし、これらに関係なく、まずWwiseを実行し、Wwise Authoring APIでそのAPIを使用できるようにする必要があります。
- Wwiseで、Project > User Preferences を選択します。（デフォルトショートカットは Shift + U）
- グループボックスWwise Authoring APIで、Enable Wwise Authoring APIを選択する。
- OK をクリックして、Wwiseを再スタートしてください。
つまり、これはWAAPIコードを書けることを意味しています。しかし、まず、 ネットワーク・セキュリティを確認してください！
ネットワーク・セキュリティ
WAAPIはリモートでWwiseを制御できるため、他の人がコンピュータを制御できないように、安全な環境で使用する必要があります。
WAAPIポートへのアクセスをブロックする
WAAPIはWAMPとHTTP用の2つのポートへのアクセスを提供します（デフォルトでは8080と8090）。これらのポートは、自分のマシン上で直接、または社内のファイアウォール設定（LAN上でWAAPIを使用する場合）のいずれかで、ファイアウォール設定でブロックする必要があります。
クロスサイトスクリプティングの防止
WAAPIは、クロスサイトスクリプティングに対してセキュリティレイヤーを提供します。それ以外の場合、たとえばJavaScriptコードを含むWebページにアクセスすると、読み込まれたWebページから接続することによって、理論的にWwiseにアクセスすることができます。このシナリオでは、ファイアウォールでは十分ではありません。
このWAAPIセキュリティ・レイヤーは、ブラウザのセキュリティ設定に依存します。デフォルトでは、WAAPIはローカルソフトウェアからの接続のみを受け付けます。ブラウザの場合は、ローカルファイルシステム上でHTMLファイルを開くときに限ります。 これらのデフォルトのセキュリティ設定は、User Preference の Allowed Origins フィールドに次のように表示されます：
- #unknown：ブラウザ以外のソフトウェアからの接続を許可します（元のHTTPヘッダーなし）
- #file ：（サーバーではなく）ファイルシステムから直接ロードされたWebページからの接続を許可します
User Preference でホストを追加しない限り、別のホストからロードされたWebページでWAAPIを使用すると失敗します。WAAPIの有効な起点としてホストを追加するには：
- メインのWwiseメニューから Project > User Preferencesをクリックします。
- ホストURIを Allowed Origins フィールドに追加します。例：
- http://www.myhost.com、ポート80と仮定して、または
- http://www.myhost.com:1234、デフォルト80ではなく、1234です。
- OK をクリックし、Wwiseを再起動します。
|
Caution: 任意のWebページからの接続を許可するには、* を追加できます。しかし、これは安全ではないため、推奨されません。 |
コマンドラインから "-Waapi"コマンドを使用する方法については、コマンドラインを使うを参照してください。
|
Note: 複数接続の使用 WAAPIは複数接続からの使用を一度にサポートします。WAAPIへのアクティブ接続の現在の最大数は、WAMPの場合は20に加えて、HTTP POSTの場合が20です。 |
Next Step
WAAPI サンプルのいずれかに従って、WAAPIを試してみることができます。これは、好みの言語とプロトコルでWAAPIを実行する方法を示します。