speaker

Documentation

Overview

Package speaker implements playback of beep.Streamer values through physical speakers.

Index

• func Clear()
• func Init(sampleRate beep.SampleRate, bufferSize int) error
• func Lock()
• func Play(s ...beep.Streamer)
• func Unlock()

Functions

func Clear

func Clear()

Clear removes all currently playing Streamers from the speaker.

func Init

func Init(sampleRate beep.SampleRate, bufferSize int) error

Init initializes audio playback through speaker. Must be called before using this package.

The bufferSize argument specifies the number of samples of the speaker's buffer. Bigger bufferSize means lower CPU usage and more reliable playback. Lower bufferSize means better responsiveness and less delay.

func Lock

func Lock()

Lock locks the speaker. While locked, speaker won't pull new data from the playing Stramers. Lock if you want to modify any currently playing Streamers to avoid race conditions.

Always lock speaker for as little time as possible, to avoid playback glitches.

func Play

func Play(s ...beep.Streamer)

Play starts playing all provided Streamers through the speaker.

func Unlock

func Unlock()

Unlock unlocks the speaker. Call after modifying any currently playing Streamer.