Skip to content

Commit 4fc580c

Browse files
docs: 更新 sound 模块文档,新增 149 个内置音效完整列表(7 大分类)
- game(34): 通用游戏音效(提示/错误/碰撞/呼啸/开关等) - arcade(13): 街机音效(金币/跳跃/爆炸/激光) - ui(12): 界面交互(点击/开关/滑过) - digital(34): 数字科幻(升级/激光/电击/音调变化) - casino(15): 赌场桌游(骰子/纸牌/筹码) - rpg(25): RPG 冒险(开门/翻书/挥刀/脚步声) - music(16): 胜利/失败/过关小曲(5 种风格) - 所有音效来源 Kenney.nl CC0 公共领域许可
1 parent 8ed2afc commit 4fc580c

1 file changed

Lines changed: 18 additions & 11 deletions

File tree

docs/sound-module.md

Lines changed: 18 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -197,17 +197,17 @@ sound.set_honors_silent_switch(flag)
197197
| Bundle 文件名 | `'click.caf'` | 在 app bundle 中查找 |
198198
| 相对路径 | `'sounds/bgm.mp3'` | 先找当前目录,再找 Documents |
199199

200-
**Pythonista 内置音效分类**
200+
**内置 149 个音效(CC0 来源 Kenney.nl),7 大分类**
201201

202-
| 分类 | 示例 |
203-
|------|------|
204-
| `game:` | `game:Beep` `game:Error` `game:Powerup` `game:Clock_1` |
205-
| `arcade:` | `arcade:Coin_1` `arcade:Jump_1` `arcade:Explosion_1` |
206-
| `ui:` | `ui:click1` `ui:click2` |
207-
| `digital:` | `digital:PowerUp7` `digital:ZapThreeToneUp` |
208-
| `casino:` | `casino:DiceThrow3` `casino:ChipsStack5` |
209-
| `drums:` | `drums:Drums_06` |
210-
| `piano:` | `piano:C3` `piano:A4` |
202+
| 分类 | 数量 | 完整列表 |
203+
|------|------|------|
204+
| `game:` | 34 | `Beep` `Error` `Error_2` `Error_3` `Powerup` `Ding_1`~`Ding_3` `Clock_1`~`Clock_3` `Hit_1`~`Hit_4` `Drop_1` `Drop_2` `Pluck_1` `Pluck_2` `Glass_1` `Glass_2` `Swoosh_1`~`Swoosh_3` `Open_1` `Open_2` `Close_1` `Close_2` `Select_1` `Select_2` `Glitch_1` `Glitch_2` `Question_1` `Scratch_1` |
205+
| `arcade:` | 13 | `Coin_1` `Coin_2` `Jump_1`~`Jump_3` `Explosion_1`~`Explosion_3` `Laser_1`~`Laser_3` `Zap_1` `Zap_2` |
206+
| `ui:` | 12 | `click1`~`click5` `switch1`~`switch3` `rollover1` `rollover2` `mouseclick1` `mouserelease1` |
207+
| `digital:` | 34 | `PowerUp1`~`PowerUp12` `Laser1`~`Laser9` `Zap1` `Zap2` `HighUp` `HighDown` `LowDown` `LowRandom` `PepSound1` `PepSound2` `Tone1` `TwoTone1` `TwoTone2` `ThreeTone1` `ThreeTone2` |
208+
| `casino:` | 15 | `DiceThrow1`~`DiceThrow3` `DiceShake1` `DiceShake2` `CardPlace1` `CardPlace2` `CardSlide1` `CardSlide2` `CardShuffle` `ChipsCollide1` `ChipsCollide2` `ChipsHandle1` `ChipLay1` `ChipLay2` |
209+
| `rpg:` | 25 | `DoorOpen_1` `DoorOpen_2` `DoorClose_1` `DoorClose_2` `BookOpen` `BookClose` `BookFlip_1` `BookFlip_2` `Chop` `KnifeSlice_1` `KnifeSlice_2` `DrawKnife_1` `MetalClick` `MetalLatch` `Creak_1` `Creak_2` `Cloth_1` `DropLeather` `Footstep_1`~`Footstep_3` `FootstepGrass_1` `FootstepGrass_2` `FootstepWood_1` `FootstepWood_2` |
210+
| `music:` | 16 | `Victory_NES_1` `Victory_NES_2` `GameOver_NES_1` `LevelUp_NES_1` `Start_NES_1` `Bonus_NES_1` `Victory_Pizzi_1` `GameOver_Pizzi_1` `LevelUp_Pizzi_1` `Victory_Steel_1` `GameOver_Steel_1` `LevelUp_Steel_1` `Victory_Sax_1` `GameOver_Sax_1` `Victory_Hit_1` `GameOver_Hit_1` |
211211

212212
**支持的音频格式**`.caf` `.wav` `.mp3` `.aiff` `.m4a`
213213

@@ -219,11 +219,18 @@ sound.set_honors_silent_switch(flag)
219219

220220
| 场景 | 建议 |
221221
|------|------|
222-
| 碰撞/反弹 | `sound.play_effect('game:Beep', volume=0.3)` |
222+
| 碰撞/反弹 | `sound.play_effect('game:Hit_1', volume=0.3)` |
223223
| 得分 | `sound.play_effect('arcade:Coin_1')` |
224224
| 玩家点击 | `sound.play_effect('ui:click1', volume=0.5)` |
225225
| 升级/奖励 | `sound.play_effect('game:Powerup')` |
226226
| 失败/错误 | `sound.play_effect('game:Error')` |
227+
| 跳跃 | `sound.play_effect('arcade:Jump_1')` |
228+
| 爆炸 | `sound.play_effect('arcade:Explosion_1')` |
229+
| 挥动/呼啸 | `sound.play_effect('game:Swoosh_1')` |
230+
| 胜利过关 | `sound.play_effect('music:Victory_NES_1')` |
231+
| 游戏结束 | `sound.play_effect('music:GameOver_NES_1')` |
232+
| 开门 | `sound.play_effect('rpg:DoorOpen_1')` |
233+
| 脚步声 | `sound.play_effect('rpg:Footstep_1')` |
227234
| 背景音乐 | `bgm = sound.Player('music.mp3'); bgm.number_of_loops = -1; bgm.play()` |
228235

229236
---

0 commit comments

Comments
 (0)