react-native-audiosprites 0.2.1 → 0.3.1

package/README.md

@@ -22,10 +22,22 @@ First, you need to generate an audio sprite and a JSON manifest file using the `
 Assuming you have [`audiosprite`](https://www.npmjs.com/package/audiosprite) installed globally:
 
 ```sh
-audiosprite --output audiosprite --format howler --path ./src/__tests__/ Sound_1.m4a Sound_2.m4a Sound_3.m4a Sound_4.m4a
+audiosprite --output src/__tests__/sounds/mygameaudio --format howler --loop "bg_loop" src/__tests__/sounds/bg_loop.wav src/__tests__/sounds/Sound_1.m4a src/__tests__/sounds/Sound_2.m4a src/__tests__/sounds/Sound_3.m4a src/__tests__/sounds/Sound_4.m4a
 ```
 
-This command will generate `audiosprite.json`, `audiosprite.mp3`, `audiosprite.ogg`, `audiosprite.m4a`, and `audiosprite.ac3` in the `src/__tests__/` directory. The `--path` argument is important as it tells the player where to find the audio files relative to the JSON manifest.
+This command will generate `mygameaudio.json`, `mygameaudio.mp3`, `mygameaudio.ogg`, `mygameaudio.m4a`, and `mygameaudio.ac3` in the `src/__tests__/sounds/` directory.
+
+### Looping Sounds
+
+You can create looping sounds by using the `--loop` option with the `audiosprite` command. The value of the `--loop` option should be the name of the sound you want to loop.
+
+For example, to loop the `bg_music` sound, you would use the following command:
+
+```sh
+audiosprite --output audiosprite --format howler --loop "bg_music" --path ./src/__tests__/ Sound_1.m4a Sound_2.m4a Sound_3.m4a Sound_4.m4a bg_music.wav
+```
+
+When you play a looping sound, it will play continuously until you stop it using the `player.stop()` method. The looping functionality is supported on both web and mobile platforms.
 
 Then, you can use the `AudioSpritePlayer` to play the sounds from the sprite.
 
@@ -42,7 +54,7 @@ async function playSound(soundName: string) {
   try {
     // Load the audio sprite manifest and audio files
     // Adjust the path to your audiosprite.json file
-    await player.load('./src/__tests__/audiosprite.json');
+    await player.load('./src/__tests__/sounds/mygameaudio.json');
     console.log('Audio sprite loaded successfully.');
 
     // Play a sound from the spritemap
@@ -53,9 +65,16 @@ async function playSound(soundName: string) {
   }
 }
 
+function stopSound() {
+  player.stop();
+  console.log('Stopped looping sound.');
+}
+
 // Example usage:
 playSound('Sound_1');
 // playSound('Sound_2');
+// To stop a looping sound:
+// stopSound();
 ```
 
 ### React Native Environment
@@ -79,16 +98,16 @@ module.exports = wrapWithAudioAPIMetroConfig(config);
 Then, you can use it in your component:
 
 ```typescript
-import { StyleSheet, View, Text, Button, Platform } from 'react-native';
+import { StyleSheet, View, Text, Platform, TouchableOpacity } from 'react-native';
 import { AudioSpritePlayer } from 'react-native-audiosprites';
 import { AudioManager, AudioContext } from 'react-native-audio-api';
 import { useEffect, useState, useRef } from 'react';
 import { Asset } from 'expo-asset';
 import { fetch } from 'expo/fetch';
-import manifest from '../assets/audiosprite.json';
+import manifest from '../assets/mygameaudio.json';
 
 // Import the audio asset
-const audioAsset = require('../assets/audiosprite.mp3');
+const audioAsset = require('../assets/mygameaudio.mp3');
 
 export default function App() {
   const [isLoaded, setIsLoaded] = useState(false);
@@ -147,19 +166,51 @@ export default function App() {
     }
   };
 
+  const stopBGM = () => {
+    const player = playerRef.current;
+    if (player) {
+      player.stop();
+    }
+  };
+
   return (
     <View style={styles.container}>
       <Text>AudioSprite Player Example</Text>
-      <Button
-        title="Play Sound 1"
+      <TouchableOpacity
+        onPress={() => loadPlayer()}
+        style={styles.button}
+        disabled={!isLoaded}
+      >
+        <Text style={styles.buttonText}>Load Player</Text>
+      </TouchableOpacity>
+      <TouchableOpacity
         onPress={() => playSound('Sound_1')}
+        style={styles.button}
         disabled={!isLoaded}
-      />
-      <Button
-        title="Play Sound 2"
+      >
+        <Text style={styles.buttonText}>Play Sound 1</Text>
+      </TouchableOpacity>
+      <TouchableOpacity
         onPress={() => playSound('Sound_2')}
+        style={styles.button}
         disabled={!isLoaded}
-      />
+      >
+        <Text style={styles.buttonText}>Play Sound 2</Text>
+      </TouchableOpacity>
+      <TouchableOpacity
+        onPress={() => playSound('bg_loop')}
+        style={styles.button}
+        disabled={!isLoaded}
+      >
+        <Text style={styles.buttonText}>Play Background Loop</Text>
+      </TouchableOpacity>
+      <TouchableOpacity
+        onPress={stopBGM}
+        style={styles.button}
+        disabled={!isLoaded}
+      >
+        <Text style={styles.buttonText}>Stop BGM</Text>
+      </TouchableOpacity>
     </View>
   );
 }
@@ -170,9 +221,28 @@ const styles = StyleSheet.create({
     alignItems: 'center',
     justifyContent: 'center',
   },
+  button: {
+    backgroundColor: '#DDDDDD',
+    padding: 10,
+    marginVertical: 5,
+    borderRadius: 5,
+  },
+  buttonText: {
+    color: '#000000',
+    textAlign: 'center',
+  },
 });
 ```
 
+## Inspiration
+
+https://github.com/goldfire/howler.js
+Generated json also works with new Howl({
+sprite: {
+key1: [offset, duration, (loop)]
+},
+});
+
 ## Contributing
 
 - [Development workflow](CONTRIBUTING.md#development-workflow)
@@ -183,6 +253,8 @@ const styles = StyleSheet.create({
 
 MIT
 
----
+## Credits
+
+[Shaker, Woda, Conga, Bongo, Templeblock.wav](https://freesound.org/people/kwazi/sounds/34115/) by [kwazi](https://freesound.org/people/kwazi/) | License: [Attribution 3.0](http://creativecommons.org/licenses/by/3.0/)
 
 Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/lib/module/index.js

@@ -10,6 +10,7 @@ export class AudioSpritePlayer {
 
   // Cache for the small, pre-split AudioBuffers used by mobile's QueueSourceNode
   spriteBufferCache = {};
+  loopingSource = null;
   constructor({
     audioContext,
     fetch,
@@ -44,20 +45,39 @@ export class AudioSpritePlayer {
   /**
    * Caches pre-split AudioBuffers for each sprite, which is necessary
    * for stable playback on mobile using the BufferQueueSourceNode.
+   *
+   * This method iterates through the audio sprite manifest and creates a separate
+   * AudioBuffer for each sound sprite. These smaller buffers are then stored
+   * in `this.spriteBufferCache` for efficient playback on mobile platforms,
+   * especially when using `AudioBufferQueueSourceNode`.
+   *
+   * The `audiosprite` manifest is expected to have the following structure for each sprite:
+   * `[start_time_ms, duration_ms, loop_boolean (optional)]`
+   *
+   * @example
+   * // Example audiosprite manifest structure:
+   * {
+   *   "urls": ["audio.mp3", "audio.ogg"],
+   *   "sprite": {
+   *     "sound1": [0, 1000, false],       // start at 0ms, duration 1000ms, no loop
+   *     "sound2": [1500, 500, true],      // start at 1500ms, duration 500ms, loop
+   *     "background": [2000, 30000, true] // start at 2000ms, duration 30000ms, loop
+   *   }
+   * }
    */
   _cacheSpriteBuffers() {
-    if (!this.audioBuffer || !this.manifest || this.platform === 'web') {
+    if (!this.audioBuffer || !this.manifest) {
       return; // Only necessary for mobile platforms
     }
     const sampleRate = this.audioBuffer.sampleRate;
     const numChannels = this.audioBuffer.numberOfChannels;
     this.spriteBufferCache = {};
-    for (const soundName in this.manifest.spritemap) {
-      const sound = this.manifest.spritemap[soundName];
+    for (const soundName in this.manifest.sprite) {
+      const sound = this.manifest.sprite[soundName];
 
-      // Calculate frame indices
-      const startFrame = Math.floor(sound.start * sampleRate);
-      const endFrame = Math.ceil(sound.end * sampleRate);
+      // Calculate frame indices based on audiosprite format: [start, duration, loop]
+      const startFrame = Math.floor(sound[0] * sampleRate / 1000); // Convert ms to frames
+      const endFrame = Math.ceil((sound[0] + sound[1]) * sampleRate / 1000); // Convert ms to frames
       const durationFrames = endFrame - startFrame;
       if (durationFrames <= 0) {
         console.warn(`Sprite "${soundName}" has zero or negative duration. Skipping.`);
@@ -91,10 +111,10 @@ export class AudioSpritePlayer {
           throw new Error(`Failed to fetch manifest: ${response.statusText}`);
         }
         this.manifest = await response.json();
-        if (!this.manifest.resources || !this.manifest.spritemap) {
-          throw new Error('Invalid audiosprite manifest format. Missing "resources" or "spritemap".');
+        if (!this.manifest.urls || !this.manifest.sprite) {
+          throw new Error('Invalid audiosprite manifest format. Missing "urls" or "sprite".');
         }
-        const audioFileName = this.manifest.resources[0];
+        const audioFileName = this.manifest.urls[0];
         const audioUrl = new URL(audioFileName, response.url).href;
         const audioResponse = await this.fetch(audioUrl);
         if (!audioResponse.ok) {
@@ -104,8 +124,8 @@ export class AudioSpritePlayer {
         decodedBuffer = await this.audioContext.decodeAudioData(arrayBuffer);
       } else {
         this.manifest = json;
-        if (!this.manifest.resources || !this.manifest.spritemap) {
-          throw new Error('Invalid audiosprite manifest format. Missing "resources" or "spritemap".');
+        if (!this.manifest.urls || !this.manifest.sprite) {
+          throw new Error('Invalid audiosprite manifest format. Missing "urls" or "sprite".');
         }
         let arrayBuffer;
         if (typeof audio === 'string') {
@@ -117,7 +137,13 @@ export class AudioSpritePlayer {
         } else {
           arrayBuffer = audio;
         }
-        decodedBuffer = await this.audioContext.decodeAudioData(arrayBuffer);
+        // 🔑 CRITICAL FIX: Create a typed array view before decoding
+        // This ensures the data is treated as a true ArrayBuffer in the audio context.
+        const typedArrayView = new Uint8Array(arrayBuffer);
+
+        // Pass the underlying ArrayBuffer of the typed view to the decoder
+        // Note: typedArrayView.buffer gives you the underlying ArrayBuffer
+        decodedBuffer = await this.audioContext.decodeAudioData(typedArrayView.buffer);
       }
       // --- End Fetching and Decoding Logic ---
 
@@ -143,21 +169,21 @@ export class AudioSpritePlayer {
         console.error('Failed to resume AudioContext:', e);
       });
     }
-    const sound = this.manifest.spritemap[soundName];
+    const sound = this.manifest.sprite[soundName];
     if (!sound) {
       console.warn(`Sound "${soundName}" not found in spritemap.`);
       return;
     }
-    const duration = sound.end - sound.start;
+    const duration = sound[1];
     if (duration <= 0) {
       console.warn(`Sound "${soundName}" has invalid duration.`);
       return;
     }
     let source;
+    const spriteBuffer = this.spriteBufferCache[soundName];
 
     // 🚨 MOBILE LOGIC: Use AudioBufferQueueSourceNode with cached split buffer
     if (this.platform !== 'web') {
-      const spriteBuffer = this.spriteBufferCache[soundName];
       if (!spriteBuffer) {
         console.error(`RNAS Error: Split buffer for "${soundName}" not found in cache.`);
         return;
@@ -166,14 +192,33 @@ export class AudioSpritePlayer {
         console.error('RNAS Error: createBufferQueueSource is not available on this native platform.');
         return;
       }
-      source = this.audioContext.createBufferQueueSource();
-
-      // Mobile Implementation: Enqueue the specific, short sprite buffer
-      source.enqueueBuffer(spriteBuffer);
-      source.connect(this.audioContext.destination);
+      const loop = sound[2];
+      if (loop) {
+        // Always use AudioBufferQueueSourceNode
+        source = this.audioContext.createBufferQueueSource();
+        source.enqueueBuffer(spriteBuffer);
+        source.connect(this.audioContext.destination);
 
-      // This will play the short buffer from its start to its end.
-      source.start(1);
+        // Manual looping using onEnded
+        const loopHandler = () => {
+          // Only re-enqueue if this is still the active looping source
+          if (this.loopingSource === source) {
+            source.enqueueBuffer(spriteBuffer);
+            // Restart the source immediately after re-enqueueing
+            source.start(0);
+          }
+        };
+        source.onEnded = loopHandler;
+        source.start(0); // Start immediately
+        this.loopingSource = source; // Store reference to looping source
+      } else {
+        // For non-looping sounds on mobile, use AudioBufferQueueSourceNode
+        source = this.audioContext.createBufferQueueSource();
+        source.enqueueBuffer(spriteBuffer);
+        source.connect(this.audioContext.destination);
+        source.start(1);
+        console.log('non loop', soundName);
+      }
     } else {
       // 🌐 WEB LOGIC (Standard Web Audio API)
       source = this.audioContext.createBufferSource();
@@ -181,16 +226,24 @@ export class AudioSpritePlayer {
         console.error('RNAS Error: createBufferSource() returned an invalid object on web. Aborting playback.');
         return;
       }
-      source.buffer = this.audioBuffer;
+      source.buffer = spriteBuffer;
       source.connect(this.audioContext.destination);
-
-      // Use the 'audiosprite' format: start(when, offset, duration)
-      source.start(0,
-      // Start playing now
-      sound.start,
-      // The offset
-      duration // The calculated duration
-      );
+      const loop = sound[2]; // audiosprite stores loop as the third element in the array
+      if (loop) {
+        source.loop = true;
+        source.loopStart = 0; // Relative to the spriteBuffer
+        source.loopEnd = sound[1] / 1000; // Duration of the spriteBuffer
+        source.start(0); // Start immediately, no offset for the individual spriteBuffer
+        this.loopingSource = source; // Store reference to looping source
+      } else {
+        // Use the 'audiosprite' format: start(when, offset, duration)
+        source.start(0,
+        // Start playing now
+        0,
+        // The offset in seconds (relative to the spriteBuffer)
+        sound[1] / 1000 // The calculated duration in seconds
+        );
+      }
     }
     console.log(`RNAS: played ${soundName} on ${this.platform}`);
   }
@@ -200,5 +253,19 @@ export class AudioSpritePlayer {
   getAudioBuffer() {
     return this.audioBuffer;
   }
+
+  /**
+   * Stops the currently looping audio sprite.
+   * If a looping sound is playing, it will be stopped immediately.
+   */
+  stop() {
+    if (this.loopingSource) {
+      this.loopingSource.stop();
+      this.loopingSource = null;
+      console.log('RNAS: Looping audio stopped.');
+    } else {
+      console.log('RNAS: No looping audio to stop.');
+    }
+  }
 }
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["AudioSpritePlayer","spriteBufferCache","constructor","audioContext","fetch","platform","AudioContext","Error","audioBuffer","manifest","createBufferSource","name","console","log","_cacheSpriteBuffers","sampleRate","numChannels","numberOfChannels","soundName","spritemap","sound","startFrame","Math","floor","start","endFrame","ceil","end","durationFrames","warn","spriteBuffer","createBuffer","i","sourceData","getChannelData","destinationData","segment","subarray","set","load","json","audio","decodedBuffer","response","ok","statusText","resources","audioFileName","audioUrl","URL","url","href","audioResponse","arrayBuffer","decodeAudioData","error","play","state","resume","catch","e","duration","source","createBufferQueueSource","enqueueBuffer","connect","destination","buffer","getManifest","getAudioBuffer"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["AudioSpritePlayer","spriteBufferCache","loopingSource","constructor","audioContext","fetch","platform","AudioContext","Error","audioBuffer","manifest","createBufferSource","name","console","log","_cacheSpriteBuffers","sampleRate","numChannels","numberOfChannels","soundName","sprite","sound","startFrame","Math","floor","endFrame","ceil","durationFrames","warn","spriteBuffer","createBuffer","i","sourceData","getChannelData","destinationData","segment","subarray","set","load","json","audio","decodedBuffer","response","ok","statusText","urls","audioFileName","audioUrl","URL","url","href","audioResponse","arrayBuffer","decodeAudioData","typedArrayView","Uint8Array","buffer","error","play","state","resume","catch","e","duration","source","createBufferQueueSource","loop","enqueueBuffer","connect","destination","loopHandler","start","onEnded","loopStart","loopEnd","getManifest","getAudioBuffer","stop"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/index.d.ts

@@ -10,6 +10,7 @@ export declare class AudioSpritePlayer {
     manifest: any | null;
     platform: string;
     private spriteBufferCache;
+    private loopingSource;
     constructor({ audioContext, fetch, platform, }: {
         audioContext: any | null;
         fetch: any;
@@ -18,11 +19,35 @@ export declare class AudioSpritePlayer {
     /**
      * Caches pre-split AudioBuffers for each sprite, which is necessary
      * for stable playback on mobile using the BufferQueueSourceNode.
+     *
+     * This method iterates through the audio sprite manifest and creates a separate
+     * AudioBuffer for each sound sprite. These smaller buffers are then stored
+     * in `this.spriteBufferCache` for efficient playback on mobile platforms,
+     * especially when using `AudioBufferQueueSourceNode`.
+     *
+     * The `audiosprite` manifest is expected to have the following structure for each sprite:
+     * `[start_time_ms, duration_ms, loop_boolean (optional)]`
+     *
+     * @example
+     * // Example audiosprite manifest structure:
+     * {
+     *   "urls": ["audio.mp3", "audio.ogg"],
+     *   "sprite": {
+     *     "sound1": [0, 1000, false],       // start at 0ms, duration 1000ms, no loop
+     *     "sound2": [1500, 500, true],      // start at 1500ms, duration 500ms, loop
+     *     "background": [2000, 30000, true] // start at 2000ms, duration 30000ms, loop
+     *   }
+     * }
      */
     private _cacheSpriteBuffers;
     load(json: any, audio?: any): Promise<void>;
     play(soundName: string): void;
     getManifest(): any;
     getAudioBuffer(): any;
+    /**
+     * Stops the currently looping audio sprite.
+     * If a looping sound is playing, it will be stopped immediately.
+     */
+    stop(): void;
 }
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,YAAY,EAAE,GAAG,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAClB,WAAW,EAAE,GAAG,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,iBAAiB,CAA2B;gBAExC,EACV,YAAY,EACZ,KAAK,EACL,QAAQ,GACT,EAAE;QACD,YAAY,EAAE,GAAG,GAAG,IAAI,CAAC;QACzB,KAAK,EAAE,GAAG,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;KAClB;IAkCD;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA8CrB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG;IAkEjC,IAAI,CAAC,SAAS,EAAE,MAAM;IA+EtB,WAAW;IAIX,cAAc;CAGf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,YAAY,EAAE,GAAG,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAClB,WAAW,EAAE,GAAG,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,aAAa,CAAoB;gBAE7B,EACV,YAAY,EACZ,KAAK,EACL,QAAQ,GACT,EAAE;QACD,YAAY,EAAE,GAAG,GAAG,IAAI,CAAC;QACzB,KAAK,EAAE,GAAG,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;KAClB;IAkCD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,mBAAmB;IA8CrB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG;IA0EjC,IAAI,CAAC,SAAS,EAAE,MAAM;IA2GtB,WAAW;IAIX,cAAc;IAId;;;OAGG;IACH,IAAI;CASL"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-audiosprites",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "audio sprites ",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/index.tsx

@@ -11,6 +11,7 @@ export class AudioSpritePlayer {
   platform: string;
   // Cache for the small, pre-split AudioBuffers used by mobile's QueueSourceNode
   private spriteBufferCache: Record<string, any> = {};
+  private loopingSource: any | null = null;
 
   constructor({
     audioContext,
@@ -57,9 +58,28 @@ export class AudioSpritePlayer {
   /**
    * Caches pre-split AudioBuffers for each sprite, which is necessary
    * for stable playback on mobile using the BufferQueueSourceNode.
+   *
+   * This method iterates through the audio sprite manifest and creates a separate
+   * AudioBuffer for each sound sprite. These smaller buffers are then stored
+   * in `this.spriteBufferCache` for efficient playback on mobile platforms,
+   * especially when using `AudioBufferQueueSourceNode`.
+   *
+   * The `audiosprite` manifest is expected to have the following structure for each sprite:
+   * `[start_time_ms, duration_ms, loop_boolean (optional)]`
+   *
+   * @example
+   * // Example audiosprite manifest structure:
+   * {
+   *   "urls": ["audio.mp3", "audio.ogg"],
+   *   "sprite": {
+   *     "sound1": [0, 1000, false],       // start at 0ms, duration 1000ms, no loop
+   *     "sound2": [1500, 500, true],      // start at 1500ms, duration 500ms, loop
+   *     "background": [2000, 30000, true] // start at 2000ms, duration 30000ms, loop
+   *   }
+   * }
    */
   private _cacheSpriteBuffers() {
-    if (!this.audioBuffer || !this.manifest || this.platform === 'web') {
+    if (!this.audioBuffer || !this.manifest) {
       return; // Only necessary for mobile platforms
     }
 
@@ -67,12 +87,12 @@ export class AudioSpritePlayer {
     const numChannels = this.audioBuffer.numberOfChannels;
     this.spriteBufferCache = {};
 
-    for (const soundName in this.manifest.spritemap) {
-      const sound = this.manifest.spritemap[soundName];
+    for (const soundName in this.manifest.sprite) {
+      const sound = this.manifest.sprite[soundName];
 
-      // Calculate frame indices
-      const startFrame = Math.floor(sound.start * sampleRate);
-      const endFrame = Math.ceil(sound.end * sampleRate);
+      // Calculate frame indices based on audiosprite format: [start, duration, loop]
+      const startFrame = Math.floor((sound[0] * sampleRate) / 1000); // Convert ms to frames
+      const endFrame = Math.ceil(((sound[0] + sound[1]) * sampleRate) / 1000); // Convert ms to frames
       const durationFrames = endFrame - startFrame;
 
       if (durationFrames <= 0) {
@@ -116,13 +136,13 @@ export class AudioSpritePlayer {
         }
         this.manifest = await response.json();
 
-        if (!this.manifest.resources || !this.manifest.spritemap) {
+        if (!this.manifest.urls || !this.manifest.sprite) {
           throw new Error(
-            'Invalid audiosprite manifest format. Missing "resources" or "spritemap".'
+            'Invalid audiosprite manifest format. Missing "urls" or "sprite".'
           );
         }
 
-        const audioFileName = this.manifest.resources[0];
+        const audioFileName = this.manifest.urls[0];
         const audioUrl = new URL(audioFileName, response.url).href;
 
         const audioResponse = await this.fetch(audioUrl);
@@ -136,9 +156,9 @@ export class AudioSpritePlayer {
         decodedBuffer = await this.audioContext.decodeAudioData(arrayBuffer);
       } else {
         this.manifest = json;
-        if (!this.manifest.resources || !this.manifest.spritemap) {
+        if (!this.manifest.urls || !this.manifest.sprite) {
           throw new Error(
-            'Invalid audiosprite manifest format. Missing "resources" or "spritemap".'
+            'Invalid audiosprite manifest format. Missing "urls" or "sprite".'
           );
         }
 
@@ -154,7 +174,15 @@ export class AudioSpritePlayer {
         } else {
           arrayBuffer = audio;
         }
-        decodedBuffer = await this.audioContext.decodeAudioData(arrayBuffer);
+        // 🔑 CRITICAL FIX: Create a typed array view before decoding
+        // This ensures the data is treated as a true ArrayBuffer in the audio context.
+        const typedArrayView = new Uint8Array(arrayBuffer);
+
+        // Pass the underlying ArrayBuffer of the typed view to the decoder
+        // Note: typedArrayView.buffer gives you the underlying ArrayBuffer
+        decodedBuffer = await this.audioContext.decodeAudioData(
+          typedArrayView.buffer
+        );
       }
       // --- End Fetching and Decoding Logic ---
 
@@ -183,24 +211,23 @@ export class AudioSpritePlayer {
       });
     }
 
-    const sound = this.manifest.spritemap[soundName];
+    const sound = this.manifest.sprite[soundName];
     if (!sound) {
       console.warn(`Sound "${soundName}" not found in spritemap.`);
       return;
     }
 
-    const duration = sound.end - sound.start;
+    const duration = sound[1];
     if (duration <= 0) {
       console.warn(`Sound "${soundName}" has invalid duration.`);
       return;
     }
 
     let source: any;
+    const spriteBuffer = this.spriteBufferCache[soundName];
 
     // 🚨 MOBILE LOGIC: Use AudioBufferQueueSourceNode with cached split buffer
     if (this.platform !== 'web') {
-      const spriteBuffer = this.spriteBufferCache[soundName];
-
       if (!spriteBuffer) {
         console.error(
           `RNAS Error: Split buffer for "${soundName}" not found in cache.`
@@ -215,15 +242,35 @@ export class AudioSpritePlayer {
         return;
       }
 
-      source = this.audioContext.createBufferQueueSource();
-
-      // Mobile Implementation: Enqueue the specific, short sprite buffer
-      source.enqueueBuffer(spriteBuffer);
-
-      source.connect(this.audioContext.destination);
+      const loop = sound[2];
+
+      if (loop) {
+        // Always use AudioBufferQueueSourceNode
+        source = this.audioContext.createBufferQueueSource();
+        source.enqueueBuffer(spriteBuffer);
+        source.connect(this.audioContext.destination);
+
+        // Manual looping using onEnded
+        const loopHandler = () => {
+          // Only re-enqueue if this is still the active looping source
+          if (this.loopingSource === source) {
+            source.enqueueBuffer(spriteBuffer);
+            // Restart the source immediately after re-enqueueing
+            source.start(0);
+          }
+        };
+        source.onEnded = loopHandler;
 
-      // This will play the short buffer from its start to its end.
-      source.start(1);
+        source.start(0); // Start immediately
+        this.loopingSource = source; // Store reference to looping source
+      } else {
+        // For non-looping sounds on mobile, use AudioBufferQueueSourceNode
+        source = this.audioContext.createBufferQueueSource();
+        source.enqueueBuffer(spriteBuffer);
+        source.connect(this.audioContext.destination);
+        source.start(1);
+        console.log('non loop', soundName);
+      }
     } else {
       // 🌐 WEB LOGIC (Standard Web Audio API)
       source = this.audioContext.createBufferSource();
@@ -235,15 +282,24 @@ export class AudioSpritePlayer {
         return;
       }
 
-      source.buffer = this.audioBuffer;
+      source.buffer = spriteBuffer;
       source.connect(this.audioContext.destination);
 
-      // Use the 'audiosprite' format: start(when, offset, duration)
-      source.start(
-        0, // Start playing now
-        sound.start, // The offset
-        duration // The calculated duration
-      );
+      const loop = sound[2]; // audiosprite stores loop as the third element in the array
+      if (loop) {
+        source.loop = true;
+        source.loopStart = 0; // Relative to the spriteBuffer
+        source.loopEnd = sound[1] / 1000; // Duration of the spriteBuffer
+        source.start(0); // Start immediately, no offset for the individual spriteBuffer
+        this.loopingSource = source; // Store reference to looping source
+      } else {
+        // Use the 'audiosprite' format: start(when, offset, duration)
+        source.start(
+          0, // Start playing now
+          0, // The offset in seconds (relative to the spriteBuffer)
+          sound[1] / 1000 // The calculated duration in seconds
+        );
+      }
     }
 
     console.log(`RNAS: played ${soundName} on ${this.platform}`);
@@ -256,4 +312,18 @@ export class AudioSpritePlayer {
   getAudioBuffer() {
     return this.audioBuffer;
   }
+
+  /**
+   * Stops the currently looping audio sprite.
+   * If a looping sound is playing, it will be stopped immediately.
+   */
+  stop() {
+    if (this.loopingSource) {
+      this.loopingSource.stop();
+      this.loopingSource = null;
+      console.log('RNAS: Looping audio stopped.');
+    } else {
+      console.log('RNAS: No looping audio to stop.');
+    }
+  }
 }