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);

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.

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