Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs: fix the custom-bus audio example — playSFX has no bus option

esenginebfa52cf50a7d
diff --git a/docs/astro/src/content/docs/guides/audio.mdx b/docs/astro/src/content/docs/guides/audio.mdx
index 7b58b3b02..46ac54832 100644
--- a/docs/astro/src/content/docs/guides/audio.mdx
+++ b/docs/astro/src/content/docs/guides/audio.mdx
@@ -186,7 +186,8 @@ Custom buses need no class at all — the facade covers them:
audio.ensureBus('ambience'); // create under master (idempotent)
audio.ensureBus('footsteps', 'sfx'); // or under an existing bus
audio.setBusVolume('ambience', 0.5);
-audio.playSFX('assets/wind.ogg', { bus: 'ambience' }); // or AudioSource.bus
+// playSFX is always on the 'sfx' bus; playTrack (or an entity's AudioSource.bus) picks one.
+audio.playTrack('assets/wind.ogg', { bus: 'ambience' });
```
`ensureBus(name, parent?)` creates the bus if it's missing (under `parent`,
diff --git a/docs/astro/src/content/docs/zh-cn/guides/audio.mdx b/docs/astro/src/content/docs/zh-cn/guides/audio.mdx
index b45afbbc5..b873eaf91 100644
--- a/docs/astro/src/content/docs/zh-cn/guides/audio.mdx
+++ b/docs/astro/src/content/docs/zh-cn/guides/audio.mdx
@@ -174,7 +174,8 @@ audio.setBusDucking('music', null); // 移除
audio.ensureBus('ambience'); // create under master (idempotent)
audio.ensureBus('footsteps', 'sfx'); // or under an existing bus
audio.setBusVolume('ambience', 0.5);
-audio.playSFX('assets/wind.ogg', { bus: 'ambience' }); // or AudioSource.bus
+// playSFX 始终走 'sfx' 总线;playTrack(或实体的 AudioSource.bus)才能选总线。
+audio.playTrack('assets/wind.ogg', { bus: 'ambience' });
```
`ensureBus(name, parent?)` 在总线缺失时创建它(挂在 `parent` 下,默认 `master`),