react-native-audiosprites 0.4.1 → 0.5.0

package/README.md

@@ -27,6 +27,20 @@ audiosprite --output src/__tests__/sounds/mygameaudio --format howler --loop "bg
 
 This command will generate `mygameaudio.json`, `mygameaudio.mp3`, `mygameaudio.ogg`, `mygameaudio.m4a`, and `mygameaudio.ac3` in the `src/__tests__/sounds/` directory.
 
+/**
+ * ⚠️ ANDROID RESOURCE CONFLICT FIX ⚠️
+ * * Android's build system (Gradle) generates resource IDs based on filenames WITHOUT extensions.
+ * If we generate "game_go_v2.mp3" and "game_go_v2.json", Android sees them both
+ * as the resource ID `R.raw.game_go_v2`, causing a "Duplicate resources" build error.
+ * * To fix this, make a script to automatically rename the generated JSON file to:
+ * `${outputFileName}_data.json`
+ * * Result:
+ * - game_go_v2.mp3      -> R.raw.game_go_v2
+ * - game_go_v2_data.json -> R.raw.game_go_v2_data
+ */
+
+![Example Demo](example_demo.png)
+
 ### 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.
@@ -41,6 +55,40 @@ When you play a looping sound, it will play continuously until you stop it using
 
 Then, you can use the `AudioSpritePlayer` to play the sounds from the sprite.
 
+### Type Safety for Native Audio Extensions
+
+This library includes robust type definitions for `react-native-audio-api` extensions, such as `createBufferQueueSource`. These types are automatically generated and synchronized with the native audio library version `0.10.1`.
+
+### Audio Routing and Volume Control (Mixer Graph)
+
+The library features a mixer graph that allows you to control the volume of Sound Effects (SFX) and Music separately, as well as a global Master volume.
+
+-   `sfx`: Short sound effects (coins, jumps, UI). High priority.
+-   `music`: Background tracks. Lower priority.
+
+You can specify the channel when playing a sound:
+
+```typescript
+// Play on 'sfx' channel (default)
+player.play('coin_sound');
+
+// Play on 'music' channel
+player.play('bg_music', { channel: 'music' });
+```
+
+You can control the volume dynamically:
+
+```typescript
+// Set Music Volume (0.0 to 1.0)
+player.setMusicVolume(0.5);
+
+// Set SFX Volume (0.0 to 1.0)
+player.setSFXVolume(0.8);
+
+// Set Master Volume (affects both)
+player.volume = 1.0;
+```
+
 ### Browser Environment
 
 ```typescript
@@ -159,7 +207,12 @@ export default function App() {
   const playSound = (soundName: string) => {
     const player = playerRef.current;
     if (player && isLoaded) {
-      player.play(soundName);
+      // Play on music channel
+      if (soundName === 'bg_loop') {
+          player.play(soundName, { channel: 'music' });
+      } else {
+          player.play(soundName);
+      }
       console.log(`Playing sound: ${soundName}`);
     } else {
       console.warn('Player not loaded yet.');
@@ -263,6 +316,315 @@ Made with [create-react-native-library](https://github.com/callstack/react-nativ
 
 # Translations
 
+## Telugu
+
+![react-native-audiosprites_poster](react-native-audiosprites_poster.jpg)
+
+# react-native-audiosprites
+
+'audiosprite' టూల్ ద్వారా రూపొందించబడిన ఆడియో స్ప్రైట్‌ల కోసం ఒక యూనివర్సల్ ప్లేయర్.
+ఒకే సమయంలో అనేక శబ్దాలను ప్లే చేయడానికి మద్దతు ఇస్తుంది!
+
+## ఇన్‌స్టాలేషన్
+
+```sh
+npm install react-native-audiosprites
+```
+
+```sh
+yarn add react-native-audiosprites
+```
+
+## వినియోగం
+
+ముందుగా, మీరు `audiosprite` టూల్‌ను ఉపయోగించి ఆడియో స్ప్రైట్ మరియు JSON మానిఫెస్ట్ ఫైల్‌ను రూపొందించాలి.
+
+మీరు [`audiosprite`](https://www.npmjs.com/package/audiosprite)ని గ్లోబల్‌గా ఇన్‌స్టాల్ చేశారని అనుకుందాం:
+
+```sh
+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
+```
+
+ఈ కమాండ్ `src/__tests__/sounds/` డైరెక్టరీలో `mygameaudio.json`, `mygameaudio.mp3`, `mygameaudio.ogg`, `mygameaudio.m4a`, మరియు `mygameaudio.ac3` ఫైళ్లను సృష్టిస్తుంది.
+
+/**
+ * ⚠️ ANDROID వనరుల సంఘర్షణ పరిష్కారం ⚠️
+ * * Android బిల్డ్ సిస్టమ్ (Gradle) ఎక్స్‌టెన్షన్‌లు లేకుండా ఫైల్‌నేమ్‌ల ఆధారంగా వనరుల IDలను సృష్టిస్తుంది.
+ * ఒకవేళ మనం "game_go_v2.mp3" మరియు "game_go_v2.json"ను రూపొందిస్తే, Android రెండింటినీ
+ * `R.raw.game_go_v2` అనే ఒకే వనరు IDగా చూస్తుంది, దీనివల్ల "డూప్లికేట్ వనరులు" బిల్డ్ ఎర్రర్ వస్తుంది.
+ * * దీన్ని పరిష్కరించడానికి, రూపొందించిన JSON ఫైల్ పేరును ఈ విధంగా మార్చాలి:
+ * `${outputFileName}_data.json`
+ * * ఫలితం:
+ * - game_go_v2.mp3      -> R.raw.game_go_v2
+ * - game_go_v2_data.json -> R.raw.game_go_v2_data
+ */
+
+### లూపింగ్ సౌండ్స్ (Looping Sounds)
+
+మీరు `audiosprite` కమాండ్‌తో `--loop` ఎంపికను ఉపయోగించి లూపింగ్ శబ్దాలను సృష్టించవచ్చు. `--loop` ఎంపిక యొక్క విలువ మీరు లూప్ చేయాలనుకుంటున్న శబ్దం పేరు అయి ఉండాలి.
+
+ఉదాహరణకు, `bg_music` శబ్దాన్ని లూప్ చేయడానికి, మీరు ఈ కింది కమాండ్‌ను ఉపయోగిస్తారు:
+
+```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
+```
+
+మీరు లూపింగ్ శబ్దాన్ని ప్లే చేసినప్పుడు, మీరు `player.stop()` పద్ధతిని ఉపయోగించి దాన్ని ఆపే వరకు అది నిరంతరాయంగా ప్లే అవుతూనే ఉంటుంది. వెబ్ మరియు మొబైల్ ప్లాట్‌ఫారమ్‌లలో లూపింగ్ ఫంక్షనాలిటీకి మద్దతు ఉంది.
+
+తరువాత, మీరు స్ప్రైట్ నుండి శబ్దాలను ప్లే చేయడానికి `AudioSpritePlayer`ని ఉపయోగించవచ్చు.
+
+### ఆడియో రూటింగ్ మరియు వాల్యూమ్ నియంత్రణ (మిక్సర్ గ్రాఫ్)
+
+ఈ లైబ్రరీ మిక్సర్ గ్రాఫ్ ఫీచర్‌ను కలిగి ఉంది, ఇది సౌండ్ ఎఫెక్ట్స్ (SFX) మరియు మ్యూజిక్ వాల్యూమ్‌లను విడివిడిగా, అలాగే గ్లోబల్ మాస్టర్ వాల్యూమ్‌ను నియంత్రించడానికి మిమ్మల్ని అనుమతిస్తుంది.
+
+-   `sfx`: చిన్న సౌండ్ ఎఫెక్ట్స్ (కాయిన్స్, జంప్స్, UI). అధిక ప్రాధాన్యత.
+-   `music`: నేపథ్య ట్రాక్‌లు (Background tracks). తక్కువ ప్రాధాన్యత.
+
+శబ్దాన్ని ప్లే చేస్తున్నప్పుడు మీరు ఛానెల్‌ని పేర్కొనవచ్చు:
+
+```typescript
+// 'sfx' ఛానెల్‌లో ప్లే చేయండి (డిఫాల్ట్)
+player.play('coin_sound');
+
+// 'music' ఛానెల్‌లో ప్లే చేయండి
+player.play('bg_music', { channel: 'music' });
+```
+
+మీరు వాల్యూమ్‌ను డైనమిక్‌గా నియంత్రించవచ్చు:
+
+```typescript
+// మ్యూజిక్ వాల్యూమ్‌ను సెట్ చేయండి (0.0 నుండి 1.0)
+player.setMusicVolume(0.5);
+
+// SFX వాల్యూమ్‌ను సెట్ చేయండి (0.0 నుండి 1.0)
+player.setSFXVolume(0.8);
+
+// మాస్టర్ వాల్యూమ్‌ను సెట్ చేయండి (రెండింటినీ ప్రభావితం చేస్తుంది)
+player.volume = 1.0;
+```
+
+### బ్రౌజర్ ఎన్విరాన్మెంట్ (Browser Environment)
+
+```typescript
+import { AudioSpritePlayer } from 'react-native-audiosprites';
+
+const player = new AudioSpritePlayer({
+  platform: 'web',
+});
+
+async function playSound(soundName: string) {
+  try {
+    // ఆడియో స్ప్రైట్ మానిఫెస్ట్ మరియు ఆడియో ఫైళ్లను లోడ్ చేయండి
+    // మీ audiosprite.json ఫైల్ పాత్‌ను సరిచూసుకోండి
+    await player.load('./src/__tests__/sounds/mygameaudio.json');
+    console.log('ఆడియో స్ప్రైట్ విజయవంతంగా లోడ్ అయింది.');
+
+    // స్ప్రైట్‌మ్యాప్ నుండి శబ్దాన్ని ప్లే చేయండి
+    player.play(soundName);
+    console.log(`శబ్దాన్ని ప్లే చేస్తోంది: ${soundName}`);
+  } catch (error) {
+    console.error('శబ్దాన్ని ప్లే చేయడంలో లోపం:', error);
+  }
+}
+
+function stopSound() {
+  player.stop();
+  console.log('లూపింగ్ శబ్దం ఆగిపోయింది.');
+}
+
+// వినియోగ ఉదాహరణ:
+playSound('Sound_1');
+// playSound('Sound_2');
+// లూపింగ్ శబ్దాన్ని ఆపడానికి:
+// stopSound();
+```
+
+### రియాక్ట్ నేటివ్ ఎన్విరాన్మెంట్ (React Native Environment)
+
+రియాక్ట్ నేటివ్ కోసం, ఆడియో ప్లేబ్యాక్ మరియు అసెట్ లోడింగ్‌ను నిర్వహించడానికి మీకు `react-native-audio-api` మరియు `expo-asset` అవసరం.
+
+ముందుగా, డిపెండెన్సీలను ఇన్‌స్టాల్ చేయండి:
+
+```sh
+npm install react-native-audio-api expo-asset expo-file-system
+# లేదా
+yarn add react-native-audio-api expo-asset expo-file-system
+```
+
+`react-native-audio-api` డాక్యుమెంటేషన్ ప్రకారం `metro.config.js`ని మార్చండి: https://docs.swmansion.com/react-native-audio-api/docs/fundamentals/getting-started
+
+```js
+module.exports = wrapWithAudioAPIMetroConfig(config);
+```
+
+తరువాత, మీరు దీన్ని మీ కాంపోనెంట్‌లో ఉపయోగించవచ్చు:
+
+```typescript
+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/mygameaudio.json';
+
+// ఆడియో అసెట్‌ను ఇంపోర్ట్ చేయండి
+const audioAsset = require('../assets/mygameaudio.mp3');
+
+export default function App() {
+  const [isLoaded, setIsLoaded] = useState(false);
+  const playerRef = useRef<AudioSpritePlayer | null>(null);
+
+  useEffect(() => {
+    const loadPlayer = async () => {
+      const asset = Asset.fromModule(audioAsset);
+      await asset.downloadAsync();
+      const audioUri = asset.localUri || asset.uri;
+
+      if (!audioUri) {
+        console.error('ఆడియో URIని పొందడంలో విఫలమైంది.');
+        return;
+      }
+
+      if (Platform.OS === 'ios') {
+        try {
+          await AudioManager.setAudioSessionOptions({
+            iosCategory: 'playback',
+            iosOptions: ['mixWithOthers'],
+          });
+          await AudioManager.setAudioSessionActivity(true);
+        } catch (e) {
+          console.error('AudioSession ఎంపికలను కాన్ఫిగర్ చేయడంలో విఫలమైంది:', e);
+        }
+      }
+
+      const audioContext = new AudioContext();
+      const audioPlayer = new AudioSpritePlayer({
+        audioContext,
+        fetch: fetch.bind(globalThis),
+        platform: Platform.OS,
+      });
+
+      try {
+        await audioPlayer.load(manifest, audioUri);
+        playerRef.current = audioPlayer;
+        setIsLoaded(true);
+        console.log('ఆడియో స్ప్రైట్ విజయవంతంగా లోడ్ అయింది.');
+      } catch (error) {
+        console.error('ఆడియో స్ప్రైట్‌ను లోడ్ చేయడంలో విఫలమైంది:', error);
+      }
+    };
+
+    loadPlayer();
+  }, []);
+
+  const playSound = (soundName: string) => {
+    const player = playerRef.current;
+    if (player && isLoaded) {
+      if (soundName === 'bg_loop') {
+          player.play(soundName, { channel: 'music' });
+      } else {
+          player.play(soundName);
+      }
+      console.log(`శబ్దాన్ని ప్లే చేస్తోంది: ${soundName}`);
+    } else {
+      console.warn('ప్లేయర్ ఇంకా లోడ్ కాలేదు.');
+    }
+  };
+
+  const stopBGM = () => {
+    const player = playerRef.current;
+    if (player) {
+      player.stop();
+    }
+  };
+
+  return (
+    <View style={styles.container}>
+      <Text>AudioSprite Player ఉదాహరణ</Text>
+      <TouchableOpacity
+        onPress={() => loadPlayer()}
+        style={styles.button}
+        disabled={!isLoaded}
+      >
+        <Text style={styles.buttonText}>ప్లేయర్‌ని లోడ్ చేయండి</Text>
+      </TouchableOpacity>
+      <TouchableOpacity
+        onPress={() => playSound('Sound_1')}
+        style={styles.button}
+        disabled={!isLoaded}
+      >
+        <Text style={styles.buttonText}>Sound 1 ప్లే చేయండి</Text>
+      </TouchableOpacity>
+      <TouchableOpacity
+        onPress={() => playSound('Sound_2')}
+        style={styles.button}
+        disabled={!isLoaded}
+      >
+        <Text style={styles.buttonText}>Sound 2 ప్లే చేయండి</Text>
+      </TouchableOpacity>
+      <TouchableOpacity
+        onPress={() => playSound('bg_loop')}
+        style={styles.button}
+        disabled={!isLoaded}
+      >
+        <Text style={styles.buttonText}>బ్యాక్‌గ్రౌండ్ లూప్‌ను ప్లే చేయండి</Text>
+      </TouchableOpacity>
+      <TouchableOpacity
+        onPress={stopBGM}
+        style={styles.button}
+        disabled={!isLoaded}
+      >
+        <Text style={styles.buttonText}>BGM ఆపు</Text>
+      </TouchableOpacity>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    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
+జనరేట్ చేయబడిన json new Howl({
+sprite: {
+key1: [offset, duration, (loop)]
+},
+}); తో కూడా పనిచేస్తుంది.
+
+## సహకారం (Contributing)
+
+- [డెవలప్‌మెంట్ వర్క్‌ఫ్లో](CONTRIBUTING.md#development-workflow)
+- [పుల్ రిక్వెస్ట్ పంపడం](CONTRIBUTING.md#sending-a-pull-request)
+- [ప్రవర్తనా నియమావళి](CODE_OF_CONDUCT.md)
+
+## లైసెన్స్ (License)
+
+MIT
+
+## క్రెడిట్స్ (Credits)
+
+[Shaker, Woda, Conga, Bongo, Templeblock.wav](https://freesound.org/people/kwazi/sounds/34115/) by [kwazi](https://freesound.org/people/kwazi/) | లైసెన్స్: [అట్రిబ్యూషన్ 3.0](http://creativecommons.org/licenses/by/3.0/)
+
+[create-react-native-library](https://github.com/callstack/react-native-builder-bob)తో తయారు చేయబడింది
+
 ## Spanish
 
 ![react-native-audiosprites_poster](react-native-audiosprites_poster.jpg)
@@ -294,6 +656,18 @@ audiosprite --output src/__tests__/sounds/mygameaudio --format howler --loop "bg
 
 Este comando generará `mygameaudio.json`, `mygameaudio.mp3`, `mygameaudio.ogg`, `mygameaudio.m4a` y `mygameaudio.ac3` en el directorio `src/__tests__/sounds/`.
 
+/**
+ * ⚠️ SOLUCIÓN DE CONFLICTO DE RECURSOS DE ANDROID ⚠️
+ * * El sistema de compilación de Android (Gradle) genera ID de recursos basados en nombres de archivo SIN extensiones.
+ * Si generamos "game_go_v2.mp3" y "game_go_v2.json", Android los ve a ambos
+ * como el ID de recurso `R.raw.game_go_v2`, lo que causa un error de compilación de "Recursos duplicados".
+ * * Para solucionar esto, renombre el archivo JSON generado a:
+ * `${outputFileName}_data.json`
+ * * Resultado:
+ * - game_go_v2.mp3      -> R.raw.game_go_v2
+ * - game_go_v2_data.json -> R.raw.game_go_v2_data
+ */
+
 ### Sonidos en Bucle
 
 Puedes crear sonidos en bucle usando la opción `--loop` con el comando `audiosprite`. El valor de la opción `--loop` debe ser el nombre del sonido que deseas repetir.
@@ -426,7 +800,11 @@ export default function App() {
   const playSound = (soundName: string) => {
     const player = playerRef.current;
     if (player && isLoaded) {
-      player.play(soundName);
+      if (soundName === 'bg_loop') {
+          player.play(soundName, { channel: 'music' });
+      } else {
+          player.play(soundName);
+      }
       console.log(`Reproduciendo sonido: ${soundName}`);
     } else {
       console.warn('El reproductor aún no se ha cargado.');
@@ -557,6 +935,18 @@ audiosprite --output src/__tests__/sounds/mygameaudio --format howler --loop "bg
 
 Эта команда создаст `mygameaudio.json`, `mygameaudio.mp3`, `mygameaudio.ogg`, `mygameaudio.m4a` и `mygameaudio.ac3` в каталоге `src/__tests__/sounds/`.
 
+/**
+ * ⚠️ ИСПРАВЛЕНИЕ КОНФЛИКТА РЕСУРСОВ ANDROID ⚠️
+ * * Система сборки Android (Gradle) генерирует идентификаторы ресурсов на основе имен файлов БЕЗ расширений.
+ * Если мы сгенерируем "game_go_v2.mp3" и "game_go_v2.json", Android увидит их обоих
+ * как идентификатор ресурса `R.raw.game_go_v2`, что вызовет ошибку сборки "Дублирующиеся ресурсы".
+ * * Чтобы исправить это, переименуйте сгенерированный файл JSON в:
+ * `${outputFileName}_data.json`
+ * * Результат:
+ * - game_go_v2.mp3      -> R.raw.game_go_v2
+ * - game_go_v2_data.json -> R.raw.game_go_v2_data
+ */
+
 ### Зацикленные звуки
 
 Вы можете создавать зацикленные звуки, используя опцию `--loop` с командой `audiosprite`. Значением опции `--loop` должно быть имя звука, который вы хотите зациклить.
@@ -689,7 +1079,11 @@ export default function App() {
   const playSound = (soundName: string) => {
     const player = playerRef.current;
     if (player && isLoaded) {
-      player.play(soundName);
+      if (soundName === 'bg_loop') {
+          player.play(soundName, { channel: 'music' });
+      } else {
+          player.play(soundName);
+      }
       console.log(`Воспроизведение звука: ${soundName}`);
     } else {
       console.warn('Проигрыватель еще не загружен.');
@@ -820,6 +1214,18 @@ audiosprite --output src/__tests__/sounds/mygameaudio --format howler --loop "bg
 
 यह कमांड `src/__tests__/sounds/` डायरेक्टरी में `mygameaudio.json`, `mygameaudio.mp3`, `mygameaudio.ogg`, `mygameaudio.m4a`, और `mygameaudio.ac3` उत्पन्न करेगा।
 
+/**
+ * ⚠️ Android संसाधन संघर्ष सुधार ⚠️
+ * * Android की बिल्ड सिस्टम (Gradle) फ़ाइल नामों के आधार पर संसाधन ID उत्पन्न करती है बिना एक्सटेंशन के।
+ * यदि हम "game_go_v2.mp3" और "game_go_v2.json" उत्पन्न करते हैं, तो Android उन दोनों को
+ * `R.raw.game_go_v2` संसाधन ID के रूप में देखता है, जिससे "डुप्लिकेट संसाधन" बिल्ड त्रुटि होती है।
+ * * इसे ठीक करने के लिए, उत्पन्न JSON फ़ाइल का नाम बदलकर यह करें:
+ * `${outputFileName}_data.json`
+ * * परिणाम:
+ * - game_go_v2.mp3      -> R.raw.game_go_v2
+ * - game_go_v2_data.json -> R.raw.game_go_v2_data
+ */
+
 ### लूपिंग ध्वनियाँ
 
 आप `audiosprite` कमांड के साथ `--loop` विकल्प का उपयोग करके लूपिंग ध्वनियाँ बना सकते हैं। `--loop` विकल्प का मान उस ध्वनि का नाम होना चाहिए जिसे आप लूप करना चाहते हैं।
@@ -952,7 +1358,11 @@ export default function App() {
   const playSound = (soundName: string) => {
     const player = playerRef.current;
     if (player && isLoaded) {
-      player.play(soundName);
+      if (soundName === 'bg_loop') {
+          player.play(soundName, { channel: 'music' });
+      } else {
+          player.play(soundName);
+      }
       console.log(`ध्वनि बज रही है: ${soundName}`);
     } else {
       console.warn('खिलाड़ी अभी तक लोड नहीं हुआ है।');
@@ -1083,6 +1493,18 @@ audiosprite --output src/__tests__/sounds/mygameaudio --format howler --loop "bg
 
 此命令将在 `src/__tests__/sounds/` 目录中生成 `mygameaudio.json`、`mygameaudio.mp3`、`mygameaudio.ogg`、`mygameaudio.m4a` 和 `mygameaudio.ac3`。
 
+/**
+ * ⚠️ ANDROID 资源冲突修复 ⚠️
+ * * Android 的构建系统 (Gradle) 基于不带扩展名的文件名生成资源 ID。
+ * 如果我们生成 "game_go_v2.mp3" 和 "game_go_v2.json"，Android 会将它们都视为
+ * 资源 ID `R.raw.game_go_v2`，从而导致“重复资源”构建错误。
+ * * 要修复此问题，请将生成的 JSON 文件重命名为：
+ * `${outputFileName}_data.json`
+ * * 结果：
+ * - game_go_v2.mp3      -> R.raw.game_go_v2
+ * - game_go_v2_data.json -> R.raw.game_go_v2_data
+ */
+
 ### 循环声音
 
 您可以使用 `audiosprite` 命令的 `--loop` 选项创建循环声音。`--loop` 选项的值应该是您想要循环的声音的名称。
@@ -1215,7 +1637,11 @@ export default function App() {
   const playSound = (soundName: string) => {
     const player = playerRef.current;
     if (player && isLoaded) {
-      player.play(soundName);
+      if (soundName === 'bg_loop') {
+          player.play(soundName, { channel: 'music' });
+      } else {
+          player.play(soundName);
+      }
       console.log(`正在播放声音: ${soundName}`);
     } else {
       console.warn('播放器尚未加载。');
@@ -1313,4 +1739,4 @@ key1: [offset, duration, (loop)]
 
 [Shaker, Woda, Conga, Bongo, Templeblock.wav](https://freesound.org/people/kwazi/sounds/34115/) by [kwazi](https://freesound.org/people/kwazi/) | 执照: [署名 3.0](http://creativecommons.org/licenses/by/3.0/)
 
-使用 [create-react-native-library](https://github.com/callstack/react-native-builder-bob) 制作
+使用 [create-react-native-library](https://github.com/callstack/react-native-builder-bob) 制作

package/lib/module/index.js

@@ -5,6 +5,17 @@
  * Requires an AudioContext and fetch to be injected.
  * Uses AudioBufferQueueSourceNode and buffer splitting for mobile stability.
  */
+
+/**
+ * Defines the available audio routing channels.
+ * - 'sfx': Short sound effects (coins, jumps, UI). High priority, usually usually non-looping.
+ * - 'music': Background tracks. Lower priority, usually looping, separate volume control.
+ */
+
+/**
+ * Configuration options for playing a specific sound sprite.
+ */
+
 export class AudioSpritePlayer {
   // The full audio buffer
 
@@ -14,6 +25,8 @@ export class AudioSpritePlayer {
   sourcePool = []; // NEW: Pool for non-looping sources
   maxPoolSize = 5; // Adjust this based on testing (5 is a good start)
 
+  // NEW: The Mixer
+
   constructor({
     audioContext,
     fetch,
@@ -43,6 +56,20 @@ export class AudioSpritePlayer {
       // @ts-ignore
       this.audioContext = new AudioContext();
     }
+
+    // 1. Create Master Output
+    this.masterGain = this.audioContext.createGain();
+    this.masterGain.gain.value = 1.0;
+    this.masterGain.connect(this.audioContext.destination);
+
+    // 2. Create Channels
+    this.sfxGain = this.audioContext.createGain();
+    this.sfxGain.gain.value = 1.0;
+    this.sfxGain.connect(this.masterGain); // Connect to Master
+
+    this.musicGain = this.audioContext.createGain();
+    this.musicGain.gain.value = 1.0;
+    this.musicGain.connect(this.masterGain); // Connect to Master
   }
 
   /**
@@ -111,7 +138,7 @@ export class AudioSpritePlayer {
     if (this.platform === 'web') {
       // Web logic remains simple: always create a standard AudioBufferSourceNode
       const source = this.audioContext.createBufferSource();
-      source.connect(this.audioContext.destination);
+      // source.connect(this.audioContext.destination);
       return source;
     }
 
@@ -129,7 +156,7 @@ export class AudioSpritePlayer {
         return null;
       }
       source = this.audioContext.createBufferQueueSource();
-      source.connect(this.audioContext.destination);
+      // source.connect(this.audioContext.destination);
       // console.log('Created new source. Pool size:', this.sourcePool.length);
     } else {
       // If pool is full, we might have to block or fail.
@@ -213,7 +240,7 @@ export class AudioSpritePlayer {
       throw error; // Re-throw for user to catch
     }
   }
-  play(soundName) {
+  play(soundName, options) {
     if (!this.audioBuffer || !this.manifest) {
       console.warn('Audio sprite not loaded. Call load() first.');
       return;
@@ -235,6 +262,15 @@ export class AudioSpritePlayer {
       console.warn(`Sound "${soundName}" has invalid duration.`);
       return;
     }
+
+    // 1. Determine Channel (Default to 'sfx')
+    const channel = options?.channel || 'sfx';
+    const targetNode = channel === 'music' ? this.musicGain : this.sfxGain;
+
+    // 2. Determine Loop (Options override Manifest)
+    // defined in your existing code as: const sound = this.manifest.sprite[soundName];
+    // const manifestLoop = sound[2];
+    const loop = options?.loop !== undefined ? options.loop : sound[2];
     let source;
     const spriteBuffer = this.spriteBufferCache[soundName];
 
@@ -248,12 +284,12 @@ export class AudioSpritePlayer {
         console.error('RNAS Error: createBufferQueueSource is not available on this native platform.');
         return;
       }
-      const loop = sound[2];
       if (loop) {
         // Always use AudioBufferQueueSourceNode
         source = this.audioContext.createBufferQueueSource();
         source.enqueueBuffer(spriteBuffer);
-        source.connect(this.audioContext.destination);
+        // source.connect(this.audioContext.destination);
+        source.connect(targetNode);
 
         // Manual looping using onEnded
         const loopHandler = () => {
@@ -277,6 +313,10 @@ export class AudioSpritePlayer {
         source = this._getOrCreateSourceNode();
         if (!source) return; // Dropped sound because pool was full
 
+        // Reconnect to the correct channel (since pooled nodes might have been connected elsewhere)
+        source.disconnect();
+        source.connect(targetNode);
+
         // Must re-enqueue the buffer since the source was reused
         source.enqueueBuffer(spriteBuffer);
 
@@ -291,8 +331,10 @@ export class AudioSpritePlayer {
         return;
       }
       source.buffer = spriteBuffer;
-      source.connect(this.audioContext.destination);
-      const loop = sound[2]; // audiosprite stores loop as the third element in the array
+      // source.connect(this.audioContext.destination);
+      source.connect(targetNode);
+
+      // 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
@@ -336,5 +378,41 @@ export class AudioSpritePlayer {
       console.log('RNAS: No looping audio to stop.');
     }
   }
+
+  /**
+   * Sets the volume for background music only.
+   * @param value 0.0 to 1.0
+   */
+  setMusicVolume(value) {
+    if (this.musicGain) {
+      // secure against uninitialized context
+      this.musicGain.gain.setTargetAtTime(value, this.audioContext.currentTime, 0.02);
+    }
+  }
+
+  /**
+   * Sets the volume for sound effects only.
+   * @param value 0.0 to 1.0
+   */
+  setSFXVolume(value) {
+    if (this.sfxGain) {
+      this.sfxGain.gain.setTargetAtTime(value, this.audioContext.currentTime, 0.02);
+    }
+  }
+
+  /**
+   * Sets the Global Master Volume (affects both Music and SFX).
+   * @param value 0.0 to 1.0
+   */
+  set volume(value) {
+    if (this.masterGain) {
+      this.masterGain.gain.setTargetAtTime(value, this.audioContext.currentTime, 0.02);
+    }
+  }
+
+  // Master Volume getter
+  get volume() {
+    return this.masterGain?.gain?.value ?? 1.0;
+  }
 }
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

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

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

@@ -3,6 +3,28 @@
  * Requires an AudioContext and fetch to be injected.
  * Uses AudioBufferQueueSourceNode and buffer splitting for mobile stability.
  */
+/**
+ * Defines the available audio routing channels.
+ * - 'sfx': Short sound effects (coins, jumps, UI). High priority, usually usually non-looping.
+ * - 'music': Background tracks. Lower priority, usually looping, separate volume control.
+ */
+export type AudioChannel = 'sfx' | 'music';
+/**
+ * Configuration options for playing a specific sound sprite.
+ */
+export interface PlayOptions {
+    /**
+     * Specifies which mixer channel to route the audio through.
+     * Use 'music' for BGM to ensure it responds to music volume settings.
+     * @default 'sfx'
+     */
+    channel?: AudioChannel;
+    /**
+     * Force the sound to loop (or not), overriding the setting
+     * defined in the original audiosprite JSON manifest.
+     */
+    loop?: boolean;
+}
 export declare class AudioSpritePlayer {
     audioContext: any | null;
     fetch: any | null;
@@ -13,6 +35,9 @@ export declare class AudioSpritePlayer {
     private loopingSource;
     private sourcePool;
     private maxPoolSize;
+    masterGain: any;
+    sfxGain: any;
+    musicGain: any;
     constructor({ audioContext, fetch, platform, }: {
         audioContext: any | null;
         fetch: any;
@@ -47,7 +72,7 @@ export declare class AudioSpritePlayer {
      */
     private _getOrCreateSourceNode;
     load(json: any, audio?: any): Promise<void>;
-    play(soundName: string): void;
+    play(soundName: string, options?: PlayOptions): void;
     getManifest(): any;
     getAudioBuffer(): any;
     /**
@@ -55,5 +80,21 @@ export declare class AudioSpritePlayer {
      * If a looping sound is playing, it will be stopped immediately.
      */
     stop(): void;
+    /**
+     * Sets the volume for background music only.
+     * @param value 0.0 to 1.0
+     */
+    setMusicVolume(value: number): void;
+    /**
+     * Sets the volume for sound effects only.
+     * @param value 0.0 to 1.0
+     */
+    setSFXVolume(value: number): void;
+    /**
+     * Sets the Global Master Volume (affects both Music and SFX).
+     * @param value 0.0 to 1.0
+     */
+    set volume(value: number);
+    get volume(): number;
 }
 //# 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;IACpD,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAa;gBAEpB,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;IA8C3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuDxB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG;IA0EjC,IAAI,CAAC,SAAS,EAAE,MAAM;IAuHtB,WAAW;IAIX,cAAc;IAId;;;OAGG;IACH,IAAI;CASL"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,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;IACzC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAa;IAGzB,UAAU,EAAE,GAAG,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC;IACb,SAAS,EAAE,GAAG,CAAC;gBAEV,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;IAgDD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,mBAAmB;IA8C3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuDxB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG;IA0EjC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW;IAoI7C,WAAW;IAIX,cAAc;IAId;;;OAGG;IACH,IAAI;IAUJ;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM;IAW5B;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM;IAU1B;;;OAGG;IACH,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAQvB;IAGD,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-audiosprites",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "audio sprites for react native ios, android and web",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -36,6 +36,8 @@
     "typecheck": "tsc",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
     "clean": "del-cli lib",
+    "types:sync": "node scripts/generate-audio-types.mjs",
+    "prebuild": "npm run types:sync",
     "prepare": "bob build",
     "release:alpha": "release-it --preRelease=alpha",
     "release": "release-it --only-version",
@@ -81,11 +83,13 @@
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.35.0",
     "@evilmartians/lefthook": "^1.12.3",
+    "@react-native-community/slider": "^5.1.1",
     "@react-native/babel-preset": "0.81.1",
     "@react-native/eslint-config": "^0.81.1",
     "@release-it/conventional-changelog": "^10.0.1",
     "@types/jest": "^29.5.14",
     "@types/react": "^19.1.12",
+    "arktype": "^2.1.29",
     "commitlint": "^19.8.1",
     "del-cli": "^6.0.0",
     "eslint": "^9.35.0",
@@ -95,9 +99,10 @@
     "prettier": "^3.6.2",
     "react": "19.1.0",
     "react-native": "0.81.5",
-    "react-native-audio-api": "^0.9.3",
+    "react-native-audio-api": "0.10.1",
     "react-native-builder-bob": "^0.40.13",
     "release-it": "^19.0.4",
+    "ts-morph": "^27.0.2",
     "typescript": "^5.9.2"
   },
   "peerDependencies": {

package/src/index.tsx

@@ -3,6 +3,32 @@
  * Requires an AudioContext and fetch to be injected.
  * Uses AudioBufferQueueSourceNode and buffer splitting for mobile stability.
  */
+
+/**
+ * Defines the available audio routing channels.
+ * - 'sfx': Short sound effects (coins, jumps, UI). High priority, usually usually non-looping.
+ * - 'music': Background tracks. Lower priority, usually looping, separate volume control.
+ */
+export type AudioChannel = 'sfx' | 'music';
+
+/**
+ * Configuration options for playing a specific sound sprite.
+ */
+export interface PlayOptions {
+  /**
+   * Specifies which mixer channel to route the audio through.
+   * Use 'music' for BGM to ensure it responds to music volume settings.
+   * @default 'sfx'
+   */
+  channel?: AudioChannel;
+
+  /**
+   * Force the sound to loop (or not), overriding the setting
+   * defined in the original audiosprite JSON manifest.
+   */
+  loop?: boolean;
+}
+
 export class AudioSpritePlayer {
   audioContext: any | null;
   fetch: any | null;
@@ -15,6 +41,11 @@ export class AudioSpritePlayer {
   private sourcePool: any[] = []; // NEW: Pool for non-looping sources
   private maxPoolSize: number = 5; // Adjust this based on testing (5 is a good start)
 
+  // NEW: The Mixer
+  public masterGain: any;
+  public sfxGain: any;
+  public musicGain: any;
+
   constructor({
     audioContext,
     fetch,
@@ -55,6 +86,20 @@ export class AudioSpritePlayer {
       // @ts-ignore
       this.audioContext = new AudioContext();
     }
+
+    // 1. Create Master Output
+    this.masterGain = this.audioContext.createGain();
+    this.masterGain.gain.value = 1.0;
+    this.masterGain.connect(this.audioContext.destination);
+
+    // 2. Create Channels
+    this.sfxGain = this.audioContext.createGain();
+    this.sfxGain.gain.value = 1.0;
+    this.sfxGain.connect(this.masterGain); // Connect to Master
+
+    this.musicGain = this.audioContext.createGain();
+    this.musicGain.gain.value = 1.0;
+    this.musicGain.connect(this.masterGain); // Connect to Master
   }
 
   /**
@@ -133,7 +178,7 @@ export class AudioSpritePlayer {
     if (this.platform === 'web') {
       // Web logic remains simple: always create a standard AudioBufferSourceNode
       const source = this.audioContext.createBufferSource();
-      source.connect(this.audioContext.destination);
+      // source.connect(this.audioContext.destination);
       return source;
     }
 
@@ -153,7 +198,7 @@ export class AudioSpritePlayer {
         return null;
       }
       source = this.audioContext.createBufferQueueSource();
-      source.connect(this.audioContext.destination);
+      // source.connect(this.audioContext.destination);
       // console.log('Created new source. Pool size:', this.sourcePool.length);
     } else {
       // If pool is full, we might have to block or fail.
@@ -258,7 +303,7 @@ export class AudioSpritePlayer {
     }
   }
 
-  play(soundName: string) {
+  play(soundName: string, options?: PlayOptions) {
     if (!this.audioBuffer || !this.manifest) {
       console.warn('Audio sprite not loaded. Call load() first.');
       return;
@@ -283,6 +328,15 @@ export class AudioSpritePlayer {
       return;
     }
 
+    // 1. Determine Channel (Default to 'sfx')
+    const channel = options?.channel || 'sfx';
+    const targetNode = channel === 'music' ? this.musicGain : this.sfxGain;
+
+    // 2. Determine Loop (Options override Manifest)
+    // defined in your existing code as: const sound = this.manifest.sprite[soundName];
+    // const manifestLoop = sound[2];
+    const loop = options?.loop !== undefined ? options.loop : sound[2];
+
     let source: any;
     const spriteBuffer = this.spriteBufferCache[soundName];
 
@@ -302,13 +356,12 @@ export class AudioSpritePlayer {
         return;
       }
 
-      const loop = sound[2];
-
       if (loop) {
         // Always use AudioBufferQueueSourceNode
         source = this.audioContext.createBufferQueueSource();
         source.enqueueBuffer(spriteBuffer);
-        source.connect(this.audioContext.destination);
+        // source.connect(this.audioContext.destination);
+        source.connect(targetNode);
 
         // Manual looping using onEnded
         const loopHandler = () => {
@@ -332,6 +385,10 @@ export class AudioSpritePlayer {
         source = this._getOrCreateSourceNode();
         if (!source) return; // Dropped sound because pool was full
 
+        // Reconnect to the correct channel (since pooled nodes might have been connected elsewhere)
+        source.disconnect();
+        source.connect(targetNode);
+
         // Must re-enqueue the buffer since the source was reused
         source.enqueueBuffer(spriteBuffer);
 
@@ -350,9 +407,10 @@ export class AudioSpritePlayer {
       }
 
       source.buffer = spriteBuffer;
-      source.connect(this.audioContext.destination);
+      // source.connect(this.audioContext.destination);
+      source.connect(targetNode);
 
-      const loop = sound[2]; // audiosprite stores loop as the third element in the array
+      // 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
@@ -398,4 +456,52 @@ export class AudioSpritePlayer {
       console.log('RNAS: No looping audio to stop.');
     }
   }
+
+  /**
+   * Sets the volume for background music only.
+   * @param value 0.0 to 1.0
+   */
+  setMusicVolume(value: number) {
+    if (this.musicGain) {
+      // secure against uninitialized context
+      this.musicGain.gain.setTargetAtTime(
+        value,
+        this.audioContext.currentTime,
+        0.02
+      );
+    }
+  }
+
+  /**
+   * Sets the volume for sound effects only.
+   * @param value 0.0 to 1.0
+   */
+  setSFXVolume(value: number) {
+    if (this.sfxGain) {
+      this.sfxGain.gain.setTargetAtTime(
+        value,
+        this.audioContext.currentTime,
+        0.02
+      );
+    }
+  }
+
+  /**
+   * Sets the Global Master Volume (affects both Music and SFX).
+   * @param value 0.0 to 1.0
+   */
+  set volume(value: number) {
+    if (this.masterGain) {
+      this.masterGain.gain.setTargetAtTime(
+        value,
+        this.audioContext.currentTime,
+        0.02
+      );
+    }
+  }
+
+  // Master Volume getter
+  get volume(): number {
+    return this.masterGain?.gain?.value ?? 1.0;
+  }
 }