NAME

Audio::Play - interface for Audio::Data to hardware

SYNOPSIS

  use Audio::Data;
  use Audio::Play;
  
  $audio = Audio::Data->new(...)
  
  $svr = Audio::Play->new;
  
  $svr->play($audio);
  

DESCRIPTION

Audio::Play is an wrapper class which loads Audio::Play::$^O i.e. a per-platform driver.

Each class provides the following interface:

$svr = $class->new([$wait])

Create the server and return an object. $wait is supposed to determine whether to wait for device (and for how long) but is currently not really working for many devices.

$svr->rate($rate)

Set sample rate (if possible) to $rate.

$rate = $svr->rate;

Return sample rate.

$svr->play($audio[,$gain])

Play $audio via the hardware. Should take steps to match hardware and data's sampling rate.

$svr->gain($mult)

Set gain (if possible).

$svr->flush

Wait for playing to complete.

$svr->DESTROY

Destructor flushes and closes hardware.

AUTHOR

Nick Ing-Simmons <Nick@Ing-Simmons.net>, but sub-modules have been collected from wide variety of places.