バージョン
menu_open
警告：このページでは、一部の保護された情報が表示されません。
あなたが特定プラットフォームのライセンスを所有しているユーザであれば、最初にログインしてください。
Wwise SDK 2019.2.15
システム特有のイベントの処理

ほぼすべてのオペレーティングシステムで、次のイベントに対するコールバックもしくは通知があります:

  • ホームボタンを押す
  • アプリケーションをバックグラウンド/フォアグラウンドに置く
  • ユーザミュージックの開始と停止

これらのイベントはWwiseによって自動的に扱われることはありません。理由は、いくつかのOS APIが複数のコールバックもしくは通知の受け取りを許さないためです。従って、ゲームではなく、Wwise SDK に対してこれらのイベントを通知する必要があります。

ユーザーミュージックの置き換えの扱い方についての詳細は、 ユーザーミュージック（BGM）やDVRの取り扱い を参照してください。

バックグラウンド/フォアグラウンドのアプリケーション

一般的に、すべてのゲームシステムは、アプリケーションを一定の時間バックグラウンドに置くことができます。Wwiseでは、設定やプラットフォームの要件によって、3つの可能な動作があります:

  • すべてのオーディオレンダリングを一時停止するには: AK::SoundEngine::Suspend(false) を呼び出します。
  • 一部を一時停止するには（イベントの処理は続けますが、オーディオレンダリングはしません）: AK::SoundEngine::Suspend(true) を呼び出します。ゲームが実行中で、サウンドエンジンに呼び出しを送っている場合、この方法は有用です。
  • オーディオを再生し続ける: 何もする必要はありません。

一般的に、アプリケーションがバックグランドに回され、 Suspend(false) が使われるときは、ゲームはサウンドエンジンのAPIを呼び出すべきではありません。イベントのポストなどは動作しますが、蓄積されてシステムが動き出した際、すべてが同時に再生されます。オーディオ処理を再開するには、AK::SoundEngine::WakeupFromSuspend() を呼び出し、システムから適切な通知を受けた際、RenderAudio() を呼び出します。RenderAudio()を呼び出す前に、他のイベントがキューを作るかもしれません。

正しい動作を選択するには、製造会社の説明書にある各プラットフォームの要件を参照してください。

Android

Androidでは、App Lost/Gain FocusイベントやApp Pause/Resumeイベントを処理することが重要です。Googleの要件では、フォアグラウンドにないアプリは、できるだけ最小限のCPUを使用するべきとしています (できればCPUの使用なし)。これは、 Suspend(false) を呼び出すことで達成できます。 AndroidでのBGM設定詳細 もご参照してください。

iOS

Appleは、アプリケーションがバックグラウンドにある場合には、できるだけ最小限のCPU使用によう求めています。Wwiseは、自動的にこのような処理を行います。 iOSでのBGM設定詳細 もご参照してください。

macOS

macOS用の公式ガイドラインはありませんが、アプリケーション処理がアクティブでない場合は Suspend() でサウンドをカットするのが、ほかのプラットフォームと一致します。ハード的停止 (false パラメータ) もしくは能動的な停止 (true パラメータ) のどちらを利用するかは、ゲームの実装に依存します。

Linux

Linux用の公式ガイドラインはありませんが、アプリケーションがアクティブでない場合は、 Suspend() でサウンドをカットするのが、ほかのプラットフォームと一致します。ハード的停止 (false パラメータ) もしくは能動的な停止 (true パラメータ) のどちらを利用するかは、ゲームの実装に依存します。

Windows

Windowsの明示的な要件はありませんが、アプリケーションがフォアグラウンドにないときにオーディオをミュートすることが、通常望まれます。これを行うには、Ak::SoundEngine::Init()を呼び出す際、メインウィンドウの hWnd を AkPlatformInitSettings 構造体に渡します。この場合、オーディオスレッドは実行され続けます（ Suspend(true) に相当）。これはOSが処理を行います。

または、WM_SHOWWINDOW メッセージを処理し、ウィンドウが最小化された場合、オーディオをフェードアウト、またはSuspend()を直接呼び出すなど、何かより具体的なことを行います。

UWP

UWPの明示的な要件はありませんが、アプリケーションがフォアグラウンドにないときにオーディオをミュートすることが、通常望まれます。そのためにはSuspend() と WakeupFromSuspend() を、 それぞれCoreApplication.EnteredBackground と CoreApplication.LeavingBackground のイベントハンドラで呼び出します。

このページはお役に立ちましたか？

サポートは必要ですか？

ご質問や問題、ご不明点はございますか？お気軽にお問い合わせください。

サポートページをご確認ください

あなたのプロジェクトについて教えてください。ご不明な点はありませんか。

プロジェクトを登録していただくことで、ご利用開始のサポートをいたします。

Wwiseからはじめよう