|
Wwise Unity Integration Documentation
|
通用组件
AkAmbient
使用此组件来将 Wwise Event 关联到场景中的对象。这样可以依据所选 Unity Trigger 来在不同时机播放声音。该组件尤其适用于环境声（与场景中的对象关联的声音），不过也可另作他用。 AkAmbient 以 AkEvent 为基类，提供有 Play/Stop、Play Multiple、Stop Multiple 和 Stop All 按钮，方便预览关联的 Wwise Event。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkAmbient 。
AkAudioListener
将此脚本绑定到代表听者的游戏对象上。该组件一般会添加到 Camera 或 Player 对象，但也可在运用 3D 总线时添加到其他游戏对象。 isDefaultListener 决定游戏对象是否会被视为默认听者。该听者将自动监听所有 AkGameObjListenerList 中未绑定听者的游戏对象。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkAudioListener 。
AkBank
在指定时机加载和卸载 SoundBank。您可以使用 Decode Compressed Data 选项在指定时机解压 Vorbis 声音。在这种情况下，会用准备的方式加载 SoundBank。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkBank 。
另请参阅 SDK 文档：加载 SoundBank。
AkEmitterObstructionOcclusion
在当前游戏对象对应的发声体和听者之间至少有一个障碍物时完全阻挡/遮蔽发声体。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkEmitterObstructionOcclusion 。
AkEnvironment
使用此组件来定义混响区域。为了确保能够正常工作，必须将该组件添加到 Collider 对象。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkEnvironment 和 AkEnvironmentPortal 。
AkEnvironmentPortal
使用此组件来定义两个不同 AkEnvironment 区域的重叠区，以便在两个区域之间进行混音。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkEnvironment 和 AkEnvironmentPortal 。
AkEvent
辅助类知道一个 Wwise 事件，以及何时在 Unity 中触发它。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkEvent 。
AkGameObj
此组件代表场景中的声音对象，用来追踪其位置和其他 Game Sync（如 Switch 以及 RTPC）和环境变量。您可以将该组件添加至任何发声体对象。它也会自动添加到绑定有 AkAudioListener 组件的对象。If it is not present on a Unity Game Object that is passed to Wwise, it is automatically added with the default values. It is important that this Wwise Component is above any other Wwise Component
See 在 Inspector 中使用 AkGameObj for a description of its public properties.
AkInitializer
此组件用于初始化 Wwise 声音引擎并更新音频帧。它被标记为 DontDestroyOnLoad ，因此在整个游戏当中都会始终保持有效，并非只作用于一个场景。您可以通过修改此脚本来更改声音引擎的初始化参数。其中有些已经暴露在属性检视器中。为了确保能够正常初始化音频，在游戏开始时必须已将其绑定到一个 Game Object 上。It must be executed before any other MonoBehaviors that use AkUnitySoundEngine.
- 参见
AkListenerDistanceProbe
此组件会为指定的听者 Game Object 指派 Game Object 作为 Distance Probe。Distance Probe 主要用在第三人称游戏中，其会基于不同于听者的位置向声音应用衰减。
有关公共属性的说明，请参阅 利用 Ak Listener Distance Probe 组件对第三人称游戏中的听者进行自定义 章节。
AkState
此组件会在每次触发所选 Unity Event 时调用 ak.soundengine.setState()。比如，您可以将该组件添加到 Unity Collider 以便在有对象进入时进行触发。
有关公共属性的说明，请参阅 在 Inspector 中使用 AkState 章节。
AkSwitch
此组件会在每次触发所选 Unity Event 时调用 ak.soundengine.setSwitch()。比如，您可以将该组件添加到 Unity Collider 以便在有对象进入时进行触发。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkSwitch 。
Spatial Audio 组件
AkEarlyReflections
将此脚本绑定到代表发声体的游戏对象上。此游戏对象发出的声音会在 AkSurfaceReflector 附近产生早期反射。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkEarlyReflections 。
AkRadialEmitter
将此脚本绑定到代表发声体的游戏对象上。此游戏对象发出的声音将依据以游戏对象所在位置为中心的内外半径应用散布效果。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkRadialEmitter 。
AkReverbZone
将此脚本绑定到游戏对象上来连通两个 Room：一个作为 Reverb Zone，一个作为其父对象。将脚本绑定到带有 AkRoom 组件的游戏对象上来将该 Room 设为 Reverb Zone。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkReverbZone 页面。
AkRoom
AkRoom 是一个封闭的环境，仅可通过 AkRoomPortal 与外部/其他 Room 互通。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkRoom 。
AkRoomAwareObject
该游戏对象会感知 AkRoom 组件。将此脚本绑定到 Spatial Audio Listener 以及发出 Spatial Audio 声音的 GameObject 上。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkRoomAwareObject 。
AkRoomPortal
AkRoomPortal 可将两个 AkRoom 组件互连，并在两者之间传播声音。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkRoomPortal 和 AkRoomPortalObstruction 。
AkRoomPortalObstruction
在当前游戏对象对应的 Spatial Audio Portal 和 Spatial Audio Listener 之间至少有一个障碍物时完全阻挡来自 Spatial Audio Portal 的声音。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkRoomPortal 和 AkRoomPortalObstruction 。
AkSpatialAudioDebugDraw
将此脚本绑定到通过 Spatial Audio 发出声音的游戏对象上。该脚本可在当前游戏对象和 Spatial Audio Listener 之间绘制早期反射或衍射路径以方便进行调试。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkSpatialAudioDebugDraw 。
AkSpatialAudioListener
将此脚本绑定到代表听者的游戏对象上。
有关其公共属性的说明，请参阅 在 Inspector 中使用 AkSpatialAudioListener 。
AkSurfaceReflector
此组件会将 GameObject 几何构造所含的三角形转换为声音反射表面。
有关公共属性的说明，请参阅 在 Inspector 中使用 AkSurfaceReflector 章节。
组件代码
如需查看 Wwise 组件的代码，请通过组件的“设置”按钮打开对应的 C# 脚本。
若想为自己的 Wwise Unity Integration 工程编写自定义脚本，建议使用 Wwise Types 来实现。
- 参见