Wwise SDK 2021.1.14

옵션에 지정된 내용에 따라, 쿼리 결과의 각 오브젝트에 대해 쿼리를 실행하고 데이터를 반환합니다. 해당 쿼리는 선택 사항인 'transform' 인자를 이용해 'waql' 인자나 'from' 인자를 지정할 수 있습니다. 더 자세한 정보는 Using the Wwise Authoring Query Language (WAQL) 이나 Wwise 프로젝트 쿼리하기 를 참고하세요. 선택 옵션에 대해서는 Return Options 을 참고하세요.

Arguments

Name	Type	설명
waql	string	WAQL 언어에서 쿼리를 지정합니다. 더 자세한 정보는 Using the Wwise Authoring Query Language (WAQL) 를 참고하세요.
from	one of:	쿼리 시작 지점. 추후 버전에는 사용이 중단됩니다. 대신 WAQL 인자가 사용됩니다.
	object	ID 입력란을 이용해 오브젝트를 지정합니다.
	object	검색란을 이용해 오브젝트를 지정합니다.
	object	이름 입력란을 이용해 오브젝트를 지정합니다.
	object	경로 입력란을 이용해 오브젝트를 지정합니다.
	object	ofType 입력란을 이용해 오브젝트를 지정합니다.
	object	쿼리 입력란을 이용해 오브젝트를 지정합니다.
from.id *	array	오브젝트 ID의 배열로, GUID 또는 Short ID (uint32).
from.id [...]	one of:	GUID 또는 Short ID (uint32).
	string	해당 형식의 오브젝트 GUID: {aabbcc00-1122-3344-5566-77889900aabb}.
	object	Wwise 오브젝트 Short ID와 여기에 연관된 타입.
from.id[...].shortId *	integer	오브젝트의 Short ID. Unsigned Integer 32 비트. 범위: [0,4294967295]
from.id[...].type *	integer	Short ID의 오브젝트 타입. 오브젝트 타입에 대한 정보는 Wwise Objects Reference 를 참고하세요. 범위: [1,*]
from.search *	array	프로젝트를 검색하는 데 사용되는 문자 토큰의 배열.
from.search [...]	string	검색 토큰.
from.name *	array	고유한 오브젝트 정규화 이름의 배열.
from.name [...]	string	type:name 형태의 타입으로 정규화된 오브젝트의 이름. 전역적으로 고유한 이름으로 된 오브젝트 타입만 지원됩니다. 예: Event:Play_Sound_01
from.path *	array	오브젝트 경로의 배열.
from.path [...]	string	Wwise 오브젝트의 프로젝트 경로로서, 카테고리 및 Work-Unit 포함. 예: \Actor-Mixer Hierarchy\Default Work Unit\New Sound SFX.
from.ofType *	array	오브젝트 타입의 배열.
from.ofType [...]	string	오브젝트 타입. 전체 타입 목록은 Wwise Objects Reference 를 참고하세요.
from.query *	array	쿼리 오브젝트 ID의 배열.
from.query [...]	string	해당 형식의 오브젝트 GUID: {aabbcc00-1122-3344-5566-77889900aabb}.
transform	array	"from"에 의해 반환되는 오브젝트 목록에 연결된 순차적 트랜스폼의 배열.
transform [...]	one of:	오브젝트 트랜스폼.
	object	선택 트랜스폼.
	string	고유 오브젝트 인스턴스가 반환됩니다. 즉, 중복 오브젝트는 반환되지 않습니다. 사용 가능한 값: distinct
	object	범위 입력란을 이용해 오브젝트를 지정합니다.
	object	where 입력란을 이용해 오브젝트를 지정합니다.
transform[...].select *	array	선택 버튼 하나의 배열.
transform[...].select [...]	string	선택 버튼. 지정된 선택 버튼에 따라 오브젝트가 반환됩니다. 사용 가능한 값: parent children descendants ancestors referencesTo
transform[...].range *	array	경계 색인(boundary index)을 지정하는 숫자 두 개의 배열. 결과의 일부분에만 사용됩니다. 예를 들어, 검색 결과 중 앞의 100개 요소를 구할 때 사용할 수 있습니다: [0,100].
transform[...].range [...]	number	범위 한계 숫자 두 개 중 하나.
transform[...].where *	array	결과물을 필터링할 때 사용되는 두 토큰의 배열. 첫 번째 토큰은 필터 서술 부분입니다. 사용 가능한 서술 부분의 전체 목록은 Wwise 프로젝트 쿼리하기 를 참고하세요. 두 번째 토큰은 서술 부분의 매개 변수입니다.
transform[...].where [...]	any of:	where 구문.
	string	문자열 토큰. 배열의 첫 번째 토큰은 항상 'where' 서술 이름 문자열입니다. 두 번째 토큰은 매개 변수입니다.
	array	문자열의 배열. 더 자세한 정보는 Wwise 프로젝트 쿼리하기 를 참고하세요.
transform[...].where[...] [...]	string	'where' 서술의 매개 변수. 더 자세한 정보는 Wwise 프로젝트 쿼리하기 를 참고하세요.

인자 스키마

Options

Name	Type	설명
return	array	모든 오브젝트에 대해 반환되는 내용을 지정합니다. 사용 가능한 속성 및 참조에 대한 더 자세한 정보는 Wwise Objects Reference 를 참고하세요. 반환 표현식 배열이 어느 Wwise 오브젝트가 반환될 지를 정의합니다. 여기에는 이름, ID, 또는 Volume이나 Pitch같은 오브젝트 속성, 등의 접근자가 포함돼 있습니다.
return [...]	any of:	반환 표현식.
	string	Wwise 오브젝트의 하나 또는 여러 개의 내장 접근자를 지정합니다. 사용 가능한 값: id name notes type pluginName shortId classId category filePath workunit parent owner path isPlayable childrenCount totalSize mediaSize objectSize structureSize sound:convertedWemFilePath sound:originalWavFilePath soundbank:bnkFilePath music:transitionRoot music:playlistRoot audioSource:playbackDuration audioSource:maxDurationSource audioSource:trimValues audioSource:maxRadiusAttenuation audioSource:language workunit:isDefault workunit:type workunit:isDirty switchContainerChild:context convertedWemFilePath originalWavFilePath soundbankBnkFilePath musicTransitionRoot musicPlaylistRoot playbackDuration maxDurationSource audioSourceTrimValues maxRadiusAttenuation audioSourceLanguage workunitIsDefault workunitType workunitIsDirty switchContainerChildContext
	string	쿼리를 형성하는 점으로 구분된 접근자 하나 또는 여러 개를 지정하고 값이나 오브젝트 레퍼런스를 산출합니다. 단일 @를 지정하면 연관된 오브젝트의 속성 값을 반환합니다. 두 개의 @를 지정하면 오버라이드 소스의 속성 값을 반환합니다. Wwise Objects Reference 를 참고하세요.
platform	any of:	플랫폼의 이름이나 ID (GUID). 이 인자는 선택 사항입니다. 특별히 지정돼있지 않은 경우, 현재 플랫폼을 사용합니다.
	string	플랫폼의 이름.
	string	플랫폼의 ID. {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
language	any of:	언어 이름이나 ID (GUID).
	string	언어의 이름.
	string	언어의 ID. {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.

옵션 스키마

Result

Name	Type	설명
return	array	옵션에 제공된 것과 일치하는 속성으로 찾아낸 오브젝트의 배열.
return [...]	object	Wwise 오브젝트 Wwise 오브젝트. 반환 옵션을 사용해 필요한 속성을 지정하세요.
return[...].id	string	오브젝트의 ID (GUID). {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
return[...].name	string	오브젝트의 이름을 말합니다.
return[...].notes	string	오브젝트의 노트.
return[...].type	string	오브젝트의 타입. 사용 가능한 타입에 대한 더 자세한 정보는 Wwise Objects Reference 를 참고하세요.
return[...].pluginName	string	Source, Effect, Mixer, Device 및 Metadata 플러그인의 이름.
return[...].path	string	프로젝트 루트로부터의 오브젝트 경로. 예: '\Actor-Mixer Hierarchy\Default Work Unit\Sound1'
return[...].parent	object	계층 구조 내에서 해당 오브젝트의 부모 객체.
return[...].parent.id	string	오브젝트의 ID (GUID). {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
return[...].parent.name	string	오브젝트의 이름을 말합니다.
return[...].owner	object	오브젝트의 소유자. 커스텀 효과, 커스텀 감쇠, 등과 같이 다른 오브젝트가 지역적으로 소유하고 있는 오브젝트에 해당됩니다.
return[...].owner.id	string	오브젝트의 ID (GUID). {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
return[...].owner.name	string	오브젝트의 이름을 말합니다.
return[...].isPlayable	boolean	오브젝트가 Transport에서 재생될 수 있으면 true입니다.
return[...].shortId	integer	오브젝트의 Short ID.
return[...].classId	integer	오브젝트의 클래스 ID. Unsigned Integer 32 비트. 범위: [0,4294967295]
return[...].category	string	오브젝트의 카테고리. 예: 'Actor-Mixer Hierarchy'
return[...].filePath	string	오브젝트를 포함하고 있는 파일 경로. 해당 경로는 Work Unit 파일이나 프로젝트 파일이 될 수 있습니다. Mac에서 WAAPI를 사용할 경우는 Mac에서 WAAPI 사용하기 를 참고하세요.
return[...].workunit	object	오브젝트를 포함하고 있는 상위 Work Unit. 'id'와 'name'이 반환됩니다.
return[...].workunit.id	string	오브젝트의 ID (GUID). {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
return[...].workunit.name	string	오브젝트의 이름을 말합니다.
return[...].childrenCount	number	오브젝트의 자식 객체 개수.
return[...].totalSize	integer	SoundBank 내에서 이 오브젝트와 해당 모든 하위 항목이 차지하는 공간 (단위: 바이트). objectSize는 포함되지 않습니다. 정확한 값을 위해서는 SoundBank가 생성되어야 합니다.
return[...].mediaSize	integer	이 오브젝트와 해당 모든 하위 항목의 미디어 파일의 총 변환 크기 (단위: 바이트). 정확한 값을 위해서는 SoundBank가 생성되어야 합니다.
return[...].objectSize	integer	SoundBank 내에서 오브젝트의 메타 데이터가 차지하는 공간 (단위: 바이트). 미디어 파일은 포함되지 않습니다. 정확한 값을 위해서는 SoundBank가 생성되어야 합니다.
return[...].structureSize	integer	SoundBank 내에서 오브젝트의 메타 데이터와 해당 모든 하위 항목이 차지하는 공간 (단위: 바이트). 미디어 파일은 포함되지 않습니다. 정확한 값을 위해서는 SoundBank가 생성되어야 합니다.
return[...].musicTransitionRoot	object	다른 모든 음악 전환을 재귀적으로 포함하고 있는 음악 전환 루트.
return[...].musicTransitionRoot.id	string	오브젝트의 ID (GUID). {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
return[...].musicPlaylistRoot	object	다른 모든 음악 재생 목록 요소를 반복적으로 포함하고 있는 음악 재생 목록 루트. Music Playlist Container에만 적용됩니다.
return[...].musicPlaylistRoot.id	string	오브젝트의 ID (GUID). {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
return[...].originalWavFilePath	string	원본 WAV 파일의 절대 경로. Sound와 Audio Source 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우는 Mac에서 WAAPI 사용하기 를 참고하세요.
return[...].convertedWemFilePath	string	변환된 WEM 파일의 절대 경로. 옵션에 플랫폼을 지정함. Sound와 Audio Source 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우, Mac에서 WAAPI 사용하기 를 참고하세요.
return[...].soundbankBnkFilePath	string	SoundBank 오브젝트와 연관되어 생성된 SoundBank 파일의 절대 경로. SoundBank 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우, Mac에서 WAAPI 사용하기 를 참고하세요.
return[...].playbackDuration	object	min/max 길이와 길이 타입을 포함하고 있는 길이 루트. 직접적인 소스로서 혹은 간접적인 하위 오브젝트를 통해 Audio Source 오브젝트를 포함할 수 있는 모든 오브젝트에 해당됩니다.
return[...].playbackDuration.playbackDurationMin	number	최소 재생 시간.
return[...].playbackDuration.playbackDurationMax	number	최대 재생 시간.
return[...].playbackDuration.playbackDurationType	string	길이 타입을 말합니다.
return[...].maxDurationSource	object	길이가 가장 긴 오디오 음원. 직접적인 소스로서 혹은 간접적인 하위 오브젝트를 통해 Audio Source 오브젝트를 포함할 수 있는 모든 오브젝트에 해당됩니다.
return[...].maxDurationSource.id	string	길이가 가장 긴 오디오 음원 오브젝트의 ID (GUID). {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
return[...].maxDurationSource.trimmedDuration	number	길이가 가장 긴 트리밍된 음원의 길이 (단위: 초).
return[...].audioSourceTrimValues	object	트리밍되는 오디오 음원의 시간 범위.
return[...].audioSourceTrimValues.trimBegin	number	트리밍 시작의 시간 값 (단위: 초).
return[...].audioSourceTrimValues.trimEnd	number	트리밍 끝의 시간 값 (단위: 초).
return[...].maxRadiusAttenuation	object	반경이 가장 큰 감쇠 (attenuation). 직접적인 소스로서 혹은 간접적인 하위 오브젝트를 통해 Audio Source 오브젝트를 포함할 수 있는 모든 오브젝트에 해당됩니다.
return[...].maxRadiusAttenuation.id	string	반경이 가장 큰 감쇠 오브젝트의 ID (GUID). {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
return[...].maxRadiusAttenuation.radius	number	감쇠 오브젝트의 반경.
return[...].audioSourceLanguage	object	오디오 음원에 연관돼 있는 언어. Audio Source 오브젝트에 직접 적용됩니다.
return[...].audioSourceLanguage.id	string	Audio Source 오브젝트가 연결된 Language 오브젝트의 ID (GUID). {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
return[...].audioSourceLanguage.name	string	Audio Source 오브젝트가 연결된 Language 오브젝트의 이름.
return[...].workunitIsDefault	boolean	Work Unit이 기본 설정일 때 true.
return[...].workunitType	string	Work Unit의 타입. Work Unit과 같이 물리적 폴더는 "WorkUnit" 타입을 갖습니다. 물리적 폴더는 workunitType이 "folder"입니다. 사용 가능한 값: folder rootFile nestedFile
return[...].workunitIsDirty	boolean	Work Unit이나 Project(wproj 파일)가 변경됐을 경우, 즉 수정되었으나 저장하지 않은 경우, true입니다.
return[...].switchContainerChildContext	object	Switch Container의 자식 객체와 연관된 컨텍스트 오브젝트. 이 오브젝트는 컨텍스트에 의존하지 않는 Switch Container 하위 항목과 연관돼있는 속성을 갖고 있습니다 (예: '1st only' 체크 상자의 속성).
return[...].switchContainerChildContext.id	string	오브젝트의 ID (GUID). {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID.
return[...].regex(^((@?@?[a-zA-Z0-9:_]+)\|[a-zA-Z]+$.+$)(.@?@?[a-zA-Z0-9:_]+\|[a-zA-Z]+$.+$)*$)	any of:	쿼리를 형성하는 점으로 구분된 접근자를 지정하고 속성 값이나 오브젝트 레퍼런스를 산출합니다. 단일 @는 연관된 오브젝트의 속성 값을 지정합니다. 두 개의 @는 오버라이드 소스의 속성 값을 지정합니다. 모든 타입에 사용 가능한 속성 및 참조에 대한 더 자세한 정보는 Wwise Objects Reference 를 참조하세요.
	string	문자열 값.
	number	숫자 값.
	boolean	boolean 값.
	object	오브젝트 레퍼런스 값.
	array	오브젝트 목록 레퍼런스 값.
return[...].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.
return[...].regex(^((@?@?[a-zA-Z0-9:_]+)\|[a-zA-Z]+$.+$)(.@?@?[a-zA-Z0-9:_]+\|[a-zA-Z]+$.+$)*$).name	string	오브젝트의 이름을 말합니다.
return[...].regex(^((@?@?[a-zA-Z0-9:_]+)\|[a-zA-Z]+$.+$)(.@?@?[a-zA-Z0-9:_]+\|[a-zA-Z]+$.+$)$) [...]*	object	오브젝트 레퍼런스 값.
return[...].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.
return[...].regex(^((@?@?[a-zA-Z0-9:_]+)\|[a-zA-Z]+$.+$)(.@?@?[a-zA-Z0-9:_]+\|[a-zA-Z]+$.+$)*$)[...].name	string	오브젝트의 이름을 말합니다.

결과 스키마

예제

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

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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요