play node

Summary

The play node triggers an audio clip to play. This action completes immediately (i.e. it doesn't wait for the audio to finish). This node is appropriate for small, incidental, audio clips only. For longer clips use the audio node.

For more information regarding the scripting of this node see the scripting reference entry for play.

Children

This node cannot contain children.

Example B.7. Use of play node

<scene>
	<object type="balloon.aro">
		<event type="onclickdown">
			<play filename="pop.wav"/>
		</event>
	</object>
</scene>

Attributes

play attributes
nametypedefaultnotes
filenamefilenamethis attribute must be specifiedthe filename of the audio file to play

Attributes common to action nodes
nametypedefaultnotes
timesinteger1the number of times to perform this action. Use -1 to repeat indefinitely

Attributes common to nodes
nametypedefaultnotes
visiblebooleantrueIf false, this node (or its children, if it has any) will not be rendered.
colorr g b a (in range 0 to 1)1 1 1 1specifies the color used to modulate this node and its children
idstring an identifier used to refer to this node