|
Wwise SDK 2022.1.18
|
옵션에 지정된 내용에 따라, 쿼리 결과의 각 오브젝트에 대해 쿼리를 실행하고 데이터를 반환합니다. 해당 쿼리는 선택 사항인 'transform' 인자를 이용해 'waql' 인자나 'from' 인자를 지정할 수 있습니다. 더 자세한 정보는 Using the Wwise Authoring Query Language (WAQL) 이나 Wwise 프로젝트 쿼리하기 를 참고하세요. 선택 옵션에 대해서는 Return Options 을 참고하세요.
| 이름 | 타입 | 설명 |
|---|---|---|
| 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 | This syntax is deprecated and we recommend the use of WAQL. Short ID의 오브젝트 타입. The type can be 10 (Event), 12 (SwitchGroup), 14 (StateGroup), 17 (EffectPlugin), 18 (SoundBank), 19 (Bus), 20 (AuxBus), 22 (GameParameter), 41 (Trigger) or 68 (AudioDevicePlugin) Range: [1,*] |
| from.search * | array | 프로젝트를 검색하는 데 사용되는 문자 토큰의 배열. |
| from.search [...] | string | 검색 토큰. |
| from.name * | array | 고유한 오브젝트 정규화 이름의 배열. |
| from.name [...] | 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 |
| 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 오브젝트 레퍼런스 를 참고하세요. |
| from.query * | array | 쿼리 오브젝트 ID의 배열. |
| from.query [...] | string | 해당 형식의 오브젝트 GUID: {aabbcc00-1122-3344-5566-77889900aabb}. |
| transform | array | "from"에 의해 반환되는 오브젝트 목록에 연결된 순차적 트랜스폼의 배열. |
| transform [...] | one of: | 오브젝트 트랜스폼. |
| object | 선택 트랜스폼. | |
| string | 고유 오브젝트 인스턴스가 반환됩니다. 즉, 중복 오브젝트는 반환되지 않습니다. 사용 가능한 값:
| |
| object | 범위 입력란을 이용해 오브젝트를 지정합니다. | |
| object | where 입력란을 이용해 오브젝트를 지정합니다. | |
| transform[...].select * | array | 선택 버튼 하나의 배열. |
| transform[...].select [...] | string | 선택 버튼. 지정된 선택 버튼에 따라 오브젝트가 반환됩니다. 사용 가능한 값:
|
| 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 프로젝트 쿼리하기 를 참고하세요. |
| 이름 | 타입 | 설명 |
|---|---|---|
| return | array | 모든 오브젝트에 대해 반환되는 내용을 지정합니다. 사용 가능한 속성 및 참조에 대한 더 자세한 정보는 Wwise 오브젝트 레퍼런스 를 참고하세요. 반환 표현식 배열이 어느 Wwise 오브젝트가 반환될 지를 정의합니다. 여기에는 이름, ID, 또는 Volume이나 Pitch같은 오브젝트 속성, 등의 접근자가 포함돼 있습니다. |
| return [...] | any of: | 반환 표현식. |
| string | Wwise 오브젝트의 하나 또는 여러 개의 내장 접근자를 지정합니다. 사용 가능한 값:
| |
| string | 쿼리를 형성하는 점으로 구분된 접근자 하나 또는 여러 개를 지정하고 값이나 오브젝트 레퍼런스를 산출합니다. 단일 @를 지정하면 연관된 오브젝트의 속성 값을 반환합니다. 두 개의 @를 지정하면 오버라이드 소스의 속성 값을 반환합니다. Wwise 오브젝트 레퍼런스 를 참고하세요. | |
| 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. |
| 이름 | 타입 | 설명 |
|---|---|---|
| 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 오브젝트 레퍼런스 를 참고하세요. |
| 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[...].originalFilePath | string | 원본 파일의 절대 경로. Sound와 Audio Source 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우는 Mac에서 WAAPI 사용하기 를 참고하세요. |
| return[...].activeSource | object | 사운드 오브젝트의 액티브 소스. |
| return[...].activeSource.id | string | 오브젝트의 ID (GUID). {aabbcc00-1122-3344-5566-77889900aabb} 형식의 오브젝트 GUID. |
| return[...].activeSource.name | string | 오브젝트의 이름을 말합니다. |
| return[...].convertedWemFilePath | string | (추후 버전에는 사용 중단) 변환된 WEM 파일의 절대 경로. 옵션에 플랫폼을 지정함. Sound와 Audio Source 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우, Mac에서 WAAPI 사용하기 를 참고하세요. |
| return[...].convertedFilePath | string | 변환된 파일의 절대 경로. 옵션에 플랫폼을 지정함. Sound와 Audio Source 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우, Mac에서 WAAPI 사용하기 를 참고하세요. |
| return[...].soundbankBnkFilePath | string | SoundBank 오브젝트와 연관되어 생성된 SoundBank 파일의 절대 경로. SoundBank 오브젝트에 대해서만 유효합니다. Mac에서 WAAPI를 사용할 경우, Mac에서 WAAPI 사용하기 를 참고하세요. |
| return[...].playbackDuration | object | min/max 길이와 길이 타입을 포함하고 있는 길이 루트. 추후 버전에는 사용이 중단됩니다. 대신 길이(duration)가 사용됩니다. 직접적인 소스로서 혹은 간접적인 하위 오브젝트를 통해 Audio Source 오브젝트를 포함할 수 있는 모든 오브젝트에 해당됩니다. |
| return[...].playbackDuration.playbackDurationMin | number | 최소 재생 시간. |
| return[...].playbackDuration.playbackDurationMax | number | 최대 재생 시간. |
| return[...].playbackDuration.playbackDurationType | string | 길이 타입을 말합니다. |
| return[...].duration | object | min/max 길이와 길이 타입을 포함하고 있는 길이 루트. 직접적인 소스로서 혹은 간접적인 하위 오브젝트를 통해 Audio Source 오브젝트를 포함할 수 있는 모든 오브젝트에 해당됩니다. |
| return[...].duration.min | number | 최소 재생 시간. |
| return[...].duration.max | number | 최대 재생 시간. |
| return[...].duration.type | 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"입니다. 사용 가능한 값:
|
| 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[...].isExplicitMute | boolean | 오브젝트가 명시적으로 음소거되었는지 여부. 오브젝트를 암묵적으로 명시적 음소거를 하면 하위 오브젝트가 음소거됩니다. |
| return[...].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. |
| return[...].isImplicitMute | boolean | Whether or not the object has been muted implicitly. 오브젝트를 암묵적으로 명시적 음소거를 하면 하위 오브젝트가 음소거됩니다. |
| return[...].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. |
| return[...].isIncluded | boolean | Whether or not the object is Included. 옵션에 플랫폼을 지정함. This takes into consideration the Inclusion status of the object's ancestors. |
| return[...].points | array | This only applies to Curve objects. An array of points defining a curve. |
| return[...].points [...] | object | 곡선에 있는 지점. |
| return[...].points[...].x * | number | 곡선 지점의 X 좌표. |
| return[...].points[...].y * | number | 곡선 지점의 Y 좌표. |
| return[...].points[...].shape * | string | 이 지점과 다음 지점 사이 곡선분(curve segment)의 형태. 사용 가능한 값:
|
| return[...].regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(\.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$) | any of: | 쿼리를 형성하는 점으로 구분된 접근자를 지정하고 속성 값이나 오브젝트 레퍼런스를 산출합니다. 단일 @는 연관된 오브젝트의 속성 값을 지정합니다. 두 개의 @는 오버라이드 소스의 속성 값을 지정합니다. 모든 타입에 사용 가능한 속성 및 참조에 대한 더 자세한 정보는 Wwise 오브젝트 레퍼런스 를 참조하세요. |
| 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를 시작해 보세요