Audio

Game tidak memutar audio sendiri. Game meminta platform memutarnya lewat ctx.audio, dan platform mencampurnya di tiga bus dengan tombol bisu host. Dengan begitu semua game terdengar setara, dan bisu host berlaku untuk semuanya.

Bunyi platform

Siap pakai, tanpa file:

tick · select · back · join · logo · start · coin · trophy · error · jump · count · go

ctx.audio.play('tick');

Bunyi milik game

Taruh file di assets/ dan panggil dengan path-nya di dalam bundel:

ctx.audio.preload('audio/ledakan.ogg'); // di preload: unduh dan dekode sekarang
ctx.audio.play('audio/ledakan.ogg');
ctx.audio.play('audio/musik.ogg', { bus: 'music', loop: true });
ctx.audio.stop('audio/musik.ogg');

Opsi	Arti	Bawaan
`bus`	`sfx`, `music`, atau `voice`	`sfx`
`loop`	Ulang terus sampai `stop`	`false`
`rate`	Kecepatan dan nada, 0,5–2	1
`gain`	Penguatan di atas bus, 0–2	1

Format: .ogg/.opus paling hemat; .mp3, .m4a, dan .wav juga diterima.
Path bunyi paling panjang 64 karakter. Perintah dengan path lebih panjang diabaikan.
Panggil preload untuk bunyi yang harus tepat waktu. Tanpa itu, play pertama menunggu unduhan.
Semua bunyi game berhenti sendiri saat game selesai.

Tiga bus

Bus	Untuk	Tingkat
`music`	Musik latar	Lebih pelan dari efek, supaya efek selalu terdengar
`sfx`	Efek	Acuan
`voice`	Announcer, narasi	Sedikit di atas efek, supaya terdengar di atas keramaian

Samakan kenyaringan file dalam satu bus menurut loudness (LUFS), bukan puncak. Dua efek dengan puncak sama bisa terdengar sangat berbeda kerasnya.

Panggung musik: `mix`

Untuk meredam musik sesaat, misalnya saat jeda atau saat announcer bicara:

onPause(ctx) {
  ctx.audio.mix({ db: -10, lowpassHz: 600, rampMs: 300 });
},
onResume(ctx) {
  ctx.audio.mix({ db: 0, lowpassHz: null, rampMs: 300 });
},

Field	Rentang
`db`	−40 sampai 0
`lowpassHz`	100 sampai 22050, atau `null` (terbuka)
`rampMs`	0 sampai 5000

mix hanya memengaruhi bunyi game di bus music, dan dikembalikan ke semula saat game selesai.

Di Ralystudioo

Browser baru mengizinkan audio setelah halaman disentuh. Klik sekali di layar host simulator untuk menyalakan suara.