Version: 2023.2

Mobile

class in UnityEngine

切换到手册

描述

此类封装的属性和方法用于处理 iOS/Android 上的音频输出线程。

使用此类可降低应用程序或游戏的功耗。通常,对于单曲 循环音乐和短音效,应将 AudioSettings.Mobile.stopAudioOutputOnMute 设置为 true,另外,如果应用程序的用户在游戏设置中将音乐/声音音量设置为 0,还应调用 AudioSettings.Mobile.StopAudioOutput。这样有助于减少 大多数移动设备的功耗。此外,还可以检查 AudioSettings.Mobile.muteState 属性和侦听 AudioSettings.Mobile.OnMuteStateChanged 事件以在需要时停止/开始音频输出线程。

但是,如果游戏或应用程序有更复杂的声音或音乐逻辑,这样可能会导致同步问题。具体而言,当输出停止时播放的声音 是从输出重新启动时的相同位置恢复的,因此,可能与在该段时间内继续 运行的任何游戏代码不同步。因此,如果要依赖于应与音频的组成部分同步,而在输出关闭或开启过程中 会继续播放的游戏元素,则不适合使用此设置。

静态变量

audioOutputStarted如果音频输出线程在运行,则返回 true。
muteState如果当前设备媒体音量为 0,则返回 true。
stopAudioOutputOnMute如果将此属性设置为 true,则音频输出线程会在设备媒体音量设置为 0 时自动停止,在音量不为 0 时再次启动。

静态函数

StartAudioOutput在 Android/iOS 上启动音频输出线程。
StopAudioOutput在 Android/iOS 上停止音频线程。

Events

OnMuteStateChanged每当设备静音状态发生变化时调用的委托。