Web 中的音频
有关 Web 中的音频功能的信息。
阅读时间10 分钟最后更新于 5 天前
本 Page 仅提供有关 Web 平台中的音频功能的信息。要了解如何在 Unity 项目中使用音频,请参阅 Audio Overview。
由于 Unity 使用 FMOD 来管理平台的音频,因此 Web 平台支持有限的音频功能,仅包含 Basic Features。FMOD 依赖ON线程,而 WebGL API 不Support这些线程。因此,Unity 使用基ON内部 Web 音频 API 的实现,使浏览器能够手柄音频播放和混音。
支持的类
Unity Web 支持以下 API 类:
类 | WebGL 支持状态 |
|---|---|
| AudioSource | WebGL 支持某些 API。有关指定的 Support 细节,请参阅 AudioSource。 |
| AudioListener | 支持 All API。 |
| AudioClip | WebGL 支持某些 API。请参阅 AudioClip 以了解指定的 Support 细节。 |
| AudioMixer | WebGL 支持某些 API。请参阅混音器以了解指定的 Support 细节。 |
| SystemInfo.supportsAudio | 浏览器为 WebGL 提供音频 Support。因此, |
| **麦克**风 | 不支持。 |
AudioSource
AudioSource API 支持 Basic 位置音频播放,包括:
- 暂停和恢复
- 衰减
- 音高设置
- 多普勒效应 Support
Unity WebGL 支持以下 AudioSource API:
设置 | 描述 |
|---|---|
| 剪辑 | 确定Next一个播放的音频剪辑。 |
| dopplerLevel | 设置 AudioSource 的多普勒缩放。 |
| ignoreListenerPause | 允许 AudioSource 忽略 |
| ignoreListenerVolume | 忽略结束用户的 AudioSource 音量。 |
| isPlaying | 如果 |
| loop | 允许应用程序循环 |
| maxDistance | 设置 |
| minDistance | 设置 AudioSource.clip 音量不再上升的最小距离。声音开始衰减超过最小距离。 |
| mute | 使 AudioSource 静音。 |
| 音高 | 设置 |
| playOnAwake | ON 唤醒播放 AudioSource。 |
| rolloffMode | 设置 AudioSource Attenuation 随时间距离的变化。 |
| Time(时间) | 设置播放位置(以秒为单位)。 |
| timeSamples | 设置脉冲代码调制 (PCM) 样本中的播放位置。 |
| velocityUpdateMode | 设置 AudioSource 在已修复还是动态更新 Loop 中更新。 |
| 体积 | 设置 AudioSource 的音量(0.0 到 1.0)。 |
| 暂停 | 暂停 |
| 播放 | 播放 |
| PlayDelayed | 以指定的延时播放 |
| PlayOneShot | 播放 AudioClip 并按 volumeScale 缩放 AudioSource 音量。 |
| PlayScheduled | 在指定的时间播放 AudioSource。 |
| SetScheduledEndTime | 设置计划 |
| SetScheduledStartTime | 设置计划 |
| 停止: | 停止播放 |
| UnPause | 取消暂停的 |
| PlayClipAtPoint | 在世界空间中的给定位置播放 |
AudioClip
Unity WebGL 以大多数浏览器支持的高级音频编码 (AAC) Format 导入 AudioClip 文件。Unity WebGL 支持以下 AudioClip API:
属性 | 描述 |
|---|---|
| Frequency | Clip In 赫兹的样本频率。 |
| "length": | AudioClip 的长度(以秒为单位)。 |
| loadState | 返回与 AudioClip 关联的音频数据的当前加载状态。 |
| 样本 | 样本 AudioClip 的长度。 |
| loadType | 剪辑的加载类型。您可以在 Inspector 中设置 AudioClip 加载类型。 |
方法 | 描述 | 其他信息 |
|---|---|---|
| AudioClip.Create | 创建具有指定 Name 和长度的 AudioClip。 | Unity WebGL 部分支持 |
| AudioClip.SetData | 在 AudioSource.clip 中设置样本数据。 | Unity WebGL 部分支持 |
| AudioClip.GetData | 从 AudioSource.clip 检索包含样本数据的 Array。 | Unity WebGL 部分支持 |
音频 Looping 问题
ON WebGL 构版本中Looping播放音频剪辑When,音频在Loop点可能有可听的干扰。由于 AAC 是许可Format,Unity 依赖ON主机平台的编码器将文件转换为 AAC。编码器可能会在编码期间更改前 1024 个样本,从而影响Loop点并在声音循环When导致声音干扰。要解决此问题:
- 使用 WAV 作为音频源File Format。
- 向 WAV 文件的开头添加至少 1024 个静默样本。
- 编辑 WAV 的代码块,使 Loop 在添加静默后开始。
smpl
混音器
Unity Web 支持混音器资源的某些功能。
您可以使用 Web ON的混音器执行以下操作:
- 创建混音器资源。
- 将混音器组添加到层级视图中。
- 调整每个组的音量。要使用脚本显示或更改音量,请使用 AudioMixer.SetFloat。
经压缩的音频
要在 Unity 中将经压缩的音频与 WebGL 结合使用,请将 AudioClip loadType 设置为以下选项之一:
还可以在 Unity Editor 中Change这些Settings。要更改设置,请选择音频剪辑,然后将 Inspector 窗口中的加载类型设置为首选选项(解压缩ON加载或经压缩的内存)。
压缩方法 | 描述 | 注意事项 |
|---|---|---|
| CompressedInMemory | 使用此属性可以压缩磁盘ON的音频,并在加载到应用程序程序内内存后保持经压缩的状态。 | 经压缩的音频可能会导致延迟,并且在音频播放When精度较低。但是,经压缩的音频在应用程序程序中使用的内存于解压缩音频。最佳做法是对不受精度影响的音频(例如背景音乐)使用 |
| DecompressOnLoad | 使用此属性可以压缩磁盘ON的音频,类似于 CompressedInMemory,并在加载到应用程序程序内内存When解压缩。 | 与经压缩的音频相比,解压缩音频使用amount内存,但具有更低的延迟和更大的音频灵活性。对受精度影响的音频使用 |
iOS Devices DecompressOnLoad 的问题
如果将音频剪辑的设置为 ,则处于静默模式的 ON iOS Devices 可能无法听到该剪辑。此问题仅在 Web 构建中发生。
loadTypeDecompressOnLoadWeb 音频系统使用浏览器的 节点加载具有加载类型的音频 Clips。静默模式下的 ON iOS Devices 听不到声音,因为 WebKit 将此节点类型与用于声音的 进行不同的分类。
AudioBufferSourceNodeDecompressOnLoadCompressedInMemoryMediaElementSourceNode要确保无论静默模式如何都播放音频,请将音频剪辑设置为 。如果需要在 Scene 启动时加载声音,建议完全在临时 Scene 中加载声音并额外加载 Target Scene。
loadTypeCompressedInMemory音频播放和浏览器SECURITY
出于 SECURITY 原因,在用户通过鼠标单击、触摸事件或 Key 键与应用程序网页交互结束之前,浏览器不允许音频播放。使用加载中屏幕允许结束用户与应用程序程序交互,并在主要内容开始之前Start音频播放。