Golang跨平台低层级音频播放插件库Oto的使用

Oto是一个低层级的音频播放库，支持多种平台。以下是关于如何使用Oto的详细介绍和示例代码。

支持的平台

• Windows (不需要Cgo)
• macOS (不需要Cgo)
• Linux
• FreeBSD
• OpenBSD
• Android
• iOS
• WebAssembly
• Nintendo Switch
• Xbox

前提条件

在某些平台上，您需要在路径中安装Go可以使用的C/C++编译器。

macOS

Oto需要AudioToolbox.framework，但会自动链接。

iOS

Oto需要以下框架：

• AVFoundation.framework
• AudioToolbox.framework

将它们添加到Xcode项目的"Linked Frameworks and Libraries"中。

Linux

需要安装ALSA。在Ubuntu或Debian上运行：

apt install libasound2-dev

在基于RedHat的Linux发行版上运行：

dnf install alsa-lib-devel

使用方法

Oto的两个主要组件是Context和Players。上下文处理与操作系统和音频驱动程序的交互，因此程序中只能有一个上下文。

从内存播放音频

以下是一个加载并播放MP3文件的示例：

package main

import (
    "bytes"
    "time"
    "os"

    "github.com/ebitengine/oto/v3"
    "github.com/hajimehoshi/go-mp3"
)

func main() {
    // 读取MP3文件到内存
    fileBytes, err := os.ReadFile("./my-file.mp3")
    if err != nil {
        panic("reading my-file.mp3 failed: " + err.Error())
    }

    // 将纯字节转换为可用于MP3解码器的读取器对象
    fileBytesReader := bytes.NewReader(fileBytes)

    // 解码文件
    decodedMp3, err := mp3.NewDecoder(fileBytesReader)
    if err != nil {
        panic("mp3.NewDecoder failed: " + err.Error())
    }

    // 准备Oto上下文(将使用默认音频设备)
    op := &oto.NewContextOptions{}

    // 通常为44100或48000。其他值可能导致Oto失真
    op.SampleRate = 44100

    // 声道数(1为单声道，2为立体声)
    op.ChannelCount = 2

    // 源格式。go-mp3的格式是有符号16位整数
    op.Format = oto.FormatSignedInt16LE

    // 记住程序中不应创建多个上下文
    otoCtx, readyChan, err := oto.NewContext(op)
    if err != nil {
        panic("oto.NewContext failed: " + err.Error())
    }
    // 等待硬件音频设备准备就绪
    <-readyChan

    // 创建一个新的播放器(默认暂停)
    player := otoCtx.NewPlayer(decodedMp3)
    
    // 开始播放音频(异步)
    player.Play()

    // 可以等待音频播放完成
    for player.IsPlaying() {
        time.Sleep(time.Millisecond)
    }

    // 播放完成后可以关闭播放器
    err = player.Close()
    if err != nil {
        panic("player.Close failed: " + err.Error())
    }
}

通过文件流播放音频

上面的示例将整个文件加载到内存中然后播放。对于较小的文件很好，但对于长歌曲可能会占用太多内存。这时可以使用文件流：

package main

import (
    "os"
    "time"

    "github.com/ebitengine/oto/v3"
    "github.com/hajimehoshi/go-mp3"
)

func main() {
    // 打开文件进行读取。在播放完成前不要关闭！
    file, err := os.Open("./my-file.mp3")
    if err != nil {
        panic("opening my-file.mp3 failed: " + err.Error())
    }

    // 解码文件。这个过程是在文件播放时进行的
    decodedMp3, err := mp3.NewDecoder(file)
    if err != nil {
        panic("mp3.NewDecoder failed: " + err.Error())
    }

    // 其余部分相同...

    // 播放完成后关闭文件
    file.Close()
}

高级用法

播放器有自己的内部音频数据缓冲区，所以当从io.Reader读取了200字节时，并不意味着它们都已从音频设备播放。

可以使用Player.UnplayedBufferSize()获取缓冲区中未播放的数据量。

也可以通过类型断言设置播放器的底层缓冲区大小：

myPlayer.(oto.BufferSizeSetter).SetBufferSize(newBufferSize)

交叉编译

交叉编译到macOS或Windows很简单，只需设置GOOS=darwin或GOOS=windows。

要为其他平台交叉编译，请确保安装了目标架构的库，并设置CGO_ENABLED=1，因为Go在交叉编译时默认禁用Cgo。