Classes
class	Sound
	Class that publishes messages to the sound_play node. More...

class	SoundClient
	This class is a helper class for communicating with the sound_play node via the sound_play.SoundRequest message. More...

Functions
def	builtinSound (self, id, volume=1.0)
	Create a builtin Sound. More...

def	play (self, kwargs)
	Play the Sound. More...

def	play (self, sound, volume=1.0, kwargs)
	Play a buildin sound. More...

def	playWave (self, sound, volume=1.0, kwargs)
	Plays a WAV or OGG file. More...

def	playWaveFromPkg (self, package, sound, volume=1.0, kwargs)
	Plays a WAV or OGG file. More...

def	repeat (self, kwargs)
	Play the Sound repeatedly. More...

def	repeat (self, text, volume=1.0, kwargs)
	Say a string repeatedly. More...

def	say (self, text, voice='', volume=1.0, kwargs)
	Say a string. More...

def	sendMsg (self, snd, cmd, s, arg2="", vol=1.0, kwargs)

def	start (self, sound, volume=1.0, kwargs)
	Play a buildin sound repeatedly. More...

def	startWave (self, sound, volume=1.0, kwargs)
	Plays a WAV or OGG file repeatedly. More...

def	startWaveFromPkg (self, package, sound, volume=1.0, kwargs)
	Plays a WAV or OGG file repeatedly. More...

def	stop (self)
	Stop Sound playback. More...

def	stop (self, sound)
	Stop playing a built-in sound. More...

def	stopAll (self)
	Stop all currently playing sounds. More...

def	stopSaying (self, text)
	Stop saying a string. More...

def	stopWave (self, sound)
	Stop playing a WAV or OGG file. More...

def	stopWaveFromPkg (self, sound, package)
	Stop playing a WAV or OGG file. More...

def	voiceSound (self, s, volume=1.0)
	Create a voice Sound. More...

def	waveSound (self, sound, volume=1.0)
	Create a wave Sound. More...

Function Documentation

def sound_play.libsoundplay.builtinSound	(	self,
		id,
		volume = `1.0`
	)

Create a builtin Sound.

Creates a Sound corresponding to indicated builtin wave.

Parameters

id	Identifier of the sound to play.

Definition at line 148 of file libsoundplay.py.

def sound_play.libsoundplay.play	(	self,
		kwargs
	)

Play the Sound.

This method causes the Sound to be played once.

Definition at line 69 of file libsoundplay.py.

def sound_play.libsoundplay.play	(	self,
		sound,
		volume = `1.0`,
		kwargs
	)

Play a buildin sound.

Starts playing one of the built-in sounds. built-ing sounds are documented in SoundRequest.msg. Playback can be stopped by stopall.

Parameters

sound Identifier of the sound to play.

Definition at line 268 of file libsoundplay.py.

def sound_play.libsoundplay.playWave	(	self,
		sound,
		volume = `1.0`,
		kwargs
	)

Plays a WAV or OGG file.

Plays a WAV or OGG file once. The playback can be stopped by stopWave or stopAll.

Parameters

sound Filename of the WAV or OGG file. Must be an absolute path valid on the computer on which the sound_play node is running

Definition at line 190 of file libsoundplay.py.

def sound_play.libsoundplay.playWaveFromPkg	(	self,
		package,
		sound,
		volume = `1.0`,
		kwargs
	)

Plays a WAV or OGG file.

Plays a WAV or OGG file once. The playback can be stopped by stopWaveFromPkg or stopAll.

Parameters

package	Package name containing the sound file.
sound	Filename of the WAV or OGG file. Must be an path relative to the package valid on the computer on which the sound_play node is running

Definition at line 233 of file libsoundplay.py.

def sound_play.libsoundplay.repeat	(	self,
		kwargs
	)

Play the Sound repeatedly.

This method causes the Sound to be played repeatedly until stop() is called.

Definition at line 78 of file libsoundplay.py.

def sound_play.libsoundplay.repeat	(	self,
		text,
		volume = `1.0`,
		kwargs
	)

Say a string repeatedly.

The string is said repeatedly until stopSaying or stopAll is used.

Parameters

text	String to say repeatedly

Definition at line 168 of file libsoundplay.py.

def sound_play.libsoundplay.say	(	self,
		text,
		voice = `''`,
		volume = `1.0`,
		kwargs
	)

Say a string.

Send a string to be said by the sound_node. The vocalization can be stopped using stopSaying or stopAll.

Parameters

text	String to say

Definition at line 158 of file libsoundplay.py.

def sound_play.libsoundplay.sendMsg	(	self,
		snd,
		cmd,
		s,
		arg2 = `""`,
		vol = `1.0`,
		kwargs
	)

Internal method that publishes the sound request, either directly as a
SoundRequest to the soundplay_node or through the actionlib interface
(which blocks until the sound has finished playing).

The blocking behavior is nominally the class-wide setting unless it has
been explicitly specified in the play call.

Definition at line 297 of file libsoundplay.py.

def sound_play.libsoundplay.start	(	self,
		sound,
		volume = `1.0`,
		kwargs
	)

Play a buildin sound repeatedly.

Starts playing one of the built-in sounds repeatedly until stop or stopall is used. Built-in sounds are documented in SoundRequest.msg.

Parameters

sound Identifier of the sound to play.

Definition at line 278 of file libsoundplay.py.

def sound_play.libsoundplay.startWave	(	self,
		sound,
		volume = `1.0`,
		kwargs
	)

Plays a WAV or OGG file repeatedly.

Plays a WAV or OGG file repeatedly until stopWave or stopAll is used.

Parameters

sound Filename of the WAV or OGG file. Must be an absolute path valid on the computer on which the sound_play node is running.

Definition at line 204 of file libsoundplay.py.

def sound_play.libsoundplay.startWaveFromPkg	(	self,
		package,
		sound,
		volume = `1.0`,
		kwargs
	)

Plays a WAV or OGG file repeatedly.

Plays a WAV or OGG file repeatedly until stopWaveFromPkg or stopAll is used.

Parameters

package	Package name containing the sound file.
sound	Filename of the WAV or OGG file. Must be an path relative to the package valid on the computer on which the sound_play node is running

Definition at line 245 of file libsoundplay.py.

def sound_play.libsoundplay.stop ( self )

Stop Sound playback.

This method causes the Sound to stop playing.

Definition at line 86 of file libsoundplay.py.

def sound_play.libsoundplay.stop	(	self,
		sound
	)

Stop playing a built-in sound.

Stops playing a built-in sound started with play or start.

Parameters

sound Same sound that was used to start playback

Definition at line 287 of file libsoundplay.py.

def sound_play.libsoundplay.stopAll ( self )

Stop all currently playing sounds.

This method stops all speech, wave file, and built-in sound playback.

Definition at line 294 of file libsoundplay.py.

def sound_play.libsoundplay.stopSaying	(	self,
		text
	)

Stop saying a string.

Stops saying a string that was previously started by say or repeat. The argument indicates which string to stop saying.

Parameters

text	Same string as in the say or repeat command

Definition at line 179 of file libsoundplay.py.

def sound_play.libsoundplay.stopWave	(	self,
		sound
	)

Stop playing a WAV or OGG file.

Stops playing a file that was previously started by playWave or startWave.

Parameters

sound Same string as in the playWave or startWave command

Definition at line 218 of file libsoundplay.py.

def sound_play.libsoundplay.stopWaveFromPkg	(	self,
		sound,
		package
	)

Stop playing a WAV or OGG file.

Stops playing a file that was previously started by playWaveFromPkg or startWaveFromPkg.

Parameters

package	Package name containing the sound file.
sound	Filename of the WAV or OGG file. Must be an path relative to the package valid on the computer on which the sound_play node is running

Definition at line 258 of file libsoundplay.py.

def sound_play.libsoundplay.voiceSound	(	self,
		s,
		volume = `1.0`
	)

Create a voice Sound.

Creates a Sound corresponding to saying the indicated text.

Parameters

s	Text to say

Definition at line 127 of file libsoundplay.py.

def sound_play.libsoundplay.waveSound	(	self,
		sound,
		volume = `1.0`
	)

Create a wave Sound.

Creates a Sound corresponding to indicated file.

Parameters

s	File to play. Should be an absolute path that exists on the machine running the sound_play node.

Definition at line 136 of file libsoundplay.py.

Classes

Functions

Function Documentation