feat: add the ability of loadSound with AudioBuffer (#382)

CHANGELOG.md

@@ -238,6 +238,7 @@ features of v4000, while v4000 will have the most features and breaking changes.
 
 ## Audio
 
+- now you can pass an `AudioBuffer` to `loadSound()` (**v4000**)
 - added `loadMusic()` to load streaming audio (doesn't block in loading screen).
   (**v3001/4000**)
 

src/assets/sound.ts

@@ -10,6 +10,10 @@ export class SoundData {
         this.buf = buf;
     }
 
+    static fromAudioBuffer(buf: AudioBuffer): SoundData {
+        return new SoundData(buf);
+    }
+
     static fromArrayBuffer(buf: ArrayBuffer): Promise<SoundData> {
         return new Promise((resolve, reject) =>
             audio.ctx.decodeAudioData(buf, resolve, reject)
@@ -61,15 +65,22 @@ export function getSound(name: string): Asset<SoundData> | null {
 // load a sound to asset manager
 export function loadSound(
     name: string | null,
-    src: string | ArrayBuffer,
+    src: string | ArrayBuffer | AudioBuffer,
 ): Asset<SoundData> {
-    src = fixURL(src);
-    return assets.sounds.add(
-        name,
-        typeof src === "string"
-            ? SoundData.fromURL(src)
-            : SoundData.fromArrayBuffer(src),
-    );
+    const fixedSrc = fixURL(src);
+    let sound: Promise<SoundData> | SoundData;
+
+    if (typeof fixedSrc === "string") {
+        sound = SoundData.fromURL(fixedSrc);
+    }
+    else if (fixedSrc instanceof ArrayBuffer) {
+        sound = SoundData.fromArrayBuffer(fixedSrc);
+    }
+    else {
+        sound = Promise.resolve(SoundData.fromAudioBuffer(fixedSrc));
+    }
+
+    return assets.sounds.add(name, sound);
 }
 
 export function loadMusic(