聲音

說明

根據建置是否失敗或成功，在建置結束時播放音效檔。你可以指定要播放的特定音效檔，或者如果指定目錄，<sound> 任務將會隨機選取一個檔案來播放。注意：此時，隨機選取是根據目錄中的所有檔案，而並非僅限於音效檔適當的副檔名，因此請確定你指定的目錄中只有音效檔。

更精確地說，<sound> 會註冊一個勾子，在建置完成時觸發。因此，你必須將此任務置於頂層或永遠執行的目標中。

除非你執行的是 Java 1.3 或更新版本，否則你需要在類別路徑中使用 Java Media Framework（javax.sound）。

指定為巢狀元素的參數

success

指定建置成功時要播放的聲音。

fail

指定建置失敗時要播放的聲音。

巢狀元素參數

下列屬性可以用於 <success> 和 <fail> 元素

屬性 說明 必要
source 要播放的音效檔目錄路徑，或特定音效檔的名稱。如果此檔案不存在，系統將會記錄錯誤訊息。 是
loops 播放音效檔的額外次數。 否；預設為 0
duration 播放音效檔的時間（毫秒）。 否

範例

如果 fun 屬性設為 true，則在建置成功時播放 bell.wav 音效檔，或在建置失敗時播放 ohno.wav 音效檔，播放三次。如果目標是其他目標所依賴的「初始化」目標，則 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>