From 4100d8a925fefb74507f24fdf289f72f7783077f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20S=C4=99k?= <michal.sek@swmansion.com>
Date: Mon, 9 Feb 2026 15:15:31 +0100
Subject: [PATCH 1/2] feat: use audio context hook

---
 apps/common-app/src/App.tsx                   |  3 +-
 apps/fabric-example/ios/Podfile.lock          |  2 +-
 .../src/core/AudioContext.ts                  |  2 +
 .../react-native-audio-api/src/hooks/index.ts |  1 +
 .../src/hooks/useAudioContext.tsx             | 55 +++++++++++++++++++
 5 files changed, 61 insertions(+), 2 deletions(-)
 create mode 100644 packages/react-native-audio-api/src/hooks/useAudioContext.tsx

diff --git a/apps/common-app/src/App.tsx b/apps/common-app/src/App.tsx
index 9bf407505..c877dc619 100644
--- a/apps/common-app/src/App.tsx
+++ b/apps/common-app/src/App.tsx
@@ -170,7 +170,8 @@ const App: FC = () => {
             headerTintColor: colors.white,
             headerBackTitle: 'Back',
             headerBackAccessibilityLabel: 'Go back',
-          }}>
+          }}
+        >
           <Stack.Screen
             name="MainTabs"
             component={MainTabsScreen}
diff --git a/apps/fabric-example/ios/Podfile.lock b/apps/fabric-example/ios/Podfile.lock
index d9f0227d9..2bc3ce669 100644
--- a/apps/fabric-example/ios/Podfile.lock
+++ b/apps/fabric-example/ios/Podfile.lock
@@ -3321,7 +3321,7 @@ SPEC CHECKSUMS:
   FBLazyVector: 309703e71d3f2f1ed7dc7889d58309c9d77a95a4
   fmt: a40bb5bd0294ea969aaaba240a927bd33d878cdd
   glog: 5683914934d5b6e4240e497e0f4a3b42d1854183
-  hermes-engine: f93b5009d8ccd9429fe2a772351980df8a22a413
+  hermes-engine: 42d6f09ee6ede2feb220e2fb772e8bebb42ca403
   RCT-Folly: 846fda9475e61ec7bcbf8a3fe81edfcaeb090669
   RCTDeprecation: a41bbdd9af30bf2e5715796b313e44ec43eefff1
   RCTRequired: 7be34aabb0b77c3cefe644528df0fa0afad4e4d0
diff --git a/packages/react-native-audio-api/src/core/AudioContext.ts b/packages/react-native-audio-api/src/core/AudioContext.ts
index ffe927c65..468af62f3 100644
--- a/packages/react-native-audio-api/src/core/AudioContext.ts
+++ b/packages/react-native-audio-api/src/core/AudioContext.ts
@@ -7,6 +7,8 @@ import BaseAudioContext from './BaseAudioContext';
 
 export default class AudioContext extends BaseAudioContext {
   constructor(options?: AudioContextOptions) {
+    console.log('Creating AudioContext with options:', options);
+
     if (
       options &&
       options.sampleRate &&
diff --git a/packages/react-native-audio-api/src/hooks/index.ts b/packages/react-native-audio-api/src/hooks/index.ts
index a9e230543..8f583de9b 100644
--- a/packages/react-native-audio-api/src/hooks/index.ts
+++ b/packages/react-native-audio-api/src/hooks/index.ts
@@ -1,2 +1,3 @@
+export { AudioContextProvider, useAudioContext } from './useAudioContext';
 export { default as useAudioInput } from './useAudioInput';
 export { default as useSystemVolume } from './useSystemVolume';
diff --git a/packages/react-native-audio-api/src/hooks/useAudioContext.tsx b/packages/react-native-audio-api/src/hooks/useAudioContext.tsx
new file mode 100644
index 000000000..5d468d6b7
--- /dev/null
+++ b/packages/react-native-audio-api/src/hooks/useAudioContext.tsx
@@ -0,0 +1,55 @@
+import React, { ReactNode, createContext, useContext, useMemo } from 'react';
+
+import { AudioContext, AudioContextOptions } from '../api';
+
+interface AudioContextProviderProps {
+  context?: AudioContext;
+  options?: AudioContextOptions;
+  children: ReactNode;
+}
+
+let globalAudioContextInstance: AudioContext | null = null;
+
+function getGlobalAudioContextInstance(): AudioContext {
+  if (!globalAudioContextInstance) {
+    globalAudioContextInstance = new AudioContext();
+  }
+
+  return globalAudioContextInstance;
+}
+
+const ReactAudioContext = createContext<AudioContext | null>(null);
+
+export const AudioContextProvider: React.FC<AudioContextProviderProps> = ({
+  context,
+  options,
+  children,
+}) => {
+  const rCtx = useMemo(() => {
+    if (context) {
+      return context;
+    }
+
+    if (options) {
+      return new AudioContext(options);
+    }
+
+    return getGlobalAudioContextInstance();
+  }, [context, options]);
+
+  return (
+    <ReactAudioContext.Provider value={rCtx}>
+      {children}
+    </ReactAudioContext.Provider>
+  );
+};
+
+export function useAudioContext(): AudioContext {
+  const reactContext = useContext(ReactAudioContext);
+
+  if (reactContext) {
+    return reactContext;
+  }
+
+  return getGlobalAudioContextInstance();
+}

From 7636b6ebc3a492ddf1da14f6059507d81da987ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20S=C4=99k?= <michal.sek@swmansion.com>
Date: Tue, 10 Feb 2026 15:37:55 +0100
Subject: [PATCH 2/2] feat: useAudioContext hook, state change event

---
 .../src/examples/LFCHooks/LFCHooks.tsx        | 172 ++++++++++++++++++
 .../src/examples/LFCHooks/index.tsx           |   1 +
 apps/common-app/src/examples/index.ts         |   8 +
 .../swmansion/audioapi/system/AudioEvent.kt   |   1 +
 .../BaseAudioContextHostObject.cpp            |   7 +
 .../HostObjects/BaseAudioContextHostObject.h  |   3 +
 .../HostObjects/utils/JsEnumParser.cpp        |   2 +
 .../common/cpp/audioapi/core/AudioContext.cpp |   2 +-
 .../cpp/audioapi/core/BaseAudioContext.cpp    |  18 ++
 .../cpp/audioapi/core/BaseAudioContext.h      |   4 +
 .../common/cpp/audioapi/events/AudioEvent.h   |   2 +
 .../src/core/BaseAudioContext.ts              |  34 ++++
 .../src/events/types.ts                       |   1 +
 .../src/hooks/useAudioContext.tsx             |  36 +++-
 .../react-native-audio-api/src/interfaces.ts  |   2 +
 15 files changed, 283 insertions(+), 10 deletions(-)
 create mode 100644 apps/common-app/src/examples/LFCHooks/LFCHooks.tsx
 create mode 100644 apps/common-app/src/examples/LFCHooks/index.tsx

diff --git a/apps/common-app/src/examples/LFCHooks/LFCHooks.tsx b/apps/common-app/src/examples/LFCHooks/LFCHooks.tsx
new file mode 100644
index 000000000..67b65ae30
--- /dev/null
+++ b/apps/common-app/src/examples/LFCHooks/LFCHooks.tsx
@@ -0,0 +1,172 @@
+import React, { useEffect, useMemo, useRef, useState } from 'react';
+import { StyleSheet, Text, View } from 'react-native';
+import {
+  AudioBuffer,
+  AudioBufferSourceNode,
+  AudioContext,
+  AudioContextProvider,
+  useAudioContext,
+} from 'react-native-audio-api';
+
+import { Button, Container, Spacer } from '../../components';
+
+type ComponentType = 'global' | 'provider' | 'customProvider';
+
+const filePath =
+  'https://software-mansion.github.io/react-native-audio-api/audio/voice/example-voice-01.mp3';
+
+const ContextUserComponent: React.FC = () => {
+  const audioContext = useAudioContext();
+  const [sampleBuffer, setSampleBuffer] = useState<AudioBuffer | null>(null);
+  const [sourceNode, setSourceNode] = useState<AudioBufferSourceNode | null>(
+    null
+  );
+  const sourceNodeRef = useRef<AudioBufferSourceNode | null>(null);
+
+  useEffect(() => {
+    sourceNodeRef.current = sourceNode;
+  }, [sourceNode]);
+
+  const onToggleState = async () => {
+    if (audioContext.state === 'suspended') {
+      await audioContext.resume();
+    } else {
+      await audioContext.suspend();
+    }
+  };
+
+  useEffect(() => {
+    async function prepareSample() {
+      const buffer = await audioContext.decodeAudioData(filePath);
+      setSampleBuffer(buffer);
+    }
+
+    prepareSample();
+  }, [audioContext]);
+
+  const onPlaySample = () => {
+    if (!sampleBuffer) {
+      return;
+    }
+
+    const node = audioContext.createBufferSource();
+    node.buffer = sampleBuffer;
+    node.connect(audioContext.destination);
+    node.start();
+
+    setSourceNode(node);
+  };
+
+  const onStopSample = () => {
+    if (!sourceNode) {
+      return;
+    }
+
+    sourceNode.stop();
+    setSourceNode(null);
+  };
+
+  useEffect(() => {
+    return () => {
+      if (sourceNodeRef.current) {
+        sourceNodeRef.current.stop();
+      }
+    };
+  }, []);
+
+  return (
+    <>
+      <Text style={style.label}>state: {audioContext.state}</Text>
+      <Spacer.Vertical size={20} />
+      <Button title="Toggle state" onPress={onToggleState} />
+      {!!sampleBuffer && (
+        <>
+          <Spacer.Vertical size={20} />
+          <Text style={style.label}>
+            Sample buffer loaded with {sampleBuffer.length} frames
+          </Text>
+          <Spacer.Vertical size={20} />
+          {!sourceNode ? (
+            <Button title="Play sample" onPress={onPlaySample} />
+          ) : (
+            <Button title="Stop sample" onPress={onStopSample} />
+          )}
+        </>
+      )}
+    </>
+  );
+};
+
+const ComponentWithProvider: React.FC = () => {
+  return (
+    <AudioContextProvider options={{ sampleRate: 16000 }}>
+      <ContextUserComponent />
+    </AudioContextProvider>
+  );
+};
+
+const ComponentWithCustomProvider: React.FC = () => {
+  const context = useMemo(() => new AudioContext({ sampleRate: 8000 }), []);
+
+  return (
+    <AudioContextProvider context={context}>
+      <ContextUserComponent />
+    </AudioContextProvider>
+  );
+};
+
+const LFCHooks: React.FC = () => {
+  const [type, setType] = useState<ComponentType | null>(null);
+
+  const component = useMemo(() => {
+    if (!type) {
+      return null;
+    }
+
+    switch (type) {
+      case 'global':
+        return <ContextUserComponent />;
+      case 'provider':
+        return <ComponentWithProvider />;
+      case 'customProvider':
+        return <ComponentWithCustomProvider />;
+    }
+  }, [type]);
+
+  return (
+    <Container>
+      <View style={style.buttons}>
+        {!!type && <Button title="Reset" onPress={() => setType(null)} />}
+        <Spacer.Vertical size={20} />
+        <Button
+          title="Use global audio context"
+          onPress={() => setType('global')}
+        />
+        <Spacer.Vertical size={20} />
+        <Button
+          title="Use audio context from provider"
+          onPress={() => setType('provider')}
+        />
+        <Spacer.Vertical size={20} />
+        <Button
+          title="Use audio context from custom provider"
+          onPress={() => setType('customProvider')}
+        />
+      </View>
+      <Spacer.Vertical size={20} />
+      {component}
+    </Container>
+  );
+};
+
+export default LFCHooks;
+
+const style = StyleSheet.create({
+  buttons: {
+    flexDirection: 'column',
+    alignItems: 'stretch',
+  },
+  label: {
+    color: 'white',
+  },
+});
diff --git a/apps/common-app/src/examples/LFCHooks/index.tsx b/apps/common-app/src/examples/LFCHooks/index.tsx
new file mode 100644
index 000000000..ac87a2155
--- /dev/null
+++ b/apps/common-app/src/examples/LFCHooks/index.tsx
@@ -0,0 +1 @@
+export { default } from './LFCHooks';
diff --git a/apps/common-app/src/examples/index.ts b/apps/common-app/src/examples/index.ts
index 554dcaf49..93a666b74 100644
--- a/apps/common-app/src/examples/index.ts
+++ b/apps/common-app/src/examples/index.ts
@@ -4,6 +4,7 @@ import { icons } from 'lucide-react-native';
 import AudioFile from './AudioFile';
 import AudioVisualizer from './AudioVisualizer';
 import DrumMachine from './DrumMachine';
+import LFCHooks from './LFCHooks';
 import Metronome from './Metronome';
 import OfflineRendering from './OfflineRendering';
 import Oscillator from './Oscillator';
@@ -26,6 +27,7 @@ type NavigationParamList = {
   Record: undefined;
   Worklets: undefined;
   Streamer: undefined;
+  LFCHooks: undefined;
 };
 
 export type ExampleKey = keyof NavigationParamList;
@@ -110,4 +112,10 @@ export const Examples: Example[] = [
     Icon: icons.Radio,
     screen: Streaming,
   },
+  {
+    key: 'LFCHooks',
+    title: 'LFC Hooks',
+    Icon: icons.Wifi,
+    screen: LFCHooks,
+  },
 ] as const;
diff --git a/packages/react-native-audio-api/android/src/main/java/com/swmansion/audioapi/system/AudioEvent.kt b/packages/react-native-audio-api/android/src/main/java/com/swmansion/audioapi/system/AudioEvent.kt
index 72e02d5f0..daa24cea1 100644
--- a/packages/react-native-audio-api/android/src/main/java/com/swmansion/audioapi/system/AudioEvent.kt
+++ b/packages/react-native-audio-api/android/src/main/java/com/swmansion/audioapi/system/AudioEvent.kt
@@ -25,4 +25,5 @@ enum class AudioEvent {
   POSITION_CHANGED,
   BUFFER_ENDED,
   RECORDER_ERROR,
+  CONTEXT_STATE_CHANGED,
 }
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.cpp b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.cpp
index 3942b44a0..2a112af64 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.cpp
+++ b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.cpp
@@ -44,6 +44,8 @@ BaseAudioContextHostObject::BaseAudioContextHostObject(
       JSI_EXPORT_PROPERTY_GETTER(BaseAudioContextHostObject, state),
       JSI_EXPORT_PROPERTY_GETTER(BaseAudioContextHostObject, sampleRate),
       JSI_EXPORT_PROPERTY_GETTER(BaseAudioContextHostObject, currentTime));
+        
+  addSetters(JSI_EXPORT_PROPERTY_SETTER(BaseAudioContextHostObject, onStateChanged));
 
   addFunctions(
       JSI_EXPORT_FUNCTION(BaseAudioContextHostObject, createWorkletSourceNode),
@@ -89,6 +91,10 @@ JSI_PROPERTY_GETTER_IMPL(BaseAudioContextHostObject, currentTime) {
   return {context_->getCurrentTime()};
 }
 
+JSI_PROPERTY_SETTER_IMPL(BaseAudioContextHostObject, onStateChanged) {
+  context_->setOnStateChangedCallbackId(std::stoull(value.getString(runtime).utf8(runtime)));
+}
+
 JSI_HOST_FUNCTION_IMPL(BaseAudioContextHostObject, createWorkletSourceNode) {
 #if RN_AUDIO_API_ENABLE_WORKLETS
   auto shareableWorklet =
@@ -312,4 +318,5 @@ JSI_HOST_FUNCTION_IMPL(BaseAudioContextHostObject, createWaveShaper) {
       std::make_shared<WaveShaperNodeHostObject>(context_, waveShaperOptions);
   return jsi::Object::createFromHostObject(runtime, waveShaperHostObject);
 }
+
 } // namespace audioapi
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.h b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.h
index 6ccd1dc3d..0e3af55f2 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.h
+++ b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.h
@@ -29,6 +29,8 @@ class BaseAudioContextHostObject : public JsiHostObject {
   JSI_PROPERTY_GETTER_DECL(sampleRate);
   JSI_PROPERTY_GETTER_DECL(currentTime);
 
+  JSI_PROPERTY_SETTER_DECL(onStateChanged);
+
   JSI_HOST_FUNCTION_DECL(createWorkletSourceNode);
   JSI_HOST_FUNCTION_DECL(createWorkletNode);
   JSI_HOST_FUNCTION_DECL(createWorkletProcessingNode);
@@ -55,4 +57,5 @@ class BaseAudioContextHostObject : public JsiHostObject {
 
   std::shared_ptr<AudioDestinationNodeHostObject> destination_;
 };
+
 } // namespace audioapi
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/utils/JsEnumParser.cpp b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/utils/JsEnumParser.cpp
index 312d45af0..6a3955fe0 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/utils/JsEnumParser.cpp
+++ b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/utils/JsEnumParser.cpp
@@ -171,6 +171,8 @@ namespace audioapi::js_enum_parser {
       return AudioEvent::BUFFER_ENDED;
     if (event == "recorderError")
       return AudioEvent::RECORDER_ERROR;
+    if (event == "contextStateChanged")
+      return AudioEvent::CONTEXT_STATE_CHANGED;
 
     throw std::invalid_argument("Unknown audio event: " + event);
   }
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/AudioContext.cpp b/packages/react-native-audio-api/common/cpp/audioapi/core/AudioContext.cpp
index 853f5633c..ea7387699 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/core/AudioContext.cpp
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/AudioContext.cpp
@@ -16,7 +16,7 @@ AudioContext::AudioContext(
     const std::shared_ptr<IAudioEventHandlerRegistry> &audioEventHandlerRegistry,
     const RuntimeRegistry &runtimeRegistry)
     : BaseAudioContext(sampleRate, audioEventHandlerRegistry, runtimeRegistry),
-      isInitialized_(false) {}
+      isInitialized_(false) { }
 
 AudioContext::~AudioContext() {
   if (getState() != ContextState::CLOSED) {
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.cpp b/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.cpp
index f119be1d5..eb9f10261 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.cpp
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.cpp
@@ -78,6 +78,7 @@ std::shared_ptr<AudioDestinationNode> BaseAudioContext::getDestination() const {
 
 void BaseAudioContext::setState(audioapi::ContextState state) {
   state_.store(state, std::memory_order_release);
+  sendOnStateChangedEvent();
 }
 
 std::shared_ptr<WorkletSourceNode> BaseAudioContext::createWorkletSourceNode(
@@ -261,4 +262,21 @@ const RuntimeRegistry &BaseAudioContext::getRuntimeRegistry() const {
   return runtimeRegistry_;
 }
 
+void BaseAudioContext::setOnStateChangedCallbackId(uint64_t callbackId) {
+  auto oldCallbackId = onStateChangedCallbackId_.exchange(callbackId, std::memory_order_acq_rel);
+
+  if (oldCallbackId != 0) {
+    audioEventHandlerRegistry_->unregisterHandler(AudioEvent::CONTEXT_STATE_CHANGED, oldCallbackId);
+  }
+}
+
+void BaseAudioContext::sendOnStateChangedEvent() {
+  auto onStateChangedCallbackId = onStateChangedCallbackId_.load(std::memory_order_acquire);
+
+  if (onStateChangedCallbackId != 0) {
+    audioEventHandlerRegistry_->invokeHandlerWithEventBody(
+        AudioEvent::CONTEXT_STATE_CHANGED, onStateChangedCallbackId, {});
+  }
+}
+
 } // namespace audioapi
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.h b/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.h
index ff7da2d28..b6ec5ae0b 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.h
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.h
@@ -113,10 +113,13 @@ class BaseAudioContext : public std::enable_shared_from_this<BaseAudioContext> {
 
   virtual void initialize();
 
+  void setOnStateChangedCallbackId(uint64_t callbackId);
+
  protected:
   std::shared_ptr<AudioDestinationNode> destination_;
 
  private:
+  std::atomic<uint64_t> onStateChangedCallbackId_ = 0; // 0 means no callback
   std::atomic<ContextState> state_;
   std::atomic<float> sampleRate_;
   std::shared_ptr<AudioGraphManager> graphManager_;
@@ -129,6 +132,7 @@ class BaseAudioContext : public std::enable_shared_from_this<BaseAudioContext> {
   std::shared_ptr<PeriodicWave> cachedTriangleWave_ = nullptr;
 
   [[nodiscard]] virtual bool isDriverRunning() const = 0;
+  void sendOnStateChangedEvent();
 };
 
 } // namespace audioapi
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/events/AudioEvent.h b/packages/react-native-audio-api/common/cpp/audioapi/events/AudioEvent.h
index 1b6339b93..f24475415 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/events/AudioEvent.h
+++ b/packages/react-native-audio-api/common/cpp/audioapi/events/AudioEvent.h
@@ -26,5 +26,7 @@ enum class AudioEvent {
   POSITION_CHANGED,
   BUFFER_ENDED,
   RECORDER_ERROR,
+  CONTEXT_STATE_CHANGED,
 };
+
 } // namespace audioapi
diff --git a/packages/react-native-audio-api/src/core/BaseAudioContext.ts b/packages/react-native-audio-api/src/core/BaseAudioContext.ts
index 452dcbe85..55eecdff7 100644
--- a/packages/react-native-audio-api/src/core/BaseAudioContext.ts
+++ b/packages/react-native-audio-api/src/core/BaseAudioContext.ts
@@ -3,6 +3,8 @@ import {
   InvalidStateError,
   NotSupportedError,
 } from '../errors';
+import { AudioEventEmitter, AudioEventSubscription } from '../events';
+import { EventEmptyType } from '../events/types';
 import { IBaseAudioContext } from '../interfaces';
 import { AudioWorkletRuntime, ContextState, DecodeDataInput } from '../types';
 import { assertWorkletsEnabled } from '../utils';
@@ -32,6 +34,11 @@ export default class BaseAudioContext {
   readonly destination: AudioDestinationNode;
   readonly sampleRate: number;
   readonly context: IBaseAudioContext;
+  private onStateChangedSubscription?: AudioEventSubscription;
+  private onStateChangedCallback?: (event: EventEmptyType) => void;
+  protected readonly audioEventEmitter = new AudioEventEmitter(
+    global.AudioEventEmitter
+  );
 
   constructor(context: IBaseAudioContext) {
     this.context = context;
@@ -237,4 +244,31 @@ export default class BaseAudioContext {
   createWaveShaper(): WaveShaperNode {
     return new WaveShaperNode(this);
   }
+
+  public get onStateChanged(): ((event: EventEmptyType) => void) | undefined {
+    return this.onStateChangedCallback;
+  }
+
+  public set onStateChanged(
+    callback: ((event: EventEmptyType) => void) | null
+  ) {
+    if (!callback) {
+      this.context.onStateChanged = '0';
+      this.onStateChangedSubscription?.remove();
+      this.onStateChangedSubscription = undefined;
+      this.onStateChangedCallback = undefined;
+
+      return;
+    }
+
+    this.onStateChangedCallback = callback;
+    this.onStateChangedSubscription =
+      this.audioEventEmitter.addAudioEventListener(
+        'contextStateChanged',
+        callback
+      );
+
+    this.context.onStateChanged =
+      this.onStateChangedSubscription.subscriptionId;
+  }
 }
diff --git a/packages/react-native-audio-api/src/events/types.ts b/packages/react-native-audio-api/src/events/types.ts
index 894b95877..812a8db3d 100644
--- a/packages/react-native-audio-api/src/events/types.ts
+++ b/packages/react-native-audio-api/src/events/types.ts
@@ -75,6 +75,7 @@ interface AudioAPIEvents {
   positionChanged: EventTypeWithValue;
   bufferEnded: OnBufferEndEventType;
   recorderError: OnRecorderErrorEventType;
+  contextStateChanged: EventEmptyType;
 }
 
 type AudioEvents = SystemEvents & AudioAPIEvents & NotificationEvents;
diff --git a/packages/react-native-audio-api/src/hooks/useAudioContext.tsx b/packages/react-native-audio-api/src/hooks/useAudioContext.tsx
index 5d468d6b7..0be9ddcbe 100644
--- a/packages/react-native-audio-api/src/hooks/useAudioContext.tsx
+++ b/packages/react-native-audio-api/src/hooks/useAudioContext.tsx
@@ -1,4 +1,11 @@
-import React, { ReactNode, createContext, useContext, useMemo } from 'react';
+import React, {
+  ReactNode,
+  createContext,
+  useContext,
+  useEffect,
+  useMemo,
+  useState,
+} from 'react';
 
 import { AudioContext, AudioContextOptions } from '../api';
 
@@ -25,17 +32,19 @@ export const AudioContextProvider: React.FC<AudioContextProviderProps> = ({
   options,
   children,
 }) => {
+  const { sampleRate } = options || {};
+
   const rCtx = useMemo(() => {
     if (context) {
       return context;
     }
 
-    if (options) {
-      return new AudioContext(options);
+    if (typeof sampleRate === 'number') {
+      return new AudioContext({ sampleRate });
     }
 
     return getGlobalAudioContextInstance();
-  }, [context, options]);
+  }, [context, sampleRate]);
 
   return (
     <ReactAudioContext.Provider value={rCtx}>
@@ -45,11 +54,20 @@ export const AudioContextProvider: React.FC<AudioContextProviderProps> = ({
 };
 
 export function useAudioContext(): AudioContext {
-  const reactContext = useContext(ReactAudioContext);
+  const context =
+    useContext(ReactAudioContext) ?? getGlobalAudioContextInstance();
+  // Keep track of the state to trigger re-renders when it changes
+  const [, setState] = useState(context.state);
 
-  if (reactContext) {
-    return reactContext;
-  }
+  useEffect(() => {
+    context.onStateChanged = () => {
+      setState(context.state);
+    };
+
+    return () => {
+      context.onStateChanged = null;
+    };
+  }, [context]);
 
-  return getGlobalAudioContextInstance();
+  return context;
 }
diff --git a/packages/react-native-audio-api/src/interfaces.ts b/packages/react-native-audio-api/src/interfaces.ts
index 6c8b49b1d..d6b16355d 100644
--- a/packages/react-native-audio-api/src/interfaces.ts
+++ b/packages/react-native-audio-api/src/interfaces.ts
@@ -60,6 +60,8 @@ export interface IBaseAudioContext {
   readonly decoder: IAudioDecoder;
   readonly stretcher: IAudioStretcher;
 
+  set onStateChanged(callbackId: string);
+
   createRecorderAdapter(): IRecorderAdapterNode;
   createWorkletSourceNode(
     shareableWorklet: ShareableWorkletCallback,