バージョン
menu

Wwise SDK 2025.1.0
統合の詳細 - ゲームオブジェクト

ゲームオブジェクトは、インターフェース、サウンド、トリガーなどの要素を関連付けられるエンティティです。

ゲームオブジェクトは、 AkGameObjectID (符号なし64ビットフィールド)として定義できます。IDは、0から0x‭FFFFFFFFFFFFFFDF‬(つまり符号付き整数として -33)までの範囲で、自由に選択できます。 ゲームオブジェクトID範囲0xFFFFFFFFFFFFFFE0(-32)から0x‭FFFFFFFFFFFFFFFF (-1) は、内部使用のために予約されています。オーサリングツールによって登録されたトランスポート・ゲーム・オブジェクトは、ゲームオブジェクトID 0xFFFFFFFFFFFFFFFE(-2)を使用するようになりました。

ゲームオブジェクトの関連性

サウンドエンジンでトリガーされる各Eventは、ゲームオブジェクトに関連付けられています。Event Actionが特定のゲームオブジェクトをターゲットとする場合、 AK::SoundEngine::PostEvent() 関数のパラメータとして渡されるゲームオブジェクトに関連付けられます。Event Actionがゲームオブジェクトをターゲットとしない場合、これらは指定されたゲームオブジェクトを無視します。Actionが単一のゲームオブジェクトに影響を与える場合に AK::SoundEngine::PostEvent() で指定されたゲームオブジェクトが有効でなければ、Actionは実行されません。

Every game object can have an associated 3D position, a Switch for every existing Switch Group, an RTPC value for each RTPC, and multiple values (for example, a volume) that can be set on a specific item (Sound SFX, Property Container, bus, and so on) for a specific game object. サウンドエンジンは、これらの値に関連付けられているゲームオブジェクトが登録解除されるまでこの情報を格納します。

ゲームオブジェクトの登録

ゲームオブジェクトは、使用する前に登録する必要があります。ゲームオブジェクトが不要になった場合は登録を解除します。登録したままにすると、情報(3DPosition、RTPC、Switchなど)を格納するためにメモリが無駄に使用されます。

AK::SoundEngine::RegisterGameObj() 関数が2バージョン存在します:

および

AK::SoundEngine::RegisterGameObj( AkGameObjectID in_gameObjectID, const char * in_pszObjName );

2番目の関数バージョンは監視を目的としています。再生中のオブジェクトに関連付けられた実際の名前が表示されます。AK_OPTIMIZED モードでは、2番目のバージョンはオブジェクト名を無視します。

以下の2つの関数のいずれかを使用し、ゲームオブジェクトの登録を解除できます:

および

AK::SoundEngine::UnregisterAllGameObj() は、各ゲームオブジェクトに設定されているすべてのパラメータの完全なクリーンアップを実行し、すべてのゲームオブジェクト関連付けを削除します。UnregisterGameObj() は、単一のゲームオブジェクトに対して同様の処理を実行します。登録を解除したゲームオブジェクトを再度使用する場合は、再登録する必要があります。

注釈: ゲームオブジェクトIDを再利用すると、ゲームオブジェクトとWwise Profiler内の名前の間で信頼性に欠ける関連付けが発生する可能性があります(プロファイリングを参照)。これは、Profilerのビューが更新されると、最も直近に使用された名前のみが表示されるためです。

ゲームオブジェクトの統合例については、 ゲームオブジェクト統合例 をご参照ください。

参照
AkUInt64 AkGameObjectID
Game object ID
Definition: AkTypedefs.h:47
AKSOUNDENGINE_API AKRESULT UnregisterAllGameObj()
AKSOUNDENGINE_API AKRESULT RegisterGameObj(AkGameObjectID in_gameObjectID)
AKSOUNDENGINE_API AKRESULT UnregisterGameObj(AkGameObjectID in_gameObjectID)

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

サポートは必要ですか?

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

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

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

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

Wwiseからはじめよう