device:play

Play a block of audio data to a device.

The output is synchronous: play() does not return until all the data has been output.
This is because several of the output devices supported by libao do not offer asynchronous output.
It means ao is not very suitable for real-time work such as synthesisers, electronic keyboards etc.
 

boolean success = device:play(string buffer, number bufferSize)

Parameters

• buffer
  • String containing audio data.
• bufferSize
  • Number of bytes of audio data in the buffer string.

These two parameters are those returned by ao.array2string.

Return Values

• success
  • If the playback fails for some reason, the function will return false. The device should then be closed.

Notes

device is a userdata returned by either ao.openLive or ao.openFile.