声音

描述

在构建结束时播放声音文件，根据构建是否成功。您可以指定要播放的特定声音文件，或者，如果指定了目录，则<sound>任务将随机选择一个文件播放。注意：目前，随机选择基于目录中的所有文件，而不仅仅是那些以声音文件适当后缀结尾的文件，因此请确保您在指定的目录中只有声音文件。

更准确地说，<sound>注册了一个在构建完成时触发的钩子。因此，您必须将此任务放置在顶层或在始终执行的目标内部。

除非您在 Java 1.3 或更高版本上运行，否则您需要在类路径上使用 Java Media Framework（<code class="code">javax.sound</code>）。

作为嵌套元素指定的参数

成功

指定构建成功时要播放的声音。

失败

指定构建失败时要播放的声音。

嵌套元素参数

以下属性可用于<success>和<fail>元素

示例

如果构建成功，则播放 bell.wav 声音文件，如果构建失败，则播放 ohno.wav 声音文件，播放三次，如果fun属性设置为 true。如果目标是其他目标依赖的“初始化”目标的依赖项，则fun.done属性可防止目标执行多次。

<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>

随机选择一个声音文件，在构建成功或失败时播放。

<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>