버전

menu_open
Wwise SDK 2022.1.17
ak.wwise.core.soundbank.generate

Generate a list of SoundBanks with the import definition specified in the WAAPI request. If you do not write the SoundBanks to disk, subscribe to ak.wwise.core.soundbank.generated to receive SoundBank structure info and the bank data as base64. Note: This is a synchronous operation.

Arguments

이름 타입 설명
soundbanks array 생성할 SoundBank 목록.
soundbanks [...] object SoundBank Info.
soundbanks[...].name * string 생성할 SoundBank의 이름으로서, SoundBank가 존재하지 않을 경우 임시 SoundBank가 생성됩니다..
soundbanks[...].events array 이 SoundBank에 포함할 이벤트 목록. 이미 뱅크가 있는 경우 필요 없습니다.
soundbanks[...].events [...] any of: SoundBank에 포함할 이벤트의 ID (GUID), 이름, 또는 경로.
string The name of the object qualified by its type or Short ID in the form of type:name or Global:shortId. Only object types that have globally-unique names or Short Ids are supported. Ex: Event:Play_Sound_01, Global:245489792
string 해당 형식의 오브젝트 GUID: {aabbcc00-1122-3344-5566-77889900aabb}.
string Wwise 오브젝트의 프로젝트 경로로서, 카테고리 및 Work-Unit 포함. 예: \Actor-Mixer Hierarchy\Default Work Unit\New Sound SFX.
soundbanks[...].auxBusses array 이 SoundBank에 포함할 AuxBus 목록.
soundbanks[...].auxBusses [...] any of: SoundBank에 포함할 Auxiliary Bus의 ID (GUID), 이름, 또는 경로.
string The name of the object qualified by its type or Short ID in the form of type:name or Global:shortId. Only object types that have globally-unique names or Short Ids are supported. Ex: Event:Play_Sound_01, Global:245489792
string 해당 형식의 오브젝트 GUID: {aabbcc00-1122-3344-5566-77889900aabb}.
string Wwise 오브젝트의 프로젝트 경로로서, 카테고리 및 Work-Unit 포함. 예: \Actor-Mixer Hierarchy\Default Work Unit\New Sound SFX.
soundbanks[...].inclusions array 이 SoundBank에 사용할 포함 타입의 목록. 이미 뱅크가 있는 경우 필요 없습니다.
soundbanks[...].inclusions [...] string 사용 가능한 값:
  • event
  • structure
  • media
soundbanks[...].rebuild boolean 이 특정 SoundBank를 강제로 다시 빌드합니다. 기본값: false(비활성화)
platforms array 생성할 플랫폼의 목록. 아무 플랫폼도 지정하지 않으면 모든 플랫폼이 생성됩니다.
platforms [...] string 플랫폼의 ID(GUID)나 이름.
languages array 생성할 언어의 목록. 아무 언어도 지정하지 않으면 모든 언어가 생성됩니다.
languages [...] string 언어 이름이나 ID (GUID).
skipLanguages boolean 기본값으로, 아무 언어도 지정하지 않으면 모든 언어가 생성됩니다. 이 매개 변수를 true로 설정하면 아무 현지화된 SoundBank도 생성하지 않습니다.
rebuildSoundBanks boolean true일 경우 모든 SoundBank를 다시 빌드합니다. 변환된 미디어도 삭제하고 싶은 경우, clearAudioFileCache 매개 변수를 사용하세요. 기본값: false(비활성화)
clearAudioFileCache boolean 음원 파일 변환 및 SoundBank 생성에 앞서 Wwise 오디오 파일 캐시 폴더의 내용물을 삭제하여 모든 음원 파일이 재변환되도록 합니다. 플랫폼 인자에 상관 없이 모든 플랫폼에 대해 전체 캐시가 삭제되는 점에 주의하세요. 기본값: false(비활성화)
writeToDisk boolean 일반 SoundBank 생성 처리를 사용하고 디스크에 사운드 뱅크와 정보 파일을 작성합니다. 기본값: false(비활성화)
rebuildInitBank boolean rebuildSoundBanks를 사용하지 않을 경우, 이 옵션을 이용하여 각각의 지정 플랫폼에 대해 Init 뱅크를 강제로 다시 빌드하세요.

인자 스키마

Result

이름 타입 설명
logs array The SoundBank generation log. The log is empty when used in WwiseConsole.
logs [...] object 로그 항목.
logs[...].severity * string 알림: 현재 작업의 완전성에 영향을 끼치지 않음. 주의: 현재 작업의 완전성에 영향을 끼칠 수 있음. 오류: 현재 작업의 완전성에 영향을 끼침. 치명적 오류: 현재 작업을 완료하는 데 영향을 끼침. 사용 가능한 값:
  • Message
  • Warning
  • Error
  • Fatal Error
logs[...].time * integer 시스템 시간 기준, 협정 시계시 (UTC) 1970년 1월 1일 자정(00:00:00)으로부터 경과한 시간을 초 단위로 나타냄.
logs[...].messageId * string 로그 항목의 메시지 ID.
logs[...].message * string 로그 항목의 설명 메시지.
logs[...].platform object 로그 항목가 보고된 플랫폼 ID와 이름.
logs[...].platform.id string 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.name string 오브젝트의 이름을 말합니다.
logs[...].platform.notes string 오브젝트의 노트.
logs[...].platform.type string 오브젝트의 타입. 사용 가능한 타입에 대한 더 자세한 정보는 Wwise 오브젝트 레퍼런스 를 참고하세요.
logs[...].platform.pluginName string Source, Effect, Mixer, Device 및 Metadata 플러그인의 이름.
logs[...].platform.path string 프로젝트 루트로부터의 오브젝트 경로. 예: '\Actor-Mixer Hierarchy\Default Work Unit\Sound1'
logs[...].platform.parent object 계층 구조 내에서 해당 오브젝트의 부모 객체.
logs[...].platform.parent.id string 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.parent.name string 오브젝트의 이름을 말합니다.
logs[...].platform.owner object 오브젝트의 소유자. 커스텀 효과, 커스텀 감쇠, 등과 같이 다른 오브젝트가 지역적으로 소유하고 있는 오브젝트에 해당됩니다.
logs[...].platform.owner.id string 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.owner.name string 오브젝트의 이름을 말합니다.
logs[...].platform.isPlayable boolean 오브젝트가 Transport에서 재생될 수 있으면 true입니다.
logs[...].platform.shortId integer 오브젝트의 Short ID.
logs[...].platform.classId integer 오브젝트의 클래스 ID.
Unsigned Integer 32 비트. 범위: [0,4294967295]
logs[...].platform.category string 오브젝트의 카테고리. 예: 'Actor-Mixer Hierarchy'
logs[...].platform.filePath string 오브젝트를 포함하고 있는 파일 경로. 해당 경로는 Work Unit 파일이나 프로젝트 파일이 될 수 있습니다. Mac에서 WAAPI를 사용할 경우는 Mac에서 WAAPI 사용하기 를 참고하세요.
logs[...].platform.workunit object 오브젝트를 포함하고 있는 상위 Work Unit. 'id'와 'name'이 반환됩니다.
logs[...].platform.workunit.id string 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.workunit.name string 오브젝트의 이름을 말합니다.
logs[...].platform.childrenCount number 오브젝트의 자식 객체 개수.
logs[...].platform.totalSize integer SoundBank 내에서 이 오브젝트와 해당 모든 하위 항목이 차지하는 공간 (단위: 바이트). objectSize는 포함되지 않습니다. 정확한 값을 위해서는 SoundBank가 생성되어야 합니다.
logs[...].platform.mediaSize integer 이 오브젝트와 해당 모든 하위 항목의 미디어 파일의 총 변환 크기 (단위: 바이트). 정확한 값을 위해서는 SoundBank가 생성되어야 합니다.
logs[...].platform.objectSize integer SoundBank 내에서 오브젝트의 메타 데이터가 차지하는 공간 (단위: 바이트). 미디어 파일은 포함되지 않습니다. 정확한 값을 위해서는 SoundBank가 생성되어야 합니다.
logs[...].platform.structureSize integer SoundBank 내에서 오브젝트의 메타 데이터와 해당 모든 하위 항목이 차지하는 공간 (단위: 바이트). 미디어 파일은 포함되지 않습니다. 정확한 값을 위해서는 SoundBank가 생성되어야 합니다.
logs[...].platform.musicTransitionRoot object 다른 모든 음악 전환을 재귀적으로 포함하고 있는 음악 전환 루트.
logs[...].platform.musicTransitionRoot.id string 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.musicPlaylistRoot object 다른 모든 음악 재생 목록 요소를 반복적으로 포함하고 있는 음악 재생 목록 루트. Music Playlist Container에만 적용됩니다.
logs[...].platform.musicPlaylistRoot.id string 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.originalWavFilePath string (추후 버전에는 사용 중단) 원본 WAV 파일의 절대 경로. Sound와 Audio Source 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우는 Mac에서 WAAPI 사용하기 를 참고하세요.
logs[...].platform.originalFilePath string 원본 파일의 절대 경로. Sound와 Audio Source 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우는 Mac에서 WAAPI 사용하기 를 참고하세요.
logs[...].platform.activeSource object 사운드 오브젝트의 액티브 소스.
logs[...].platform.activeSource.id string 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.activeSource.name string 오브젝트의 이름을 말합니다.
logs[...].platform.convertedWemFilePath string (추후 버전에는 사용 중단) 변환된 WEM 파일의 절대 경로. 옵션에 플랫폼을 지정함. Sound와 Audio Source 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우, Mac에서 WAAPI 사용하기 를 참고하세요.
logs[...].platform.convertedFilePath string 변환된 파일의 절대 경로. 옵션에 플랫폼을 지정함. Sound와 Audio Source 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우, Mac에서 WAAPI 사용하기 를 참고하세요.
logs[...].platform.soundbankBnkFilePath string SoundBank 오브젝트와 연관되어 생성된 SoundBank 파일의 절대 경로. SoundBank 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우, Mac에서 WAAPI 사용하기 를 참고하세요.
logs[...].platform.playbackDuration object min/max 길이와 길이 타입을 포함하고 있는 길이 루트. 추후 버전에는 사용이 중단됩니다. 대신 길이(duration)가 사용됩니다. 직접적인 소스로서 혹은 간접적인 하위 오브젝트를 통해 Audio Source 오브젝트를 포함할 수 있는 모든 오브젝트에 해당됩니다.
logs[...].platform.playbackDuration.playbackDurationMin number 최소 재생 시간.
logs[...].platform.playbackDuration.playbackDurationMax number 최대 재생 시간.
logs[...].platform.playbackDuration.playbackDurationType string 길이 타입을 말합니다.
logs[...].platform.duration object min/max 길이와 길이 타입을 포함하고 있는 길이 루트. 직접적인 소스로서 혹은 간접적인 하위 오브젝트를 통해 Audio Source 오브젝트를 포함할 수 있는 모든 오브젝트에 해당됩니다.
logs[...].platform.duration.min number 최소 재생 시간.
logs[...].platform.duration.max number 최대 재생 시간.
logs[...].platform.duration.type string 길이 타입을 말합니다.
logs[...].platform.maxDurationSource object 길이가 가장 긴 오디오 음원. 직접적인 소스로서 혹은 간접적인 하위 오브젝트를 통해 Audio Source 오브젝트를 포함할 수 있는 모든 오브젝트에 해당됩니다.
logs[...].platform.maxDurationSource.id string 길이가 가장 긴 오디오 음원 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.maxDurationSource.trimmedDuration number 길이가 가장 긴 트리밍된 음원의 길이 (단위: 초).
logs[...].platform.audioSourceTrimValues object 트리밍되는 오디오 음원의 시간 범위.
logs[...].platform.audioSourceTrimValues.trimBegin number 트리밍 시작의 시간 값 (단위: 초).
logs[...].platform.audioSourceTrimValues.trimEnd number 트리밍 끝의 시간 값 (단위: 초).
logs[...].platform.maxRadiusAttenuation object 반경이 가장 큰 감쇠 (attenuation). 직접적인 소스로서 혹은 간접적인 하위 오브젝트를 통해 Audio Source 오브젝트를 포함할 수 있는 모든 오브젝트에 해당됩니다.
logs[...].platform.maxRadiusAttenuation.id string 반경이 가장 큰 감쇠 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.maxRadiusAttenuation.radius number 감쇠 오브젝트의 반경.
logs[...].platform.audioSourceLanguage object 오디오 음원에 연관돼 있는 언어. Audio Source 오브젝트에 직접 적용됩니다.
logs[...].platform.audioSourceLanguage.id string Audio Source 오브젝트가 연결된 Language 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.audioSourceLanguage.name string Audio Source 오브젝트가 연결된 Language 오브젝트의 이름.
logs[...].platform.workunitIsDefault boolean Work Unit이 기본 설정일 때 true.
logs[...].platform.workunitType string Work Unit의 타입. Work Unit과 같이 물리적 폴더는 "WorkUnit" 타입을 갖습니다. 물리적 폴더는 workunitType이 "folder"입니다. 사용 가능한 값:
  • folder
  • rootFile
  • nestedFile
logs[...].platform.workunitIsDirty boolean Work Unit이나 Project(wproj 파일)가 변경됐을 경우, 즉 수정되었으나 저장하지 않은 경우, true입니다.
logs[...].platform.switchContainerChildContext object Switch Container의 자식 객체와 연관된 컨텍스트 오브젝트. 이 오브젝트는 컨텍스트에 의존하지 않는 Switch Container 하위 항목과 연관돼있는 속성을 갖고 있습니다 (예: '1st only' 체크 상자의 속성).
logs[...].platform.switchContainerChildContext.id string 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.isExplicitMute boolean 오브젝트가 명시적으로 음소거되었는지 여부. 오브젝트를 암묵적으로 명시적 음소거를 하면 하위 오브젝트가 음소거됩니다.
logs[...].platform.isExplicitSolo boolean Whether or not the object has been soloed explicitly. Soloing an object silences all the other objects in the project except this one.
logs[...].platform.isImplicitMute boolean Whether or not the object has been muted implicitly. 오브젝트를 암묵적으로 명시적 음소거를 하면 하위 오브젝트가 음소거됩니다.
logs[...].platform.isImplicitSolo boolean Whether or not the object has been soloed implicitly. Soloing an object silences all the other objects in the project except this one.
logs[...].platform.isIncluded boolean Whether or not the object is Included. 옵션에 플랫폼을 지정함. This takes into consideration the Inclusion status of the object's ancestors.
logs[...].platform.points array This only applies to Curve objects.
An array of points defining a curve.
logs[...].platform.points [...] object 곡선에 있는 지점.
logs[...].platform.points[...].x * number 곡선 지점의 X 좌표.
logs[...].platform.points[...].y * number 곡선 지점의 Y 좌표.
logs[...].platform.points[...].shape * string 이 지점과 다음 지점 사이 곡선분(curve segment)의 형태. 사용 가능한 값:
  • Constant
  • Linear
  • Log3
  • Log2
  • Log1
  • InvertedSCurve
  • SCurve
  • Exp1
  • Exp2
  • Exp3
logs[...].platform.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(\.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$) any of: 쿼리를 형성하는 점으로 구분된 접근자를 지정하고 속성 값이나 오브젝트 레퍼런스를 산출합니다. 단일 @는 연관된 오브젝트의 속성 값을 지정합니다. 두 개의 @는 오버라이드 소스의 속성 값을 지정합니다. 모든 타입에 사용 가능한 속성 및 참조에 대한 더 자세한 정보는 Wwise 오브젝트 레퍼런스 를 참조하세요.
string 문자열 값.
number 숫자 값.
boolean boolean 값.
object 오브젝트 레퍼런스 값.
array 오브젝트 목록 레퍼런스 값.
logs[...].platform.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(\.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$).id string 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(\.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$).name string 오브젝트의 이름을 말합니다.
logs[...].platform.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(\.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$) [...] object 오브젝트 레퍼런스 값.
logs[...].platform.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(\.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$)[...].id string 오브젝트의 ID (GUID).
{aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
logs[...].platform.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(\.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$)[...].name string 오브젝트의 이름을 말합니다.
logs[...].parameters array 로그 항목 내 매개 변수 배열. 아무런 매개 변수가 없을 경우 표시되지 않습니다.
logs[...].parameters [...] string 로그 항목의 매개 변수. 일반적으로 오브젝트 이름입니다.

결과 스키마

더 보기

예제

Wwise Authoring API에 대한 더 자세한 정보는 Wwise Authoring API (WAAPI, Wwise 저작 API) 사용하기 를 참고하세요.


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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요