文档

Unity 引擎

Unity 引擎

Web 中的音频

有关 Web 中的音频功能的信息。
阅读时间10 分钟最后更新于 5 天前

本 Page 仅提供有关 Web 平台中的音频功能的信息。要了解如何在 Unity 项目中使用音频,请参阅 Audio Overview。
由于 Unity 使用 FMOD 来管理平台的音频,因此 Web 平台支持有限的音频功能,仅包含 Basic Features。FMOD 依赖ON线程,而 WebGL API 不Support这些线程。因此,Unity 使用基ON内部 Web 音频 API 的实现,使浏览器能够手柄音频播放和混音。
注意
Google Chrome 新建 自动播放 policy会阻止在某些情况下自动自动播放音频和视频。例如,虽然游戏可能设置为在游戏加载后立即自动播放某些背景音乐,但除非单击或点击 ON 网站,否则不会自动播放。ON 如何启用或禁用此 policy 的更多信息,请参阅 Google Chrome ON Chrome 中的自动播放 policy 的文档。

支持的类

Unity Web 支持以下 API 类:

类

WebGL 支持状态

AudioSourceWebGL 支持某些 API。有关指定的 Support 细节,请参阅 AudioSource。
AudioListener支持 All API。
AudioClipWebGL 支持某些 API。请参阅 AudioClip 以了解指定的 Support 细节。
AudioMixerWebGL 支持某些 API。请参阅混音器以了解指定的 Support 细节。
SystemInfo.supportsAudio浏览器为 WebGL 提供音频 Support。因此,
SystemInfo.supportsAudio
始终为 true。
**麦克**风不支持。

AudioSource

AudioSource API 支持 Basic 位置音频播放,包括:
  • 暂停和恢复
  • 衰减
  • 音高设置
  • 多普勒效应 Support
Unity WebGL 支持以下 AudioSource API:

设置

描述

剪辑确定Next一个播放的音频剪辑。
dopplerLevel设置 AudioSource 的多普勒缩放。
ignoreListenerPause允许 AudioSource 忽略
AudioListener.pause
并继续播放音频。
ignoreListenerVolume忽略结束用户的 AudioSource 音量。
isPlaying如果
AudioSource.clip
正在播放,则返回 true。
loop允许应用程序循环
AudioSource.clip
。
maxDistance设置
AudioSource.clip
停止衰减或变得听不见的最大距离。
minDistance设置 AudioSource.clip 音量不再上升的最小距离。声音开始衰减超过最小距离。
mute使 AudioSource 静音。
音高设置
AudioSource.clip
的音高。WebGL 仅支持音高高值。
playOnAwakeON 唤醒播放 AudioSource。
rolloffMode设置 AudioSource Attenuation 随时间距离的变化。
Time(时间)设置播放位置(以秒为单位)。
timeSamples设置脉冲代码调制 (PCM) 样本中的播放位置。
velocityUpdateMode设置 AudioSource 在已修复还是动态更新 Loop 中更新。
体积设置 AudioSource 的音量(0.0 到 1.0)。
暂停暂停
AudioSource.clip
。
播放播放
AudioSource.clip
。
PlayDelayed以指定的延时播放
AudioSource.clip
(以秒为单位)。
PlayOneShot播放 AudioClip 并按 volumeScale 缩放 AudioSource 音量。
PlayScheduled在指定的时间播放 AudioSource。
SetScheduledEndTime设置计划
AudioSource.clip
结束的时间。
SetScheduledStartTime设置计划
AudioSource.clip
开始的时间。
停止:停止播放
AudioSource.clip
。
UnPause取消暂停的
AudioSource.clip
。
PlayClipAtPoint在世界空间中的给定位置播放
AudioSource.clip
。
注意
由于音频数据在浏览器中使用
decodeAudioData
进行解码,因此音频文件的运行时采样 Rate 可能与序列化音频数据 (44100Hz) 不同,因为浏览器将 Match
BaseAudioContext
采样 Rate,通常与设备的音频驱动程序设置一致。考虑到这一点,我们建议在运行时验证
AudioClip.frequency
值,或在执行查找操作时使用
AudioSource.time
。

AudioClip

Unity WebGL 以大多数浏览器支持的高级音频编码 (AAC) Format 导入 AudioClip 文件。Unity WebGL 支持以下 AudioClip API:

属性

描述

FrequencyClip In 赫兹的样本频率。
"length":AudioClip 的长度(以秒为单位)。
loadState返回与 AudioClip 关联的音频数据的当前加载状态。
样本样本 AudioClip 的长度。
loadType剪辑的加载类型。您可以在 Inspector 中设置 AudioClip 加载类型。

方法

描述

其他信息

AudioClip.Create创建具有指定 Name 和长度的 AudioClip。Unity WebGL 部分支持
AudioClip.Create
。浏览器不支持动态串流,因此要使用
AudioClip.Create
,请将 Stream 设置为 false。
AudioClip.SetData在 AudioSource.clip 中设置样本数据。Unity WebGL 部分支持
AudioClip.SetData
。只能对加载类型设置为ON加载解压缩的经压缩的音频文件使用此方法。请参阅经压缩的音频。
AudioClip.GetData从 AudioSource.clip 检索包含样本数据的 Array。Unity WebGL 部分支持
AudioClip.GetData
。只能对加载类型设置为ON加载解压缩的经压缩的音频文件使用此方法。请参阅经压缩的音频。
注意
有关 ON Linux 的音频剪辑 Support,请确保已安装 ffmpeg 包。

音频 Looping 问题

ON WebGL 构版本中Looping播放音频剪辑When,音频在Loop点可能有可听的干扰。由于 AAC 是许可Format,Unity 依赖ON主机平台的编码器将文件转换为 AAC。编码器可能会在编码期间更改前 1024 个样本,从而影响Loop点并在声音循环When导致声音干扰。要解决此问题:
  1. 使用 WAV 作为音频源File Format。
  2. 向 WAV 文件的开头添加至少 1024 个静默样本。
  3. 编辑 WAV 的
    smpl
    代码块,使 Loop 在添加静默后开始。

混音器

Unity Web 支持混音器资源的某些功能。
您可以使用 Web ON的混音器执行以下操作:
  • 创建混音器资源。
  • 将混音器组添加到层级视图中。
  • 调整每个组的音量。要使用脚本显示或更改音量,请使用 AudioMixer.SetFloat。
注意
音量 是唯一可以ON Web 上Change的属性。不支持其他属性和音效。

经压缩的音频

要在 Unity 中将经压缩的音频与 WebGL 结合使用,请将 AudioClip loadType 设置为以下选项之一:
还可以在 Unity Editor 中Change这些Settings。要更改设置,请选择音频剪辑,然后将 Inspector 窗口中的加载类型设置为首选选项(解压缩ON加载或经压缩的内存)。

压缩方法

描述

注意事项

CompressedInMemory使用此属性可以压缩磁盘ON的音频,并在加载到应用程序程序内内存后保持经压缩的状态。经压缩的音频可能会导致延迟,并且在音频播放When精度较低。但是,经压缩的音频在应用程序程序中使用的内存于解压缩音频。最佳做法是对不受精度影响的音频(例如背景音乐)使用
CompressedInMemory
。
DecompressOnLoad使用此属性可以压缩磁盘ON的音频,类似于 CompressedInMemory,并在加载到应用程序程序内内存When解压缩。与经压缩的音频相比,解压缩音频使用amount内存,但具有更低的延迟和更大的音频灵活性。对受精度影响的音频使用
DecompressedOnLoad
(例如,角色对话框或音效)。

iOS Devices DecompressOnLoad 的问题

如果将音频剪辑的
loadType
设置为
DecompressOnLoad
,则处于静默模式的 ON iOS Devices 可能无法听到该剪辑。此问题仅在 Web 构建中发生。
Web 音频系统使用浏览器的
AudioBufferSourceNode
节点加载具有
DecompressOnLoad
加载类型的音频 Clips。静默模式下的 ON iOS Devices 听不到声音,因为 WebKit 将此节点类型与用于
CompressedInMemory
声音的
MediaElementSourceNode
进行不同的分类。
要确保无论静默模式如何都播放音频,请将音频剪辑
loadType
设置为
CompressedInMemory
。如果需要在 Scene 启动时加载声音,建议完全在临时 Scene 中加载声音并额外加载 Target Scene。

音频播放和浏览器SECURITY

出于 SECURITY 原因,在用户通过鼠标单击、触摸事件或 Key 键与应用程序网页交互结束之前,浏览器不允许音频播放。使用加载中屏幕允许结束用户与应用程序程序交互,并在主要内容开始之前Start音频播放。