Wwise SDK 2024.1.4

概要

Wwise Authoring Query Language (WAQL) は、Wwiseプロジェクトとそのオブジェクトのクエリを行うために使います。WAQLの様々な概念については、 Wwise Authoring Query Language (WAQL) を使用するを参照してください。クエリのフォームは、以下のどれかです。

Synopsis

概要

$ SOURCE
$ SOURCE TRANSFORM
$ SOURCE TRANSFORM, TRANSFORM, ...
$ TRANSFORM

SOURCE はオブジェクトジェネレータのことで、オブジェクトのシーケンスをアウトプットします。どのようなソースがあるのかについては、下表を参照してください。

TRANSFORM はシーケンストランスフォームを表します。トランスフォームは、インプットシーケンスを受け取り、別のシーケンスをアウトプットします。

注: ソースを指定しないと、プロジェクトで定義された全オブジェクトを、暗黙にソースとみなします。

リファレンス

Sources

Specify the starting point of the query.

SOURCE	Query Source	IntegrationDemoプロジェクトで実行するWAQLクエリ
from object OBJECT_SPECIFIER from object OBJECT_SPECIFIER, OBJECT_SPECIFIER, ... OBJECT_SPECIFIER OBJECT_SPECIFIER, OBJECT_SPECIFIER	指定されたオブジェクトから、オブジェクトのシーケンスを生成します。 OBJECT_SPECIFIER は以下のフォームのどれかを指します: Path: バックスラッシュで始まり、最上位の物理フォルダを含むオブジェクトの絶対パスを、ダブルクォーテーションで囲む。 Guid: 波括弧で囲まれた128-bitのGUIDを、ダブルクォーテーションで囲む。 Qualified unique name: オブジェクトタイプのプレフィックスで始まるオブジェクト名を、ダブルクォーテーションで囲む。プロジェクト全体にわたり固有の名前を通すオブジェクトタイプに限定: Event、Bus、Effect、GameParameterなど。 Qualified unique ID: オブジェクトタイプのプレフィックスで始まるオブジェクトID（32-bitのショートID）を、ダブルクォーテーションで囲む。プロジェクト全体にわたり固有の名前を通すオブジェクトタイプに限定: Event、Bus、Effect、GameParameterなど。	$ from object "\Actor-Mixer Hierarchy\Default Work Unit\Hello" $ from object "\Master-Mixer Hierarchy\Default Work Unit\Master Audio Bus" $ from object "{1514A4D8-1DA6-412A-A17E-75CA0C2149F3}" $ from object "Event:Play_Hello" $ from object "Event:2952797154" $ from object "Event:Play_Hello", "Bus:Master Audio Bus" $ "Event:Play_Hello", "Bus:Master Audio Bus" $ "\Actor-Mixer Hierarchy"
from type OBJECT_TYPE from type OBJECT_TYPE, OBJECT_TYPE, ...	指定されたタイプから、オブジェクトのシーケンスを生成します。1つまたは複数のオブジェクトタイプを指定できます。 OBJECT_TYPE はWwiseオブジェクトタイプを表します。全てのオブジェクトタイプのリストを見るには、 Wwiseオブジェクトリファレンスを参照してください。タイプは、大文字小文字の区別がありません。	$ from type Event $ from type sound $ from type Sound $ from type randomSequenceContainer, switchContainer, blendContainer $ from type bus
from query QUERY_SPECIFIER	Query Editorで定義したWwise Queryを実行した結果として、オブジェクトのシーケンスを生成します。 QUERY_SPECIFIER は以下のフォームのどれかを指します。 Path: バックスラッシュで始まり、最上位の物理フォルダを含むオブジェクトの絶対パスを、ダブルクォーテーションで囲む。 Guid: 波括弧で囲まれた128-bitのGUIDを、ダブルクォーテーションで囲む。注: このジェネレータには、生成されるシーケンスサイズに等しいメモリアロケーションが必要です。	$ from query "\Queries\Factory Queries\Audio Source\Audio Source - Format = Vorbis" $ from query "{4D1B2AA5-19D8-44D3-AAE5-94024469CE7C}"
from search TEXT	プロジェクト全体のテキストサーチの結果として、オブジェクトのシーケンスを生成します。 TEXT はダブルクォーテーションで囲まれたテキストの文字列です。サーチのテキストで指定した全ての単語を、プロジェクトのオブジェクト内の単語と比較します。注: Wwiseツールバーのサーチと同じ結果になります。	$ from search "gun" $ from search "foot walk"
from project	プロジェクトの全オブジェクトを含む、オブジェクトのシーケンスを生成します。	$ from project

Transforms

Change a sequence of objects into another one.

TRANSFORM	チェイン（chain）可能なトランスフォーム	例
where BOOLEAN_EXPRESSION	指定した式と一致しないオブジェクトを拒否することで、インプットシーケンスのオブジェクトにフィルタを適用します。 BOOLEAN_EXPRESSION はtrueまたはfalseを返す式を表します。インプットシーケンスの各オブジェクトに対してこの式を実行し、falseを返した式のあるオブジェクトを拒否します。詳細は、expressionsのセクションを参照してください。	$ from type Sound where @Volume < 0 $ from type Sound where -1 = @Volume $ from type Sound where @OutputBus="Bus:Master Audio Bus" $ from type Sound where @UserAuxSend0="AuxBus:Hangar_Env" $ from type Event select children where @Target.path : "hello" $ from type RandomSequenceContainer where childrenCount > 2 and childrenCount <= 4 $ from type Sound where notes : "All" $ from type Sound where notes : "audiokinetic" $ from type Sound where @UserAuxSend0 != null
skip COUNT	インプットシーケンスのオブジェクトを指定した個数だけ飛ばしてから、残りのオブジェクトを返します。 COUNT は、スキップするエレメント数を表します。	$ from type Sound skip 10
take COUNT	インプットシーケンスの頭から、指定した個数の連続するオブジェクトを返します。 COUNT は、取るエレメントの数を表します。	$ from type Sound take 10
select OBJECT_EXPRESSION	インプットシーケンスの各オブジェクトを、新しいフォームで表現します。 OBJECT_EXPRESSION は多くのオブジェクトにゼロを返す式です。インプットシーケンスの各オブジェクトに対してこの式を実行し、式の結果を、新しいシーケンスで表現します。詳細は、expressionsのセクションを参照してください。	$ from object "{1514A4D8-1DA6-412A-A17E-75CA0C2149F3}" select parent $ from object "Bus:Master Audio Bus" select children $ from object "\Actor-Mixer Hierarchy\Default Work Unit" select descendants, this where @Volume < 0 $ from object "\Actor-Mixer Hierarchy\Default Work Unit\Hello" select @OutputBus $ from object "{CBCD492C-982D-4EE4-AE75-0019CA6577EF}" select parent.@Attenuation
orderby VALUE_EXPRESSION orderby VALUE_EXPRESSION reverse	インプットシーケンスのオブジェクトを、昇順でソートして返します。降順でソートするには、式のあとに reverse を追加します。 VALUE_EXPRESSION は、ソートアルゴリズムでオブジェクト同士を比較するために使う式を表します。このexpressionは、文字列、数値、ブール値など、比較可能な値を返す必要があります。注: このソートが実施されるには、orderbyに、インプットシーケンスのサイズに等しいメモリアロケーションが必要です。	$ from type Sound orderby name $ from type Sound orderby name reverse $ from type Bus orderby @BusVolume $ from type Action orderby @Target.name
distinct	インプットシーケンスの、区別可能なオブジェクトだけを返します。重複するオブジェクト項目は、1つの項目に減らされ、その結果、シーケンスの各オブジェクトがそれぞれ固有のものになります。注: distinctによってシーケンス内の順番が変わります。このため、distinct文のあとにorderby文を置くことが望まれます。注: この操作が実施されるには、distinctに、インプットシーケンスのサイズに等しいメモリアロケーションが必要です。	$ from object "\Actor-Mixer Hierarchy" select descendants select @OutputBus distinct

Expressions

Select other objects, or values associated with the objects, in the sequence.

Object Expressions	多くのオブジェクトに、ゼロを返す式	例
OBJECT_EXPRESSION OBJECT_EXPRESSION.OBJECT_EXPRESSION...	Wwiseオブジェクトを返すために、多くのオブジェクト式に、ゼロをチェイン（chain）します。式と式を、dotで分けます。	$ from object "Event:Play_Hello" select parent.parent
REFERENCE_NAME @REFERENCE_NAME @@REFERENCE_NAME	現在のオブジェクトが、あるリファレンス名のときに参照するオブジェクトを、返します。 @ を使うと、オブジェクトで直接定義したリファレンスを使います。 @ がないと、オーバーライド設定を使いリファレンス値を探します。これが、再生時に実際に使われる値です。同名のアクセサがあれば、それが優先されます。そのような稀な場合には、リファレンス名の前に @@ を使う必要があります。 REFERENCE_NAME は、現在のオブジェクトが参照するリファレンスの名前です。全てのオブジェクトタイプと、そのリファレンスのリストを見るには、 Wwiseオブジェクトリファレンスを参照してください。名前は、大文字小文字の区別がありません。	$ from type Sound select OutputBus $ from type Sound select effects $ from type Sound select @@Effects $ from type Sound where outputBus="Bus:Master Audio Bus"
children	オブジェクトの直下の子を返します。	$ from object "\Actor-Mixer Hierarchy\Default Work Unit" select children
descendants	オブジェクトの全ての子孫を、1つのシーケンスで返します。子孫に、全ての子が再帰的に含まれます。注: 現在のオブジェクトは含まれません。現在のオブジェクトを含めるには、次を使います: select descendants, this	$ from object "\Actor-Mixer Hierarchy\Default Work Unit" select descendants $ from object "\Actor-Mixer Hierarchy\Default Work Unit" select descendants, this
this	現在のオブジェクトを返します。	$ from object "\Master-Mixer Hierarchy\Default Work Unit\Master Audio Bus" select this, descendants
parent	オブジェクトの直接の親を返します。オブジェクトに親がなければ、オブジェクトを返しません。	$ from type Sound select parent $ from type Sound where parent.name : "*engine"
ancestors	オブジェクトの全ての祖先を、1つのシーケンスで返します。祖先に、全ての親が再帰的に含まれます。注: 現在のオブジェクトは含まれません。現在のオブジェクトを含めるには、次を使います: select ancestors, this	$ from object "Event:Play_Hello" select ancestors $ from object "Event:Play_Hello" select ancestors, this
referencesTo	現在のオブジェクトへのリファレンスのある、全てのオブジェクトを返します。	$ from type Effect select referencesTo $ "Event:Play_Hello" select referencesTo
owner	オブジェクトのオーナーを返します。オーナーは、ほかのオブジェクト内で定義された"Custom"オブジェクトのためだけに設定されます。 Sharesetオブジェクトには、オーナーがありません。親（ parent ）があり、それらを参照するオブジェクトがあります（ referencesTo ）。例えば"Custom"エフェクトのオーナーは、このエフェクトをインサートとして含むオブジェクトです。	$ from type Effect select owner $ from type Effect where owner.name :"*env"
randomizer("<strong>PROPERTY_NAME</strong>")	Returns the randomizer object associated with the specified property. Use the following properties on the randomizer object: min, max, enabled. PROPERTY_NAME は、現在のオブジェクトのプロパティ名を表します。Refer to Wwiseオブジェクトリファレンス for the complete list of object types and their properties. 名前は、大文字小文字の区別がありません。	$ from type sound where randomizer("pitch") != null $ from type sound where randomizer("highpass").min < 0 $ from type sound where randomizer("lowpass").max > 0 $ from type sound where randomizer("volume").enabled = true
workunit	現在のオブジェクトで継続するために使われている、Work Unitオブジェクトを返します。	$ from type Effect select workunit
musicTransitionRoot	(DEPRECATED) Returns the Music Transition root object associated with the current object. This is deprecated. The TransitionRoot reference should be used instead. 注: これが機能するオブジェクトタイプは、MusicSegment、MusicTrack、MusicPlaylistContainer、MusicSwitchContainerだけです。	$ from project select musicTransitionRoot
musicPlaylistRoot	(DEPRECATED) Returns the Music Playlist root object associated with the current object. This is deprecated. The PlaylistRoot reference should be used instead. 注: これが機能するオブジェクトタイプは、MusicPlaylistContainerだけです。	$ from project select musicPlaylistRoot
maxDurationSource	Returns a JSON object containing the id of the Audio Source object that has the maximum playback duration (in seconds) for all descendants of the current object. The JSON object also includes the maximum duration value itself. 注: これが機能するのは、Actor-Mixer Hierarchyオブジェクト、Interactive-Music Hierarchyオブジェクト、そしてEventだけです。	$ from object "\Actor-Mixer Hierarchy" select maxDurationSource
maxDurationSourceObject	現在のオブジェクトの全ての子孫の、最大再生時間（秒単位）のあるAudio Sourceオブジェクトを返します。注: これが機能するのは、Actor-Mixer Hierarchyオブジェクト、Interactive-Music Hierarchyオブジェクト、そしてEventだけです。	$ from object "\Actor-Mixer Hierarchy" select maxDurationSource
maxRadiusAttenuation	Returns a JSON object containing the id of the attenuation object that has the maximum radius distance in all descendants of the current objects. The JSON object also contains the maximum radius distance value itself. 注: これが機能するのは、Actor-Mixer Hierarchyオブジェクト、Interactive-Music Hierarchyオブジェクト、そしてEventだけです。	$ from type Sound select maxRadiusAttenuation
maxRadiusAttenuationObject	現在のオブジェクトの全ての子孫の中で、最大距離の半径を有する減衰オブジェクトを返します。注: これが機能するのは、Actor-Mixer Hierarchyオブジェクト、Interactive-Music Hierarchyオブジェクト、そしてEventだけです。	$ from type Sound select maxRadiusAttenuation
audioSourceLanguage	現在のAudio Sourceに使われているランゲージオブジェクトを返します。注: これが機能するのは、Audio Sourceオブジェクトだけです。	$ from type AudioFileSource select audioSourceLanguage
switchContainerChildContext	現在のSwitch Containerオブジェクトに関連する、Switch Containerコンテキストオブジェクトを返します。Switch Containerコンテキストオブジェクトには、Switch Containerの関連付けの設定が入っています。注: これが機能するオブジェクトタイプは、SwitchContainerだけです。	$ from project select switchContainerChildContext
Value Expressions	数字、文字列、またはブール値を返す式	例
OBJECT_EXPRESSION.VALUE_EXPRESSION OBJECT_EXPRESSION.OBJECT_EXPRESSION. VALUE_EXPRESSION	チェイン（chain）したオブジェクトの値を返すために、多くのオブジェクト式にゼロをチェインし、そのあとにvalue expressionをつけます。式と式を、dotで分けます。	$ where OutputBus.id = "{1514A4D8-1DA6-412A-A17E-75CA0C2149F3}"
PROPERTY_NAME @PROPERTY_NAME @@PROPERTY_NAME	特定オブジェクト用に、プロパティ値を返します。 Without the @, the override settings are used to find the property value. これが、再生時に使われる実際の値です（つまり、有効値）。If there is an accessor of the same name, it will take precedence; in those rare cases, @@ must be used before the property name. @ を使うと、オブジェクトで直接定義したプロパティを、それがオーバーライドされていなくても、使います。 @@ は、 @ がないのと同じです。 PROPERTY_NAME は、現在のオブジェクトのプロパティ名を表します。Refer to Wwiseオブジェクトリファレンス for the complete list of object types and their properties. 名前は、大文字小文字の区別がありません。	$ from type Sound where volume < 0 $ from type Sound where @UserAuxSendVolume0 < 0 $ from type Sound where IsLoopingEnabled = true $ from type sound where isloopingenabled = true
id	フォーム: "{0CB93450-E995-40E5-98A5-239F15B1F1D4}" の、128-bitのGUID文字列を返します。これは、プロジェクトのオブジェクトのための、固有の識別子です。	$ where id = "{1514A4D8-1DA6-412A-A17E-75CA0C2149F3}"
shortId	オブジェクトの32-bitのショートIDの数値を返します。これは、サウンドエンジンで使われるIDです。注: ショートIDが固有である範囲は、オブジェクトタイプによって異なります。バス、イベント、エフェクト、ゲームシンクなど、特定のオブジェクトタイプのIDは、同じタイプの全てのオブジェクトに渡り固有です。それ以外のサウンドやコンテナなどのIDは、プロジェクト全体に渡り固有です。	$ where shortId = 1588715066
name	オブジェクト名を文字列として返します。	$ from type Event where name : "hello" $ where name = "Play_Hello"
notes	オブジェクトのnotes（コメントとも呼ばれる）を、文字列として返します。	$ where notes : "audiokinetic"
type	オブジェクトのタイプを、文字列として返します。全てのオブジェクトタイプのリストを見るには、 Wwiseオブジェクトリファレンスを参照してください。	$ where type = "Sound"
nodeType	Returns the type of the node as a string. Refer to Wwise Nodes Reference for the complete list of node types.	$ where nodeType = "Sound SFX"
classId	オブジェクトのclassIDを返します。classIDは、オブジェクトのタイプと、エフェクト、ソース、またはコンバージョンプラグインのタイプを表す数値です。全てのclassIDのリストを見るには、 Wwiseオブジェクトリファレンスを参照してください。	$ where classId = 8847363
category	オブジェクトのカテゴリを返します。プロジェクトのルート（root）フォルダ下の最上位フォルダ名が、カテゴリの候補です。	$ where category = "Actor-Mixer Hierarchy" $ where category = "Interactive Music Hierarchy" $ where category = "Master-Mixer Hierarchy" $ where category = "Events"
filePath	Work Unitまたはプロジェクトに関連付いているファイルパスを返します。これは、wwuまたはwprojファイルの絶対パスです。	$ where type = "WorkUnit" and filePath : "*wwu"
path	Wwiseプロジェクトの中のプロジェクトのパスを返します。このパスには、カテゴリ、つまり最上位フォルダ名が含まれます。	$ where path : "microphone"
activeSource	サウンドオブジェクトに関連付けられたアクティブソースを返します。	$ from type Sound select activeSource
isPlayable	オブジェクトを、トランスポートの中、またはイベントの中で再生できれば、trueを返します。それ以外の場合は、falseを返します。	$ where isPlayable $ where isPlayable = false $ where !isPlayable
childrenCount	現在のオブジェクトの子の数を返します。	$ where childrenCount > 10 $ where type = "RandomSequenceContainer" and childrenCount > 5
pluginName	プラグインのベンダーが提供するプラグイン名を返します。プラグイン名は、Effectsプラグイン、Sourceプラグイン、Audio Device、Metadataオブジェクトに提供されます。なお、プラグイン名は、オブジェクト名と異なります。	$ where pluginName = ""
convertedFilePath	Returns the absolute path of the converted file associated with the current object. 注: これが機能するオブジェクトタイプは、SoundとAudioSourceだけです。	$ from type Sound where convertedFilePath : "hello"
originalFilePath	Returns the absolute path of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip and Music Clip MIDI.	$ from type Sound where originalFilePath : "hello"
originalRelativeFilePath	Returns the path of the original file associated with the current object, relative to the project's Originals folder. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Music Clip MIDI.	$ from type Sound where originalFilePath : "hello"
originalTotalChannelCount	Returns the total number of channels of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalTotalChannelCount > 3
originalNormalChannelCount	Returns the total number of channels in the default plane of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalNormalChannelCount > 3
originalHeightChannelCount	Returns the total number of channels in the height plane of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalHeightChannelCount > 0
originalLFEChannelCount	Returns the total number of low-frequency channels of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalLFEChannelCount > 0
originalAnonymousChannelCount	Returns the total number of anonymous channels of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalAnonymousChannelCount > 0
originalChannelConfig	Returns the channel configuration string of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalChannelConfig = "7.1.4"
originalChannelMask	Returns the channel configuration mask of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalChannelMask = 185919
originalSampleRate	Returns the sample rate of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalSampleRate = 48000
originalBitDepth	Returns the bit depth of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalSampleRate = 16
originalFileSize	Returns the size in bytes of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalFileSize != 0
originalDataSize	Returns the size in bytes of the original file's data associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalDataSize != 0
originalSampleCount	Returns the number of samples in the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalSampleCount != 0
originalDuration	Returns the duration in seconds of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media. This can differ from the duration field because originalDuration does not include trims.	$ from type Sound where originalDuration > 1
originalCodec	Returns the codec of the original file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where originalCodec = "PCM"
convertedTotalChannelCount	Returns the total number of channels of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedTotalChannelCount > 3
convertedNormalChannelCount	Returns the total number of channels in the default plane of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedNormalChannelCount > 3
convertedHeightChannelCount	Returns the total number of channels in the height plane of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedHeightChannelCount > 0
convertedLFEChannelCount	Returns the total number of low-frequency channels of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedLFEChannelCount > 0
convertedAnonymousChannelCount	Returns the total number of anonymous channels of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedAnonymousChannelCount > 0
convertedChannelConfig	Returns the channel configuration string of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedChannelConfig = "7.1.4"
convertedChannelMask	Returns the channel configuration mask of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedChannelMask = 185919
convertedSampleRate	Returns the sample rate of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedSampleRate = 48000
convertedBitDepth	Returns the bit depth of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedSampleRate = 16
convertedFileSize	Returns the size in bytes of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedFileSize != 0
convertedDataSize	Returns the size in bytes of the converted file's data associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedDataSize != 0
convertedSampleCount	Returns the number of samples in the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedSampleCount != 0
convertedDuration	Returns the duration in seconds of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media. This can differ from the duration field because convertedDuration does not include trims.	$ from type Sound where convertedDuration > 1
convertedCodec	Returns the codec of the converted file associated with the current object. Note: This only works with objects of type Sound, AudioSource, Music Clip, and Plug-in Media.	$ from type Sound where convertedCodec = "Vorbis"	soundbankBnkFilePath	現在のオブジェクトに関連付いている、BNKファイルの絶対パスを返します。注: これが機能するオブジェクトタイプは、SoundBankだけです。	$ where soundbankBnkFilePath : "car"
mediaId	Unique value given to file. Used by the sound engine to identify the file. Note: This only works with objects of type AudioSource, MidiFileSource and PluginMediaSource.	$ where mediaId > 0
conversionHash	The hash of everything in the project that affects a file's conversion (Conversion ShareSet, file modifications in the Source Editor, and so on). Note: This only works with objects of type AudioSource, MidiFileSource and PluginMediaSource.	$ where conversionHash > 0
contentHash	The hash of the conversionHash and the hash of the original file's contents. Note: This only works with objects of type AudioSource, MidiFileSource and PluginMediaSource.	$ where contentHash != ""
workunitIsDefault	Work Unitオブジェクトが、自分のカテゴリのデフォルトワークユニットであれば、trueを返します。注: これが機能するオブジェクトタイプは、WorkUnitだけです。	$ where workunitIsDefault
workunitType	現在のWork Unitオブジェクトのタイプを返します。以下のような値となります: "folder": "\Actor-Mixer Hierarchy"など、Physicalフォルダオブジェクト用。 "rootFile": 中にあるWork Unitオブジェクト用 "nestedFile" 注: これが機能するオブジェクトタイプは、WorkUnitだけです。	$ where workunitType = "folder" $ where workunitType = "rootFile" and !workunitIsDefault
workunitIsDirty	Work Unitに、保存されていない変更があれば、trueを返します。注: これが機能するオブジェクトタイプは、WorkUnitだけです。	$ where workunitIsDirty
isExplicitMute	オブジェクトが明示的にミュートされていれば、trueを返します。	$ where isExplicitMute
isExplicitSolo	オブジェクトが明示的にソロにされていれば、trueを返します。	$ where isExplicitSolo
isImplicitMute	オブジェクトが暗黙的にミュートされていれば、trueを返します。	$ where isImplicitMute
isImplicitSolo	オブジェクトが暗黙的にソロにされていれば、trueを返します。	$ where isImplicitSolo
isIncluded	Returns true if the object is included. If one or more of the object's ancestors is excluded, the object is excluded as well.	$ where isIncluded
stateProperties	Returns which properties are used for the states of the associated object. This represents the visible columns in the States tab. The return is a list of strings. Note: This can only be used in a return expression.
stateGroups	Returns which state groups are used for the states of the associated object. This represents the state groups added in the States tab. The return is a list of objects. Note: This can only be used in a return expression.
validity	Returns a JSON object representing the status of validity. There are 3 fields in the object: isValid (boolean), details (string), severity (string). The details and severity fields are only available when isValid is false. This can be used with Effect Slots, Events and Actions.	$ where validity.isValid
maxDurationSource.id	長さが最も長いオーディオソースオブジェクトの、ID (GUID) を返します。	$ where maxDurationSource.id = "{1514A4D8-1DA6-412A-A17E-75CA0C2149F3}"
maxDurationSource.trimmedDuration	最も長いトリム済みソースの長さを、秒単位で返します。	$ where maxDurationSource.trimmedDuration >= 2
duration.min	再生時間として可能な、最小の長さを返します。注: これは、Audio Sourceオブジェクトをソースとして直接含むことができるオブジェクト、または子孫を通して間接的に含むことができるオブジェクト全てに、適用されます。	$ where duration.min = 3
duration.max	再生時間として可能な、最大の長さを返します。注: これは、Audio Sourceオブジェクトをソースとして直接含むことができるオブジェクト、または子孫を通して間接的に含むことができるオブジェクト全てに、適用されます。	$ where duration.max = 5
duration.type	Durationのタイプ、つまり"infinite"、"mixed"、"oneShot"、または "unknown" を返します。	$ where duration.type = "oneShot"
loudness.integrated	Returns the integrated loudness measurement in LUFS for the entire associated audio file.	$ from type sound where loudness.integrated > -14
loudness.momentaryMax	Returns the momentary max measurement in LUFS for the associated audio file. The value represents the highest loudness value obtained with a very short (100ms) window evaluation.	$ from type sound where loudness.momentaryMax > -14
audioSourceTrimValues.trimBegin	トリムされたオーディオソースの範囲の、始まりの時間を返します。	$ where audioSourceTrimValues.trimBegin = 2
audioSourceTrimValues.trimEnd	トリムされたオーディオソースの範囲の、終わりの時間を返します。	$ where audioSourceTrimValues.trimEnd = 5
maxRadiusAttenuation.id	半径が最大である減衰オブジェクトの、ID (GUID) を返します。注: これが機能するのは、Actor-Mixer Hierarchyオブジェクト、Interactive-Music Hierarchyオブジェクト、そしてEventだけです。	$ where maxRadiusAttenuation.id = "{1514A4D8-1DA6-412A-A17E-75CA0C2149F3}"
maxRadiusAttenuation.radius	半径が最大である減衰オブジェクトの、半径を返します。注: これが機能するのは、Actor-Mixer Hierarchyオブジェクト、Interactive-Music Hierarchyオブジェクト、そしてEventだけです。	$ where maxRadiusAttenuation.radius > 100
panner	Returns the Speaker Panner object. Note: This only works with objects that support Positioning.	$ where panner.panX > 5

Object Expressions

多くのオブジェクトに、ゼロを返す式

例

OBJECT_EXPRESSION

OBJECT_EXPRESSION.OBJECT_EXPRESSION...

Wwiseオブジェクトを返すために、多くのオブジェクト式に、ゼロをチェイン（chain）します。式と式を、dotで分けます。

$ from object "Event:Play_Hello" select parent.parent

REFERENCE_NAME
@REFERENCE_NAME
@@REFERENCE_NAME

現在のオブジェクトが、あるリファレンス名のときに参照するオブジェクトを、返します。

@ を使うと、オブジェクトで直接定義したリファレンスを使います。

@ がないと、オーバーライド設定を使いリファレンス値を探します。これが、再生時に実際に使われる値です。同名のアクセサがあれば、それが優先されます。そのような稀な場合には、リファレンス名の前に @@ を使う必要があります。

REFERENCE_NAME は、現在のオブジェクトが参照するリファレンスの名前です。全てのオブジェクトタイプと、そのリファレンスのリストを見るには、 Wwiseオブジェクトリファレンスを参照してください。名前は、大文字小文字の区別がありません。

$ from type Sound select OutputBus
$ from type Sound select effects
$ from type Sound select @@Effects
$ from type Sound where outputBus="Bus:Master Audio Bus"

children

オブジェクトの直下の子を返します。

$ from object "\Actor-Mixer Hierarchy\Default Work Unit" select children

descendants

オブジェクトの全ての子孫を、1つのシーケンスで返します。子孫に、全ての子が再帰的に含まれます。

注: 現在のオブジェクトは含まれません。現在のオブジェクトを含めるには、次を使います: select descendants, this

$ from object "\Actor-Mixer Hierarchy\Default Work Unit" select descendants
$ from object "\Actor-Mixer Hierarchy\Default Work Unit" select descendants, this

this

現在のオブジェクトを返します。

$ from object "\Master-Mixer Hierarchy\Default Work Unit\Master Audio Bus" select this, descendants

parent

オブジェクトの直接の親を返します。オブジェクトに親がなければ、オブジェクトを返しません。

$ from type Sound select parent
$ from type Sound where parent.name : "*engine"

ancestors

オブジェクトの全ての祖先を、1つのシーケンスで返します。祖先に、全ての親が再帰的に含まれます。

注: 現在のオブジェクトは含まれません。現在のオブジェクトを含めるには、次を使います: select ancestors, this

$ from object "Event:Play_Hello" select ancestors
$ from object "Event:Play_Hello" select ancestors, this

referencesTo

現在のオブジェクトへのリファレンスのある、全てのオブジェクトを返します。

$ from type Effect select referencesTo
$ "Event:Play_Hello" select referencesTo

owner

オブジェクトのオーナーを返します。オーナーは、ほかのオブジェクト内で定義された"Custom"オブジェクトのためだけに設定されます。

Sharesetオブジェクトには、オーナーがありません。親（ parent ）があり、それらを参照するオブジェクトがあります（ referencesTo ）。

例えば"Custom"エフェクトのオーナーは、このエフェクトをインサートとして含むオブジェクトです。

$ from type Effect select owner
$ from type Effect where owner.name :"*env"

randomizer("<strong>PROPERTY_NAME</strong>")

Returns the randomizer object associated with the specified property. Use the following properties on the randomizer object: min, max, enabled.

PROPERTY_NAME は、現在のオブジェクトのプロパティ名を表します。Refer to Wwiseオブジェクトリファレンス for the complete list of object types and their properties. 名前は、大文字小文字の区別がありません。

$ from type sound where randomizer("pitch") != null
$ from type sound where randomizer("highpass").min < 0
$ from type sound where randomizer("lowpass").max > 0
$ from type sound where randomizer("volume").enabled = true

workunit

現在のオブジェクトで継続するために使われている、Work Unitオブジェクトを返します。

$ from type Effect select workunit

musicTransitionRoot

(DEPRECATED) Returns the Music Transition root object associated with the current object. This is deprecated. The TransitionRoot reference should be used instead.

注: これが機能するオブジェクトタイプは、MusicSegment、MusicTrack、MusicPlaylistContainer、MusicSwitchContainerだけです。

$ from project select musicTransitionRoot

musicPlaylistRoot

(DEPRECATED) Returns the Music Playlist root object associated with the current object. This is deprecated. The PlaylistRoot reference should be used instead.

注: これが機能するオブジェクトタイプは、MusicPlaylistContainerだけです。

$ from project select musicPlaylistRoot

maxDurationSource

Returns a JSON object containing the id of the Audio Source object that has the maximum playback duration (in seconds) for all descendants of the current object. The JSON object also includes the maximum duration value itself.

注: これが機能するのは、Actor-Mixer Hierarchyオブジェクト、Interactive-Music Hierarchyオブジェクト、そしてEventだけです。

$ from object "\Actor-Mixer Hierarchy" select maxDurationSource

maxDurationSourceObject

現在のオブジェクトの全ての子孫の、最大再生時間（秒単位）のあるAudio Sourceオブジェクトを返します。

注: これが機能するのは、Actor-Mixer Hierarchyオブジェクト、Interactive-Music Hierarchyオブジェクト、そしてEventだけです。

$ from object "\Actor-Mixer Hierarchy" select maxDurationSource

maxRadiusAttenuation

Returns a JSON object containing the id of the attenuation object that has the maximum radius distance in all descendants of the current objects. The JSON object also contains the maximum radius distance value itself.

注: これが機能するのは、Actor-Mixer Hierarchyオブジェクト、Interactive-Music Hierarchyオブジェクト、そしてEventだけです。

$ from type Sound select maxRadiusAttenuation

maxRadiusAttenuationObject

現在のオブジェクトの全ての子孫の中で、最大距離の半径を有する減衰オブジェクトを返します。

注: これが機能するのは、Actor-Mixer Hierarchyオブジェクト、Interactive-Music Hierarchyオブジェクト、そしてEventだけです。

$ from type Sound select maxRadiusAttenuation

audioSourceLanguage

現在のAudio Sourceに使われているランゲージオブジェクトを返します。

注: これが機能するのは、Audio Sourceオブジェクトだけです。

$ from type AudioFileSource select audioSourceLanguage

switchContainerChildContext

現在のSwitch Containerオブジェクトに関連する、Switch Containerコンテキストオブジェクトを返します。Switch Containerコンテキストオブジェクトには、Switch Containerの関連付けの設定が入っています。

注: これが機能するオブジェクトタイプは、SwitchContainerだけです。

$ from project select switchContainerChildContext

Value Expressions

数字、文字列、またはブール値を返す式

例

OBJECT_EXPRESSION.VALUE_EXPRESSION

OBJECT_EXPRESSION.OBJECT_EXPRESSION. VALUE_EXPRESSION

チェイン（chain）したオブジェクトの値を返すために、多くのオブジェクト式にゼロをチェインし、そのあとにvalue expressionをつけます。式と式を、dotで分けます。

$ where OutputBus.id = "{1514A4D8-1DA6-412A-A17E-75CA0C2149F3}"

PROPERTY_NAME
@PROPERTY_NAME
@@PROPERTY_NAME

特定オブジェクト用に、プロパティ値を返します。

Without the @, the override settings are used to find the property value. これが、再生時に使われる実際の値です（つまり、有効値）。If there is an accessor of the same name, it will take precedence; in those rare cases, @@ must be used before the property name.

@ を使うと、オブジェクトで直接定義したプロパティを、それがオーバーライドされていなくても、使います。

@@ は、 @ がないのと同じです。

$ from type Sound where volume < 0
$ from type Sound where @UserAuxSendVolume0 < 0
$ from type Sound where IsLoopingEnabled = true
$ from type sound where isloopingenabled = true

フォーム: "{0CB93450-E995-40E5-98A5-239F15B1F1D4}" の、128-bitのGUID文字列を返します。

これは、プロジェクトのオブジェクトのための、固有の識別子です。

$ where id = "{1514A4D8-1DA6-412A-A17E-75CA0C2149F3}"

shortId

オブジェクトの32-bitのショートIDの数値を返します。これは、サウンドエンジンで使われるIDです。

注: ショートIDが固有である範囲は、オブジェクトタイプによって異なります。バス、イベント、エフェクト、ゲームシンクなど、特定のオブジェクトタイプのIDは、同じタイプの全てのオブジェクトに渡り固有です。それ以外のサウンドやコンテナなどのIDは、プロジェクト全体に渡り固有です。

$ where shortId = 1588715066

name

オブジェクト名を文字列として返します。

$ from type Event where name : "*hello*"
$ where name = "Play_Hello"

notes

オブジェクトのnotes（コメントとも呼ばれる）を、文字列として返します。

$ where notes : "audiokinetic"

type

オブジェクトのタイプを、文字列として返します。

全てのオブジェクトタイプのリストを見るには、 Wwiseオブジェクトリファレンスを参照してください。

$ where type = "Sound"

nodeType

Returns the type of the node as a string.

Refer to Wwise Nodes Reference for the complete list of node types.

$ where nodeType = "Sound SFX"

classId

オブジェクトのclassIDを返します。classIDは、オブジェクトのタイプと、エフェクト、ソース、またはコンバージョンプラグインのタイプを表す数値です。

全てのclassIDのリストを見るには、 Wwiseオブジェクトリファレンスを参照してください。

$ where classId = 8847363

List Functions

Perform conditional logic or select specific elements on all items of the list at once. You can use list functions on object lists and other lists provided by WAQL, such as children, descendants, ancestors, and referencesTo.

Refer to Wwiseオブジェクトリファレンス to learn more about the object lists available in the different object types.

List Functions	概要	例
count	Returns the number of items in the list that match the specified condition, otherwise returns false. The condition statement is optional.	$ where children.count() > 3 $ where effects.count(effect.pluginname:"eq") > 0
any	Returns true if any items match the condition, otherwise returns false. Returns false if empty. The condition statement is optional.	$ where rtpc.any() $ where children.any(type = "Sound")
all	Returns true if all items in the list match the specified condition, otherwise returns false. Returns false if empty. The condition statement is mandatory.	$ where children.all(type = "Sound")
first	Returns the first item thats matches the specified condition. The condition statement is optional.	$ where effects.first(effect.pluginname :"EQ") != null $ where children.first().type = "Sound"
last	Returns the last item that matches the specified condition. The condition statement is optional.	$ where effects.last(effect.pluginname :"EQ") != null $ where children.last().type = "Sound"
take	Takes the specified number of items, and returns them in a new list.	$ select children.take(2)
skip	Skips the specified number of items, and returns the rest in a new list.	$ select effects.skip(1)
at	Returns the item at the specified index in the list.	$ select effects.at(0)
where	Returns the items that match the specified condition in a new list.	$ select effects.where(effect.pluginname :"EQ")

Boolean Operators

Evaluate a boolean expression and return true or false.

条件演算子、論理演算子	概要	例
=	文字列、または数値、またはブール値の、2つの値を比較します。	$ where name = "Hello" $ from type sound where volume = -1 $ from type sound where inclusion = true
!=	文字列、または数値、またはブール値の、2つの値を比較します。	$ where name != "Hello" $ from type sound where volume != -1 $ from type sound where inclusion != true
< <= > >=	2つの数値を比較します。	$ from type sound where volume < 0 $ from type sound where volume > -3 and volume < 0
:	2つの文字列値を比較し、指定されたテキストで始まり、単語が部分的に一致すれば、trueを返します。単語の最後を一致させるために、ワイルドカードを使うこともできます。	$ where name : "Hello" $ where name : "Hel" $ where name : "*ello"
= /REGEX/	指定した正規表現が、現在の文字列と一致すれば、trueを返します。 ECMAScript正規表現を使います。	$ where name = /Hello/ $ where name = /llo$/ $ where name = /[a-z][0-9]/
!	Negates an expression.	$ where !(name = "Hello") $ from type sound where !(volume < -3)
および	2つの式を結合してその接続詞にします。	$ from type sound where name = "Hello" and volume = 0 $ from type sound where volume > -3 and volume < 0
または	2つの式を結合してその選言にします。	$ where name = "Hello" or name = "Hi" $ from type sound where volume = -3 or volume = 0
()	式に対する論理演算の順序を指定します。	$ from type sound where (volume = -3 or volume = 0) and (name = "Hello" or name = "Hi")

Advanced Operators

Perform complex data manipulations.

Synopsis	概要	例
OBJECT_EXPRESSION.{EXPRESSION1,EXPRESSION2,...}	Composition operator. Returns a new JSON object composed of the enumerated expressions. The enumerated expressions become keys on the resulting objects, with corresponding values. You can use this operator to control which elements to obtain on Wwise objects. Note: This operator can only be used in return expressions.	$ from type sound return: ["path", "OutputBus.{name, shortid}"] $ from type audiofilesource where markers.any() return: ["path", "Markers.{time, label}"] $ from type event return: ["name", "children.target.{path, type}"]
OBJECT_EXPRESSION.[EXPRESSION1,EXPRESSION2,...]	Concatenation operator. Returns a new list, which is the concatenation of the enumerated lists or objects.	$ from type randomsequencecontainer return: ["[this, ancestors].name"]
EXPRESSION as NAME	Alias keyword. Renames the specified expression to another name, which becomes the key in the results. You can use this keyword to rename complex assessors. Note: This keyword can only be used in return expressions.	$ from type sound return : ["outputbus.name as bus", "duration.max as duration"] $ from type event return : ["name as event", "children.target.[this, descendants].where(type=\"Sound").originalRelativeFilePath as originals"]

Synopsis

概要

例

OBJECT_EXPRESSION.{EXPRESSION1,EXPRESSION2,...}

Composition operator. Returns a new JSON object composed of the enumerated expressions. The enumerated expressions become keys on the resulting objects, with corresponding values. You can use this operator to control which elements to obtain on Wwise objects.

Note: This operator can only be used in return expressions.

$ from type sound
return: ["path", "OutputBus.{name, shortid}"]

$ from type audiofilesource where markers.any()
return: ["path", "Markers.{time, label}"]

$ from type event
return: ["name", "children.target.{path, type}"]

OBJECT_EXPRESSION.[EXPRESSION1,EXPRESSION2,...]

Concatenation operator. Returns a new list, which is the concatenation of the enumerated lists or objects.

$ from type randomsequencecontainer
return: ["[this, ancestors].name"]

EXPRESSION as NAME

Alias keyword. Renames the specified expression to another name, which becomes the key in the results. You can use this keyword to rename complex assessors.

Note: This keyword can only be used in return expressions.

$ from type sound
return : ["outputbus.name as bus", "duration.max as duration"]

$ from type event
return : ["name as event", "children.target.[this, descendants].where(type=\"Sound").originalRelativeFilePath as originals"]

このページはお役に立ちましたか？

サポートは必要ですか？

ご質問や問題、ご不明点はございますか？お気軽にお問い合わせください。

サポートページをご確認ください

あなたのプロジェクトについて教えてください。ご不明な点はありませんか。

プロジェクトを登録していただくことで、ご利用開始のサポートをいたします。

Wwiseからはじめよう

Wwise SDK

Wwise Authoring Query Language (WAQL) リファレンス

概要

リファレンス

Sources

Transforms

Expressions

List Functions

Boolean Operators

Advanced Operators

このページはお役に立ちましたか？

サポートは必要ですか？

あなたのプロジェクトについて教えてください。ご不明な点はありませんか。