aio

package module
v1.2.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 4, 2022 License: MIT Imports: 13 Imported by: 1

README

aio

A simple Audio I/O library written in Go. This library relies on FFmpeg, FFProbe and FFPlay which must be downloaded before usage and added to the system path.

For Video I/O using FFmpeg. see the Vidio project.

Installation

go get github.com/AlexEidt/aio

Buffers

aio uses byte buffers to transport raw audio data. Audio data can take on many forms, including floating point, unsigned integer and signed integer. These types may be larger than a byte and would have to be split. Valid formats are u8, s8, u16, s16, u24, s24, u32, s32, f32, and f64. These represent u unsigned integers, s signed integers and f floating point numbers.

As an example, if there is stereo sound (two channels) encoded in the s16 (signed 16 bit integers) format with a sampling rate of 44100 Hz, one second of audio would be

44100 * 2 (channels) * 2 (bytes per sample) = 176400 bytes

Continuing on with this example, since this is stereo audio with 2 channels, one frame of audio is represented by 2 consecutive integers, one for each channel. Each integer is 16 bits, which means one frame of audio would be represented by 4 consecutive bytes.

Options

The Options struct is used to specify optional parameters for Audio I/O.

type Options struct {
	SampleRate int    // Sample rate in Hz.
	Channels   int    // Number of channels.
	Bitrate    int    // Bitrate.
	Format     string // Format of audio.
	Codec      string // Audio Codec.
	Video      string // Video file to use.
}

Audio

Audio is used to read audio from files. It can also be used to gather audio metadata from a file. By default, the audio buffer has a length of

sample rate * channels * bytes per sample

which corresponds to 1 second of audio data.

The user may pass in options to set the desired sampling rate, format and channels of the audio. If options is nil, then the channels and sampling rate from the file will be used, with a default format of s16.

Note that the Samples() function is only present for convenience. It casts the raw byte buffer into the given audio data type determined by the Format() such that the underlying data buffers are the same. The s24 and u24 formats are not supported by the Samples() function since there is no type equivalent. Calling the Samples() function on 24-bit audio will return the raw byte buffer.

The return value of the Samples() function will have to be cast into an array of the desired type (e.g. audio.Samples().([]float32))

aio.NewAudio(filename string, options *aio.Options) (*aio.Audio, error)

FileName() string
SampleRate() int
Channels() int
Bitrate() int
Duration() float64
Format() string
Codec() string
BitsPerSample() int
Buffer() []byte
Samples() interface{}
SetBuffer(buffer []byte) error

Read() bool
Close()

AudioWriter

AudioWriter is used to write audio to files from a buffer of audio samples. It comes with an Options struct that can be used to specify certain metadata of the output audio file. If options is nil, the defaults used are a sampling rate of 44100 Hz, with 2 channels in the s16 format.

aio.NewAudioWriter(filename string, options *aio.Options) (*aio.AudioWriter, error)

FileName() string
SampleRate() int
Channels() int
Bitrate() int
Format() string
Codec() string
Video() string

Write(samples interface{}) error
Close()

Microphone

Microphone is similar to the Audio struct, the only difference being that it reads audio from the microphone. The stream parameter is used to specify the microphone stream index, which will differ depending on the platform. For Windows (dshow) and MacOS (avfoundation), find the stream index by entering the following command

ffmpeg -f [dshow | avfoundation] -list_devices true -i dummy

and selecting the desired stream. For linux, see this page on the FFmpeg Wiki.

Additionally, an options parameter may be passed to specify the format, sampling rate and audio channels the microphone should record at. Any other options are ignored.

aio.NewMicrophone(stream int, options *aio.Options) (*aio.Microphone, error)

Name() string
SampleRate() int
Channels() int
Format() string
BitsPerSample() int
Buffer() []byte
Samples() interface{}
SetBuffer(buffer []byte) error

Read() bool
Close()

Player

Player is used to play audio from a buffer of audio samples.

aio.NewPlayer(channels, samplerate int, format string) (*aio.Player, error)

SampleRate() int
Channels() int
Format() string
Play(samples interface{}) error
Close()

Additionally, files may be played directly using the Play function:

aio.Play(filename string) error

Examples

Copy input.wav to output.mp3.

audio, _ := aio.NewAudio("input.wav", nil)

options := aio.Options{
	SampleRate: audio.SampleRate(),
	Channels:   audio.Channels(),
	Bitrate:    audio.Bitrate(),
	Format:     audio.Format(),
}

writer, _ := aio.NewAudioWriter("output.mp3", &options)
defer writer.Close()

for audio.Read() {
	writer.Write(audio.Buffer())
}

Capture 10 seconds of audio from the microphone. Audio is recorded at 44100 Hz stereo and is in signed 16 bit format.

micOptions := aio.Options{Format: "s16", Channels: 2, SampleRate: 44100}
mic, _ := aio.NewMicrophone(0, &micOptions)
defer mic.Close()

writerOptions := aio.Options{
	SampleRate: mic.SampleRate(),
	Channels:   mic.Channels(),
	Format:     mic.Format(),
}

writer, _ := aio.NewAudioWriter("output.wav", &writerOptions)
defer writer.Close()

seconds := 0
for mic.Read() && seconds < 10 {
	writer.Write(mic.Buffer())
	seconds++
}

Play input.mp4.

audio, _ := aio.NewAudio("input.mp4", nil)
player, _ := aio.NewPlayer(
	audio.Channels(),
	audio.SampleRate(),
	audio.Format(),
)
defer player.Close()

for audio.Read() {
	player.Play(audio.Buffer())
}

Read input.wav and process the audio samples.

audio, _ := aio.NewAudio("input.wav", nil)

for audio.Read() {
	samples := audio.Samples().([]int16)
	for i := range samples {
		// audio processing...
	}
}

Combine sound.wav and movie.mp4 into output.mp4.

audio, _ := aio.NewAudio("sound.wav", nil)

options := aio.Options{
	SampleRate: audio.SampleRate(),
	Channels:   audio.Channels(),
	Bitrate:    audio.Bitrate(),
	Format:     audio.Format(),
	Codec:      audio.Codec(),
	Video:      "movie.mp4",
}

writer, _ := aio.NewAudioWriter("output.mp4", &options)
defer writer.Close()

for audio.Read() {
	writer.Write(audio.Buffer())
}

Play Microphone audio. Use default microphone settings for recording.

mic, _ := aio.NewMicrophone(0, nil)
defer mic.Close()

player, _ := aio.NewPlayer(
	mic.Channels(),
	mic.SampleRate(),
	mic.Format(),
)
defer player.Close()

for mic.Read() {
	player.Play(mic.Buffer())
}

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Play 

func Play(filename string) error

Play the audio from the given file.

Types

type Audio 

type Audio struct {
	// contains filtered or unexported fields
}

func NewAudio 

func NewAudio(filename string, options *Options) (*Audio, error)

func (*Audio) Bitrate 

func (audio *Audio) Bitrate() int

func (*Audio) BitsPerSample 

func (audio *Audio) BitsPerSample() int

func (*Audio) Buffer 

func (audio *Audio) Buffer() []byte

func (*Audio) Channels 

func (audio *Audio) Channels() int

func (*Audio) Close 

func (audio *Audio) Close()

Closes the pipe and stops the ffmpeg process.

func (*Audio) Codec 

func (audio *Audio) Codec() string

func (*Audio) Duration 

func (audio *Audio) Duration() float64

Audio Duration in seconds.

func (*Audio) FileName 

func (audio *Audio) FileName() string

func (*Audio) Format 

func (audio *Audio) Format() string

func (*Audio) Read 

func (audio *Audio) Read() bool

Reads the next frame from of audio and stores it in the buffer. If the last frame has been read, returns false, otherwise true.

func (*Audio) SampleRate 

func (audio *Audio) SampleRate() int

Audio Sample Rate in Hz.

func (*Audio) Samples added in v1.1.0 

func (audio *Audio) Samples() interface{}

func (*Audio) SetBuffer 

func (audio *Audio) SetBuffer(buffer []byte) error

Sets the buffer to the given byte array. The length of the buffer must be a multiple of (bytes per sample * audio channels).

type AudioWriter 

type AudioWriter struct {
	// contains filtered or unexported fields
}

func NewAudioWriter 

func NewAudioWriter(filename string, options *Options) (*AudioWriter, error)

func (*AudioWriter) Bitrate 

func (writer *AudioWriter) Bitrate() int

func (*AudioWriter) Channels 

func (writer *AudioWriter) Channels() int

func (*AudioWriter) Close 

func (writer *AudioWriter) Close()

Closes the pipe and stops the ffmpeg process.

func (*AudioWriter) Codec 

func (writer *AudioWriter) Codec() string

func (*AudioWriter) FileName 

func (writer *AudioWriter) FileName() string

func (*AudioWriter) Format 

func (writer *AudioWriter) Format() string

func (*AudioWriter) SampleRate 

func (writer *AudioWriter) SampleRate() int

Audio Sample Rate in Hz.

func (*AudioWriter) Video 

func (writer *AudioWriter) Video() string

Video file name being written along with the audio.

func (*AudioWriter) Write 

func (writer *AudioWriter) Write(samples interface{}) error

Writes the given samples to the audio file.

type Microphone 

type Microphone struct {
	// contains filtered or unexported fields
}

func NewMicrophone 

func NewMicrophone(stream int, options *Options) (*Microphone, error)

func (*Microphone) BitsPerSample 

func (mic *Microphone) BitsPerSample() int

func (*Microphone) Buffer 

func (mic *Microphone) Buffer() []byte

func (*Microphone) Channels 

func (mic *Microphone) Channels() int

func (*Microphone) Close 

func (mic *Microphone) Close()

Closes the pipe and stops the ffmpeg process.

func (*Microphone) Format 

func (mic *Microphone) Format() string

func (*Microphone) Name 

func (mic *Microphone) Name() string

func (*Microphone) Read 

func (mic *Microphone) Read() bool

Reads the next frame from of audio and stores it in the buffer. If the last frame has been read, returns false, otherwise true.

func (*Microphone) SampleRate 

func (mic *Microphone) SampleRate() int

Audio Sample Rate in Hz.

func (*Microphone) Samples added in v1.1.0 

func (mic *Microphone) Samples() interface{}

func (*Microphone) SetBuffer 

func (mic *Microphone) SetBuffer(buffer []byte) error

Sets the buffer to the given byte array. The length of the buffer must be a multiple of (bytes per sample * audio channels).

type Options 

type Options struct {
	SampleRate int    // Sample rate in Hz.
	Channels   int    // Number of channels.
	Bitrate    int    // Bitrate.
	Format     string // Format of audio.
	Codec      string // Audio Codec.
	Video      string // Video file to use.
}

type Player 

type Player struct {
	// contains filtered or unexported fields
}

func NewPlayer 

func NewPlayer(channels, samplerate int, format string) (*Player, error)

func (*Player) Channels added in v1.2.1 

func (player *Player) Channels() int

func (*Player) Close 

func (player *Player) Close()

Closes the pipe and stops the ffplay process.

func (*Player) Format added in v1.2.1 

func (player *Player) Format() string

func (*Player) Play 

func (player *Player) Play(samples interface{}) error

func (*Player) SampleRate added in v1.2.1 

func (player *Player) SampleRate() int

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.