버전
menu

Wwise SDK 2025.1.0
AkCmd_AddOutput 구조체 참조

#include <AkCommandTypes.h>

Public 속성

struct AkOutputSettings settings
 Creation parameters for this output. AkOutputSettings 더 자세히 ...
 
AkUInt32 numListenerIDs
 The number of listener IDs that follow the command. 더 자세히 ...
 

상세한 설명

Adds an output to the sound engine. Use this to add controller-attached headphones, controller speakers, DVR output, etc.
The settings parameter contains an Audio Device shareset to specify the output plugin to use and a device ID to specify the instance, if necessary (e.g. which game controller).

The Sound Engine can accept an array of AkGameObjectID objects after the command. These objects correspond to listener IDs attached to the output device. When specified, only the sounds routed to game objects linked to those listeners will play in this device. It is necessary to have separate listeners if multiple devices of the same type can coexist (e.g. controller speakers).

To attach listener IDs to the device being added:

auto cmd = (AkCmd_AddOutput*)AK_CommandBuffer_Add(buffer, AkCommand_AddOutput);
// Fill out the command...
cmd->numListenerIDs = mylistenerArray.size();
AK_CommandBuffer_AddArray(buffer, sizeof(AkGameObjectID), mylistenerArray.size(), mylistenerArray.data());

When numListenerIDs is 0, sound routing simply obey the associations between Master Busses and Audio Devices setup in the Wwise Project.

This command can fail for the following reasons:

  • AK_InvalidParameter: Out of range parameters or unsupported parameter combinations.
  • AK_IDNotFound: The audioDeviceShareset in settings doesn't exist. Possibly, the Init bank isn't loaded yet or was not updated with latest changes.
  • AK_InsufficientMemory: Not enough memory to complete the operation.
  • AK_DeviceNotCompatible: Request output settings are incompatible with current system. A dummy output was created instead.
참고

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


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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요