= Description
A library for playing and controlling sounds on MS Windows.
= Prerequisites
- ffi
- test-unit 2 (Development only)
= Installation
gem install win32-sound
= Synopsis
require 'win32/sound'
include Win32
Play a wav file
Sound.play("somefile.wav")
Play a system sound
Sound.play("SystemAsterisk",Sound::ALIAS)
Get the current volume of the waveform-audio output device.
p Sound.volume.join(", ") # left channel, right channel
= Acknowledgements
API ideas derived (or not) from Perl's Win32::Sound module and Python's
winsound package.
= Known Bugs
None that I'm aware of. Please report any bugs on the project page
at https://github.com/djberg96/win32-sound.
= Future Plans
Add ability to retrieve information about WAV files.
Add MIDI support?
= Developer's Notes
The MessageBeep() function, which the Python "winsound" module contains,
is intentionally omitted here. I felt it was redundant, because you can
achieve the same effect with something like this:
Sound.play("SystemAsterisk", Sound::ALIAS).
= License
Artistic 2.0
= Copyright
(C) 2004-2017, Daniel J. Berger, All Rights Reserved
= Warranty
This package is provided "as is" and without any express or
implied warranties, including, without limitation, the implied
warranties of merchantability and fitness for a particular purpose.
= Author(s)
Daniel Berger
Park Heesob
Dominic Muller