指令/playsound

playsound

限制條件	是管理員
加入版本	Java版1.6.1（Java版1.6.1-pre） 攜帶版1.0.5（攜帶版alpha 1.0.5.0）

播放一段聲音。

語法

• Java版

playsound <声音> <来源> <玩家> [x] [y] [z] [音量] [音调] [最小音量]

• 基岩版

playsound <声音：字符串> <玩家：目标> [方位：x y z] [音量：浮点数] [音调：浮点数] [最小音量：浮点数]

參數

聲音（基岩版：聲音：字符串）

指定要播放的聲音。必須為在sounds.json中被定義的一個聲音項目（例如，entity.pig.ambient）。

一個聲音項目可被多個不同的聲音關聯，而實際產生的聲音為從中隨機挑選的結果，被選中的概率由其權重決定，與正常遊戲中相同。例如，聲音項目entity.pig.ambient會隨機播放多種豬音效之一，因為有多個聲音關聯於該項目。

資源包可能會向sounds.json中添加額外的聲音項目；此指令可以正常播放這些項目。該指令使用的聲音名稱不是檔案名；而是嚴格使用sounds.json內定義的項目（項目名稱可能與實際音頻檔案的檔案名和目錄相差甚遠），因此資源包在添加新聲音時必須為這些音頻檔案定義聲音事件項目（但當資源包替換原有的已被定義的音頻檔案時，不必為其重新定義）。

來源‌‌^[僅Java版]

指定播放聲音所屬的類別，對應於遊戲選項中「音樂和音效」設定的分類。必須為以下之一：master、music、record、weather、block、hostile、neutral、player、ambient或voice。

玩家（基岩版：玩家：目標）

指定播放聲音的目標。必須為一個玩家名或一個目標選擇器。

x y z（基岩版：方位：x y z）（可選）

指定聲音發出的方位。可用波浪號來指定一個相對於目標的位置。

音量（基岩版：音量：浮點數）（可選）

指定聲音能被聽見的距離。必須至少為0.0。對小於1.0的值，聲音會相對減輕，球狀可聞範圍會相對小。對大於1.0的值，聲音不會實際上增大，但其可聞範圍（1.0時半徑為16米）會與音量相乘。聲音總會基於與球體中心的距離逐漸衰減至無聲。

音調（基岩版：音調：浮點數）（可選）

指定聲音的音調。在Java版中，該數值必須在0.0至2.0間（含），而小於0.5的值與0.5等價。小於1.0的值降低音調而提升持續時間；大於1.0的值提升音調而降低持續時間。音調值是乘在聲音頻率上的一個倍率，因此若將0.5-1.0（含）區間內的音調值乘以2，所得的新音調便會高一個八度。在基岩版中，該數字沒有特別限制，但是必須要在0.0至256.0之間才有對應效果。高於256.0的值與預設值的效果相同。小於等於0.0的值會導致聽不到該聲音。（如果您是一位音樂家，希望將其他音符轉換為音調數值，請參閱 音階盒。但請注意1.0的音調值對於每種聲音並不一定都是F♯。）若未指定，預設為1.0。

最小音量（基岩版：最小音量：浮點數）（可選）

指定在聲音可聞範圍外的目標能聽到的音量。若目標在可聞範圍外，作為補償，聲源會被放置在距離目標較近的位置（距離小於4格），而最小音量會決定補償聲源的音量。必須在0.0至1.0間（含）。

效果

當參數未正確指定，當玩家無法解析到一個或多個線上玩家時，或當目標無法從聲源處聽見聲音時，指令失敗。

成功時，為目標玩家播放一段聲音。

另見

/stopsound — 停止一段聲音。

歷史

Java版
1.6.1		pre			加入了/playsound指令。
1.9		15w49a			/playsound指令現在指令支持Tab鍵自動補全。
		16w02a			現在/playsound指令要求source參數，指定聲音所屬的分類，以歸入音量控制。
攜帶版
1.0.5		alpha 1.0.5.0			加入了/playsound指令。

指令

參見：Template:Commands/content [編輯]