播放一段聲音。
語法[]
- Java版
playsound <sound> <source> <targets> [<pos>] [<volume>] [<pitch>] [<minVolume>]
- 基岩版
playsound <sound: string> [player: target] [position: x y z] [volume: float] [pitch: float] [minimumVolume: float]
參數[]
JE：<sound>：resource_location
BE：sound: string：basic_string
- 指定要播放的聲音。必須為在sounds.json中被定義的一個聲音項目（例如，
entity.pig.ambient）。
- 一個聲音項目可被多個不同的聲音關聯，而實際產生的聲音為從中隨機挑選的結果，被選中的機率由其權重決定，與正常遊戲中相同。例如，聲音項目
entity.pig.ambient會隨機播放多種豬音效之一，因為有多個聲音關聯於該項目。
- 資源包可能會向sounds.json中加入額外的聲音項目；此指令可以正常播放這些項目。該指令使用的聲音名稱不是檔案名；而是嚴格使用sounds.json內定義的項目（項目名稱可能與實際音訊檔案的檔案名和目錄相差甚遠），因此資源包在新增聲音時必須為這些音訊檔案定義聲音事件項目（但當資源包替換原有的已被定義的音訊檔案時，不必為其重新定義）。
JE: <source>
- 指定播放聲音所屬的類別，對應於遊戲選項中「音樂和音效」設定的分類。必須為以下之一：
master、music、record、weather、block、hostile、neutral、player、ambient或voice。
JE：<targets>：entity
BE：player: target：CommandSelector<Player>
- 指定播放聲音的目標。
- 必須為玩家名、目標選擇器或UUID。且目標選擇器只允許玩家。
JE：<pos>：vec3
BE：position: x y z：CommandPositionFloat
- 指定聲音發出的方位。
- 必須為三維座標，元素為浮點數。允許波浪號與脫字號標記。
JE：<volume>：float
BE：volume: float：float
- 指定聲音能被聽見的距離。必須至少為0.0。對小於1.0的值，聲音會相對減輕，球狀可聞範圍會相對小。對大於1.0的值，聲音不會實際上增大，但其可聞範圍（1.0時半徑為16米）會與音量相乘。聲音總會基於與球體中心的距離逐漸衰減至無聲。預設為1.0。
- 必須為單精度浮點數。在Java版中，必須大於等於0.0。
JE：<pitch>：float
BE：pitch: float：float
- 指定聲音的音調。若未指定，預設為1.0。
- 在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的值會導致聽不到該聲音。
- 在基岩版中，此參數在調整音調時會相應地調整聲音的播放速度，且播放速度相對於原音訊採樣速度的倍率即為此參數的值。
JE：<minVolume>：float
BE：minimumVolume: float：float
- 指定在聲音可聞範圍外的目標能聽到的音量。若目標在可聞範圍外，作為補償，聲源會被放置在距離目標較近的位置（距離小於4格），而
最小音量會決定補償聲源的音量。 - 如果此數值等於0，則正常可聞範圍外的目標聽不到聲音。如果未指定，則預設為0.0。
- 必須為單精度浮點數。在Java版中，必須在0.0和1.0（含）之間。
效果[]
| 指令 | 觸發條件 | Java版 | 基岩版 |
|---|---|---|---|
| 任意 | 參數不正確 | 無法解析 | 無法解析 |
<targets>或player: target無法解析玩家（指定的玩家必須線上） | 執行失敗 | 執行失敗 | |
minVolume或minimumVolume: float不大於0，且所有目標在正常可聽範圍之外。 | |||
| 其中至少一名玩家無法聽見聲音 | N/A | ||
player: target非玩家目標選擇器 | |||
| 執行成功時 | 為指定玩家播放指定聲音 | ||
輸出[]
| 指令 | 版本 | 條件 | 成功次數 | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| 任意 | Java版 | 失敗 | 0 | 0 | 0 |
| 成功 | 1 | 1 | 聽見聲音的玩家數量 | ||
| 基岩版 | 失敗 | 0 | N/A | N/A | |
| 成功 | 目標玩家數量 | N/A | N/A |
歷史[]
| Java版 | |||||
|---|---|---|---|---|---|
| 1.6.1 | pre | 加入了/playsound指令。 | |||
| 1.9 | 15w49a | /playsound指令現在指令支持Tab鍵自動補全。 | |||
| 16w02a | 現在/playsound指令要求source參數，指定聲音所屬的分類，以歸入音量控制。 | ||||
| 攜帶版 | |||||
| 1.0.5 | 1.0.5.0 | 加入了/playsound指令。 | |||
參見[]
/stopsound— 停止一段聲音。
語言