버전
menu

Wwise SDK 2025.1.0
AkCmd_PostEvent 구조체 참조

#include <AkCommandTypes.h>

Public 속성

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:

  • AK_InvalidParameter: eventID is not valid or numExternalSources is higher than 0 and not enough external sources were added after the command.
  • AK_InsufficientMemory: Failed to allocate memory necessary to begin processing the command
  • AK_ResourceInUse: 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.
  • AK_IDNotFound: Event ID not found.
  • AK_PartialSuccess: When connected to the Wwise Profiler, command has been delayed to a later frame until Wwise synchronizes the event.
  • AK_MaxReached: Event Cooldown parameters for eventID did not allow the event to play.
참고

AkCommandTypes.h 파일의 140 번째 라인에서 정의되었습니다.


이 페이지가 도움이 되었나요?

지원이 필요하신가요?

질문이 있으신가요? 문제를 겪고 계신가요? 더 많은 정보가 필요하신가요? 저희에게 문의해주시면 도와드리겠습니다!

지원 페이지를 방문해 주세요

작업하는 프로젝트에 대해 알려주세요. 언제든지 도와드릴 준비가 되어 있습니다.

프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.

Wwise를 시작해 보세요