Apache Ant TasksSoundSoundDescriptionPlays a sound-file at the end of the build, according to whetherthe build failed or succeeded. You can specify either a specificsound-file to play, or, if a directory is specified, the<sound> task will randomly select a file to play.Note: At this point, the random selection is based on all the filesin the directory, not just those ending in appropriate suffixesfor sound-files, so be sure you only have sound-files in the directory you specify. More precisely <sound> registers a hook that istriggered when the build finishes. Therefore you have to place thistask as top level or inside a target which is always executed. Unless you are running on Java 1.3 or later, you need the Java Media Frameworkon the classpath (javax.sound). Nested ElementssuccessSpecifies the sound to be played if the build succeeded. failSpecifies the sound to be played if the build failed. Nested Element ParametersThe following attributes may be used on the <success> and <fail> elements: Attribute | Description | Required | source | the path to a sound-file directory, or the name of aspecific sound-file, to be played. If this file does not exist, an error messagewill be logged. | Yes | loops | the number of extra times to play the sound-file; default is 0 . | No | duration | the amount of time (in milliseconds) to play the sound-file. | No | Examples<target name="fun" if="fun" unless="fun.done"> <sound> <success source="${user.home}/sounds/bell.wav"/> <fail source="${user.home}/sounds/ohno.wav" loops="2"/> </sound> <property name="fun.done" value="true"/></target> plays the bell.wav sound-file if the build succeeded, orthe ohno.wav sound-file if the build failed, three times,if the fun property is set to true .If the targetis a dependency of an "initialization" target that othertargets depend on, thefun.done property prevents the target from being executedmore than once.<target name="fun" if="fun" unless="fun.done"> <sound> <success source="//intranet/sounds/success"/> <fail source="//intranet/sounds/failure"/> </sound> <property name="fun.done" value="true"/></target> randomly selects a sound-file to play when the build succeeds or fails. |