menu
版本
2021.1.14.8108
2024.1.4.8780
2023.1.12.8706
2022.1.18.8567
2021.1.14.8108
2019.2.15.7667
2019.1.11.7296
2018.1.11.6987
2017.2.10.6745
2017.1.9.6501
2016.2.6.6153
2015.1.9.5624
menu_open
|
Wwise Unreal Integration Documentation
|
Blueprint 函数
一些 Wwise 的全局函数是对脚本开放的，其中大部分会直接对参数进行换算并将其传给对应的 Wwise API。Audiokinetic 类别中提供以下函数：
Cancel Event Callback
取消提供给 PostEvent 的回调事件。在执行此节点后，将不再调用 Blueprint Event。
Get Ak Audio Type User Data
从给定素材返回指定类型的用户数据。
Get Ak Component
获取给定组件绑定和控制的 AkComponent 。您可以直接针对 AkComponent 执行多种操作（详见 AkComponent Blueprint 函数 ）。
Get Ak Media Asset User Data
从给定媒体素材返回指定类型的用户数据。
Get Occlusion Scaling Factor
获取声笼比例系数。
Get RTPC Value
获取 Game Parameter 的值，可以选择指向给定 Actor 的根组件。
Get Speaker Angles
获取指定设备的扬声器角度。有关详细信息，请参阅 GetSpeakerAngles。
Is Editor
若正在运行的应用程序为 Editor，则返回 true，否则返回 false。
Is Game
若可从 WorldContextObject 参数获取 World 且其 WorldType 为 Game、GamePreview 或 Play-In-Editor，则返回 true，否则返回 false。
Post Event At Location
在指定位置发送 Wwise Event。这是一个针对没有对应 AkComponent 的临时 Wwise Game Object 创建的一次性声音。
Post Event At Location Async
在指定位置发送 Wwise Event。异步版本会等到加载媒体之后再发送 Event。这是一个针对没有对应 AkComponent 的临时 Wwise Game Object 创建的一次性声音。
重置 RTPC 值
将 Game Parameter 的值重置为 Wwise 工程中指定的默认值；可设为全局作用域或游戏对象作用域，还可选择指向给定 Actor 的根组件。若未指定 Actor 或将其保留为空，则设置全局 Game Parameter 值。若未提供 RTPCValue ，则使用 RTPC 参数。否则，予以忽略。
Set Bus Config
为指定总线强制设置声道配置。有关详细信息，请参阅 SetBusConfig。
Set Multiple Channel Emitter Positions
为单个游戏对象设置多个位置，并允许灵活指派输入声道。参数 GameObjectAkComponent 是要设置位置的游戏对象的 AkComponent。ChannelMasks 是一组要应用于各个位置的声道掩码。Positions 是要应用的一组 Transform。MultiPositionType 是 Position Type。注意，此功能与 Spatial Audio 不兼容。
Set Multiple Positions
为单个游戏对象设置多个位置。通过为单个游戏对象设置多个位置，只需占用一个声部的资源就可模拟多个声源。我们可以采用这种方式来模拟墙壁开口、区域声音或在同一区域发出相同声音的多个对象。注意：调用只有一个位置的 SetMultiplePositions() 跟调用 SetPosition() 是一样的。参数 GameObjectAkComponent 是要设置位置的游戏对象的 AkComponent。Positions 是要应用的一组 Transform。MultiPositionType 是 Position Type。注意，此功能与 Spatial Audio 不兼容。有关不同定位类型的详细信息，请参阅 MultiPositionType。
Set Multiple Speaker Emitter Positions
为单个游戏对象设置多个位置，并允许灵活指派输入扬声器。参数 GameObjectAkComponent 是要设置位置的游戏对象的 AkComponent。SpeakerMasks 是一组要应用于各个位置的扬声器掩码。Positions 是要应用的一组 Transform。MultiPositionType 是 Position Type。注意，此功能与 Spatial Audio 不兼容。
Set Occlusion Scaling Factor
设置声笼比例系数。
Set Panning Rule
为指定输出设置声像摆位规则。在初始化声音引擎后可随时进行更改。有关详细信息，请参阅 SetPanningRule。
Set RTPC Value
设置 Game Parameter 的值，可以选择指向给定 Actor 的根组件。若未指定 Actor 或将其保留为空，则设置全局 Game Parameter 值。
Set Speaker Angles
为指定设备设置扬声器角度。有关详细信息，请参阅 SetSpeakerAngles。
Set State
针对给定 State Group 设置活跃 State。
Spawn Ak Component at Location
在指定位置创建新的 AkComponent。在默认情况下，会在对应的 Event 播放结束时自动销毁该组件。参数 Auto Post 控制是否在创建组件时立即发送事件（默认值为 false）。高级参数 Auto Destroy 控制是否在针对此组件发送的第一个 Event 结束时销毁组件（默认值为 true）。
此 Blueprint 节点尤其方便针对一次性声音设置 Switch。为了实现此行为，可禁用 Auto Post，并针对生成的 Ak Component 设置 Switch，然后发送 Event（如下图所示）。
Stop All
停止播放当前播放的所有声音。
Set Current Audio Culture
有关详细信息，请参阅 音频素材的本地化 章节。
Set Current Audio Culture Async
有关详细信息，请参阅 音频素材的本地化 章节。
其他
子类别中还提供其他一些函数：