format

Documentation

Overview

Interface for supported audio format implementations.

Index

• Variables
• func Register(f Format)
• type Decoder
  • func GetDecoder(path string) (Decoder, error)
• type Format
• type Metadata
  • func GetMetadata(path string) (Metadata, error)

Variables

var ErrNotSupported = errors.New("not supported audio format")

Functions

func Register

func Register(f Format)

Types

type Decoder

type Decoder interface {
	// Read decode piece of data and returns raw PCM audio data.
	Read(buf []byte) (read int, err error)
	// Seek sets new position in seconds to start decoding from.
	Seek(pos int) error
	// Time returns current decoded position in seconds.
	// TODO: Time should be in millis or nanos.
	Time() int
	// SampleRate returns sample rate of decoded stream.
	SampleRate() int
	// Channels returns number of channels in decoded stream.
	Channels() int
	// Close releases decoder resources.
	Close() error
}

Decoder interface represents audio decoder for the particular audio format.

func GetDecoder

func GetDecoder(path string) (Decoder, error)

type Format

type Format interface {
	Extensions() []string
	Metadata(path string) (Metadata, error)
	Decoder(path string) (Decoder, error)
}

type Metadata

type Metadata interface {
	Artist() string
	Album() string
	Year() int
	Title() string
	Number() int
	Length() int
}

func GetMetadata

func GetMetadata(path string) (Metadata, error)