バージョン

menu_open
Wwise SDK 2023.1.7

◆ LoadBank() [2/4]

AKSOUNDENGINE_API AKRESULT AK::SoundEngine::LoadBank ( AkBankID  in_bankID,
AkBankType  in_bankType = AkBankType_User 
)

Loads a bank synchronously (by ID).

注釈: Requires that the "Use SoundBank names" option be unchecked in the Wwise Project Settings.

The bank ID is passed to the Stream Manager. Refer to 概説 for a discussion on using strings and IDs. A bank load request will be posted, and consumed by the Bank Manager thread. The function returns when the request has been completely processed.

戻り値
  • AK_Success: Load or unload successful.
  • AK_BankAlreadyLoaded: This bank is already loaded, nothing done.
  • AK_InsufficientMemory: Insufficient memory to store bank data.
  • AK_BankReadError: I/O error. The bank is either shorter than expected or its data corrupted.
  • AK_WrongBankVersion: Invalid bank version: make sure the version of Wwise that you used to generate the SoundBanks matches that of the SDK you are currently using.
  • AK_InvalidFile: File specified could not be opened.
  • AK_NotInitialized if the sound engine was not correctly initialized
  • AK_InvalidParameter if some parameters are invalid, check the debug console or Wwise Profiler
  • AK_InvalidBankType if the bank type parameter is out of range.
  • AK_FileNotFound if the bank file was not found on disk.
  • AK_FilePermissionError if the file permissions are wrong for the file
  • AK_Fail: Load or unload failed for any other reason. , check the debug console or Wwise Profiler
注釈
  • The initialization bank must be loaded first.
  • All SoundBanks subsequently loaded must come from the same Wwise project as the initialization bank. If you need to load SoundBanks from a different project, you must first unload ALL banks, including the initialization bank, then load the initialization bank from the other project, and finally load banks from that project.
  • Codecs and plug-ins must be registered before loading banks that use them.
  • Loading a bank referencing an unregistered plug-in or codec will result in a load bank success, but the plug-ins will not be used. More specifically, playing a sound that uses an unregistered effect plug-in will result in audio playback without applying the said effect. If an unregistered source plug-in is used by an event's audio objects, posting the event will fail.
参照
引数
in_bankIDBank ID of the bank to load
in_bankTypeType of the bank to load

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

サポートは必要ですか?

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

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

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

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

Wwiseからはじめよう