音频使用/函数

概述

Corona audio 系统让您可以访问高级的 OpenAL 功能。它具有 32 个不同的声道，您可以在这些声道上播放声音效果或流媒体音频文件。该系统为每个声道提供唯一的音量设置，并为所有声道提供主音量级别。

音频系统是一个“尽力而为”的系统。请求的声音将尽快播放，但不能保证它们会在确切的时间开始或结束。如果您正在流式传输歌曲，并且由于 CPU 压力导致缓冲区欠载，音频系统将在可以的情况下继续播放，但歌曲的播放完成时间可能会晚于预期。

请继续阅读以了解音频 API 函数和方法、可接受的文件格式以及性能技巧。

声音 vs. 流媒体

音频系统提供两种加载函数：audio.loadSound() 和 audio.loadStream()。您提供给这两个函数的文件之间没有强制性的区别，但应根据以下一般准则使用适当的方法。

• audio.loadSound() — 将整个声音加载到内存中。它应该用于较短的音频文件，这些文件可能会在整个应用程序中重复使用。

• audio.loadStream() — 在音频文件的持续时间内读取一小块音频文件。它应该用于较长的音轨，如背景音乐。请注意，与使用 audio.loadSound() 加载的文件相比，流式传输的文件可能会产生略高的延迟成本和 CPU 成本。

所有 audio API 都可以应用于通过任一方法加载的文件。但是，在某些情况下，差异并非完全透明。

音频格式

Corona 音频系统支持不同的格式，具体取决于环境/平台。

声道和音量

如概述中所述，有 32 个音频声道可用。每个声音效果或流媒体音轨都必须在不同的声道上播放。如果您没有显式设置要在其上播放音频的声道，Corona 将尝试找到一个空闲声道来播放音频文件。

在某些情况下，为不同目的**保留**某些声道很有用。例如，您可能希望为音乐、语音和声音效果设置不同的音量级别。在这种情况下，您可以保留一些位于范围较低端的声道，并有效地防止在这些声道上自动分配。这是通过 audio.reserveChannels() API 完成的，其中您通过audio.reserveChannels( x )阻止通道 1 到 x。然后，假设您为音乐和语音保留了几个声道，则其余声道可用于自动分配声音效果。

Corona 还提供各种函数来检查声道的状态。这些函数包括 audio.isChannelActive()、audio.isChannelPlaying() 和 audio.isChannelPaused()。

audio.setVolume( 0.5 )  --set the master volume to 50%

audio.setVolume( 0.5, { channel=1 } )  --set the volume level of channel 1 to 50%

音频句柄

当您使用 audio.loadSound() 或 audio.loadStream() 加载音频文件时，Corona 会返回该音频文件的**句柄**。假设句柄保留在内存中，则可以使用此句柄来引用和播放音频文件。

以下示例显示如何将基本声音文件加载到句柄 soundEffect 中并立即播放它。

local soundEffect = audio.loadSound( "chime.wav" )
audio.play( soundEffect )

请注意，只有在您需要播放、释放、搜索/倒带或检查音频文件的持续时间时才使用音频句柄。音频文件播放后，您无法通过引用其句柄来暂停、停止或控制其音量。相反，您必须引用它正在播放的**声道**，因为同一个文件（句柄）可能在多个声道上播放。

播放音频

local soundTable = {

    chimeSound = audio.loadSound( "chime.wav" ),
    bellSound = audio.loadSound( "bell.wav" ),
    buzzSound = audio.loadSound( "buzz.aac" ),
    clickSound = audio.loadSound( "click.aac" )
}

audio.play( soundTable["chimeSound"] )

local backgroundMusic = audio.loadStream( "backgroundMusic.wav" )
audio.play( backgroundMusic )

音频事件

音频系统为 `audio.play()` 提供了一个完成事件，可用于执行与声音相关的操作。例如，如果您有一个滴答作响的定时炸弹对象，您可以使用 `onComplete` 回调来触发动画炸弹爆炸和单独的爆炸声。

要侦听声音的完成事件，只需在选项表的 `onComplete` 值中指定侦听器函数即可

local function bombExplode( event )
    --bomb has exploded!
end

local tickSound = audio.loadSound( "tick.wav" )
audio.play( tickSound, { onComplete=bombExplode } )

反过来，当调用侦听器函数时，可以使用以下 `event` 参数

• `event.name` — 字符串，值为 `"soundCompletion"`.
• `event.channel` — 与完成的声音关联的声道号.
• `event.handle` — 与完成的声音关联的音频句柄.
• `event.completed` — 布尔值，如果音频文件自行完成，则为 `true`；如果音频文件被过早停止，则为 `false`.

控制音频

除了上面描述的音量控制方法外，Corona 还提供以下音频控制函数

释放音频

如果您已完成使用音频文件，则**必须**释放它们。 这将释放分配给音频文件的内存。 要释放音频文件，请调用 audio.dispose() 函数，并将音频文件的**句柄**作为其唯一参数传递。

audio.dispose( audioHandle )

如果您已将音频句柄组织到一个表中，如播放音频中所示，则可以使用简单的 pairs 循环来释放每个音频文件。

audio.stop()

for s,v in pairs( soundTable ) do
    audio.dispose( soundTable[s] )
    soundTable[s] = nil
end

性能技巧

application =
{
    content =
    {
        width = 320,
        height = 480,
        scale = "letterbox",
        audioPlayFrequency = 22050
    },
}