|
Wwise SDK 2025.1.0
|
#include <AkCommandTypes.h>
公開変数類 | |
| AkPlayingID | playingID |
| Unique ID that will be associated with this playback. Use AK_SoundEngine_GeneratePlayingID() to generate a new unique playing ID. [詳解] | |
| AkUniqueID | eventID |
| Unique ID of the event [詳解] | |
| AkGameObjectID | gameObjectID |
| Associated game object ID [詳解] | |
| AkPlayingID | actionTargetPlayingID |
| Filters the "Target" of actions in the event by a playing ID. Set to AK_INVALID_PLAYING_ID to disable target filtering. Not all actions are affected by this; see AkActionOnEventType for the list of action types affected by this option. [詳解] | |
| AkUInt32 | flags |
| (optional) Bitmask: see AkCallbackType [詳解] | |
| AkEventCallbackFunc | callback |
| (optional) Callback function [詳解] | |
| void * | callbackCookie |
| (optional) Callback cookie [詳解] | |
| AkUInt32 | numExternalSources |
(optional) Number of elements in externalSources array [詳解] | |
Posts an event. When this command is executed, the actions referenced in the event will be executed. The user is responsible for providing a new unique playingID value for every instance of this command. Re-using the same playing ID will cause actions in this event to be associated with an existing playback.
If numExternalSources is set to a value higher than 0, then the client is expected to call AK_CommandBuffer_AddExternalSources after the command:
auto cmd = (AkCmd_PostEvent*)AK_CommandBuffer_Add(buffer, AkCommand_PostEvent); // Fill out the command... cmd->numExternalSources = myExternalSourcesArray.size(); AK_CommandBuffer_AddExternalSources(buffer, myExternalSourcesArray.size(), myExternalSourcesArray.data());
This command can fail for the following reasons:
eventID is not valid or numExternalSources is higher than 0 and not enough external sources were added after the command.playingID was already used in a previous post event command. Use AK_SoundEngine_GeneratePlayingID() to ensure that a unique ID is generated for each post event command.AkCommandTypes.h の 140 行目に定義があります。