Merge branch 'main' into feat/opus-decoder

Author: vltkv

README.md

@@ -13,7 +13,7 @@ allowing developers to generate and modify audio in exact same way it is possibl
 
 ## Installation
 
-check out the [Getting Started](https://docs.swmansion.com/react-native-audio-api/fundamentals/getting-started) section of our documentation for detailed instructions!
+check out the [Getting Started](https://docs.swmansion.com/react-native-audio-api/docs/fundamentals/getting-started) section of our documentation for detailed instructions!
 
 ## Roadmap
 
@@ -42,16 +42,21 @@ check out the [Getting Started](https://docs.swmansion.com/react-native-audio-ap
 - <sub>[![Released in 0.6.0](https://img.shields.io/badge/Released_in-0.6.0-green)](https://github.com/software-mansion/react-native-audio-api/releases/tag/0.6.0)</sub> **Connect audio param** 🤞  <br />
   Ability to connect Audio nodes to audio params, which will allow for powerful and efficient modulation of audio parameters, creating effects like tremolo, vibrato or complex envelope followers. <br />
 
-- **Microphone support** 🎙️ <br />
+- <sub>[![Released in 0.7.0](https://img.shields.io/badge/Released_in-0.7.0-green)](https://github.com/software-mansion/react-native-audio-api/releases/tag/0.7.0)</sub>
+**Microphone support** 🎙️ <br />
   Grab audio data from device microphone or connected device, connect it to the audio graph or stream through the internet <br />
 
+- <sub>[![Released in 0.7.0](https://img.shields.io/badge/Released_in-0.7.0-green)](https://github.com/software-mansion/react-native-audio-api/releases/tag/0.7.0)</sub>
+**Custom Audio Processor** 🎙️ <br />
+  Write your own processing AudioNode <br />
+
 - **JS Audio Worklets** 🐎 <br />
   Ability to run JS functions connected to the audio graph running on audio thread allowing for full customization of what happens to the audio signal.
   <br />
 
 ## Web Audio API Specification Coverage
 
-Our current coverage of Web Audio API specification can be found here: [Web Audio API coverage](https://software-mansion.github.io/react-native-audio-api/other/web-audio-api-coverage).
+Our current coverage of Web Audio API specification can be found here: [Web Audio API coverage](https://docs.swmansion.com/react-native-audio-api/docs/other/web-audio-api-coverage).
 
 ## Examples
 

apps/common-app/src/examples/AudioFile/AudioFile.tsx

@@ -54,6 +54,7 @@ const AudioFile: FC = () => {
     AudioManager.enableRemoteCommand('remoteSkipForward', true);
     AudioManager.enableRemoteCommand('remoteSkipBackward', true);
     AudioManager.observeAudioInterruptions(true);
+    AudioManager.activelyReclaimSession(true);
 
     const remotePlaySubscription = AudioManager.addSystemEventListener(
       'remotePlay',

apps/common-app/src/examples/Record/Record.tsx

@@ -5,7 +5,7 @@ import {
   AudioRecorder,
   RecorderAdapterNode,
   AudioBufferSourceNode,
-  AudioBuffer
+  AudioBuffer,
 } from 'react-native-audio-api';
 
 import { Container, Button } from '../../components';
@@ -21,21 +21,21 @@ const Record: FC = () => {
   const audioBuffersRef = useRef<AudioBuffer[]>([]);
   const sourcesRef = useRef<AudioBufferSourceNode[]>([]);
 
-
   useEffect(() => {
     AudioManager.setAudioSessionOptions({
       iosCategory: 'playAndRecord',
       iosMode: 'spokenAudio',
       iosOptions: ['defaultToSpeaker', 'allowBluetoothA2DP'],
     });
-    
+
+    AudioManager.requestRecordingPermissions();
+
     recorderRef.current = new AudioRecorder({
       sampleRate: SAMPLE_RATE,
       bufferLengthInSamples: SAMPLE_RATE,
     });
   }, []);
 
-
   const startEcho = () => {
     if (!recorderRef.current) {
       console.error('AudioContext or AudioRecorder is not initialized');
@@ -46,15 +46,15 @@ const Record: FC = () => {
     recorderAdapterRef.current = aCtxRef.current.createRecorderAdapter();
     recorderAdapterRef.current.connect(aCtxRef.current.destination);
     recorderRef.current.connect(recorderAdapterRef.current);
-    
+
     recorderRef.current.start();
-    console.log('Recording started'); 
+    console.log('Recording started');
     console.log('Audio context state:', aCtxRef.current.state);
     if (aCtxRef.current.state === 'suspended') {
       console.log('Resuming audio context');
       aCtxRef.current.resume();
     }
-  }
+  };
 
   /// This stops only the recording, not the audio context
   const stopEcho = () => {
@@ -66,7 +66,7 @@ const Record: FC = () => {
     aCtxRef.current = null;
     recorderAdapterRef.current = null;
     console.log('Recording stopped');
-  }
+  };
 
   const startRecordReplay = () => {
     if (!recorderRef.current) {
@@ -92,8 +92,7 @@ const Record: FC = () => {
       recorderRef.current?.stop();
       console.log('Recording stopped');
     }, 5000);
-
-  }
+  };
 
   const stopRecordReplay = () => {
     const aCtx = new AudioContext({ sampleRate: SAMPLE_RATE });
@@ -128,19 +127,22 @@ const Record: FC = () => {
       },
       (nextStartAt - tNow) * 1000
     );
-
-  }
+  };
 
   return (
     <Container style={{ gap: 40 }}>
-      <Text style={{ color: colors.white, fontSize: 24, textAlign: 'center' }}>Sample rate: {SAMPLE_RATE}</Text>
+      <Text style={{ color: colors.white, fontSize: 24, textAlign: 'center' }}>
+        Sample rate: {SAMPLE_RATE}
+      </Text>
       <View style={{ alignItems: 'center', justifyContent: 'center', gap: 5 }}>
         <Text style={{ color: colors.white, fontSize: 24 }}>Echo example</Text>
         <Button title="Start Recording" onPress={startEcho} />
         <Button title="Stop Recording" onPress={stopEcho} />
       </View>
       <View style={{ alignItems: 'center', justifyContent: 'center', gap: 5 }}>
-        <Text style={{ color: colors.white, fontSize: 24 }}>Record & replay example</Text>
+        <Text style={{ color: colors.white, fontSize: 24 }}>
+          Record & replay example
+        </Text>
         <Button title="Record for Replay" onPress={startRecordReplay} />
         <Button title="Replay" onPress={stopRecordReplay} />
       </View>

apps/fabric-example/ios/Podfile.lock

@@ -2243,7 +2243,7 @@ PODS:
     - React-perflogger (= 0.80.0)
     - React-utils (= 0.80.0)
     - SocketRocket
-  - RNAudioAPI (0.7.0):
+  - RNAudioAPI (0.7.1):
     - boost
     - DoubleConversion
     - fast_float
@@ -2270,10 +2270,10 @@ PODS:
     - ReactCodegen
     - ReactCommon/turbomodule/bridging
     - ReactCommon/turbomodule/core
-    - RNAudioAPI/audioapi (= 0.7.0)
+    - RNAudioAPI/audioapi (= 0.7.1)
     - SocketRocket
     - Yoga
-  - RNAudioAPI/audioapi (0.7.0):
+  - RNAudioAPI/audioapi (0.7.1):
     - boost
     - DoubleConversion
     - fast_float
@@ -2300,10 +2300,10 @@ PODS:
     - ReactCodegen
     - ReactCommon/turbomodule/bridging
     - ReactCommon/turbomodule/core
-    - RNAudioAPI/audioapi/ios (= 0.7.0)
+    - RNAudioAPI/audioapi/ios (= 0.7.1)
     - SocketRocket
     - Yoga
-  - RNAudioAPI/audioapi/ios (0.7.0):
+  - RNAudioAPI/audioapi/ios (0.7.1):
     - boost
     - DoubleConversion
     - fast_float

packages/audiodocs/docs/analysis/analyser-node.mdx

@@ -8,9 +8,9 @@ import { ReadOnly } from '@site/src/components/Badges';
 # AnalyserNode
 
 The `AnalyserNode` interface represents a node providing two core functionalities: extracting time-domain data and frequency-domain data from audio signals.
-It is an [`AudioNode`](/core/audio-node) that passes the audio data unchanged from input to output, but allows you to take passed data and process it.
+It is an [`AudioNode`](/docs/core/audio-node) that passes the audio data unchanged from input to output, but allows you to take passed data and process it.
 
-#### [`AudioNode`](/core/audio-node#read-only-properties) properties
+#### [`AudioNode`](/docs/core/audio-node#read-only-properties) properties
 
 <AudioNodePropsTable numberOfInputs={1} numberOfOutputs={1} channelCount={2} channelCountMode={"max"} channelInterpretation={"speakers"} />
 
@@ -23,17 +23,17 @@ In contrast, a frequency-domain graph reveals how the signal's energy or power i
 
 ## Constructor
 
-[`BaseAudioContext.createAnalyser()`](/core/base-audio-context#createanalyser)
+[`BaseAudioContext.createAnalyser()`](/docs/core/base-audio-context#createanalyser)
 
 ## Properties
 
 | Name | Type | Description | |
 | :----: | :----: | :-------- | :-: |
 | `fftSize` | `number` | Integer value representing size of [Fast Fourier Transform](https://en.wikipedia.org/wiki/Fast_Fourier_transform) used to determine frequency domain. In general it is size of returning time-domain data. |
-| `minDecibels` | `number` | Float value representing the minimum value for the range of results from [`getByteFrequencyData()`](/analysis/analyser-node#getbytefrequencydata). |
-| `maxDecibels` | `number` | Float value representing the maximum value for the range of results from [`getByteFrequencyData()`](/analysis/analyser-node#getbytefrequencydata). |
+| `minDecibels` | `number` | Float value representing the minimum value for the range of results from [`getByteFrequencyData()`](/docs/analysis/analyser-node#getbytefrequencydata). |
+| `maxDecibels` | `number` | Float value representing the maximum value for the range of results from [`getByteFrequencyData()`](/docs/analysis/analyser-node#getbytefrequencydata). |
 | `smoothingTimeConstant` | `number` | Float value representing averaging constant with the last analysis frame. In general the higher value the smoother is the transition between values over time. |
-| `window` | [`WindowType`](/types/window-type) | Enumerated value that specifies the type of window function applied when extracting frequency data. |
+| `window` | [`WindowType`](/docs/types/window-type) | Enumerated value that specifies the type of window function applied when extracting frequency data. |
 | `frequencyBinCount` | `number` | Integer value representing amount of the data obtained in frequency domain, half of the `fftSize` property. | <ReadOnly /> |
 
 :::caution
@@ -98,13 +98,13 @@ Each value in the array is within the range 0 to 255, where value of 127 indicat
 #### `minDecibels`
 - Default value is -100 dB.
 - 0 dB([decibel](https://en.wikipedia.org/wiki/Decibel)) is the loudest possible sound, -10 dB is a 10th of that.
-- When getting data from [`getByteFrequencyData()`](/analysis/analyser-node#getbytefrequencydata), any frequency with amplitude lower then `minDecibels` will be returned as 0.
+- When getting data from [`getByteFrequencyData()`](/docs/analysis/analyser-node#getbytefrequencydata), any frequency with amplitude lower then `minDecibels` will be returned as 0.
 - Throws `IndexSizeError` if set value is greater than or equal to `maxDecibels`.
 
 #### `maxDecibels`
 - Default value is -30 dB.
 - 0 dB([decibel](https://en.wikipedia.org/wiki/Decibel)) is the loudest possible sound, -10 dB is a 10th of that.
-- When getting data from [`getByteFrequencyData()`](/analysis/analyser-node#getbytefrequencydata), any frequency with amplitude higher then `maxDecibels` will be returned as 255.
+- When getting data from [`getByteFrequencyData()`](/docs/analysis/analyser-node#getbytefrequencydata), any frequency with amplitude higher then `maxDecibels` will be returned as 255.
 - Throws `IndexSizeError` if set value is less then or equal to `minDecibels`.
 
 #### `smoothingTimeConstant`

packages/audiodocs/docs/core/audio-context.mdx

@@ -4,14 +4,14 @@ sidebar_position: 2
 
 # AudioContext
 
-The `AudioContext` interface inherits from [`BaseAudioContext`](/core/base-audio-context).
+The `AudioContext` interface inherits from [`BaseAudioContext`](/docs/core/base-audio-context).
 It is responsible for supervising and managing audio-processing graph.
 
 ## Constructor
 
 `new AudioContext()`
 
-[`new AudioContext(options: AudioContextOptions)`](/core/audio-context#audiocontextoptions)
+[`new AudioContext(options: AudioContextOptions)`](/docs/core/audio-context#audiocontextoptions)
 
 #### Errors
 

packages/audiodocs/docs/core/audio-node.mdx

@@ -21,19 +21,19 @@ We usually represent the channels with the standard abbreviations detailed in th
 #### Mixing
 
 When node has more then one input or number of inputs channels differs from output up-mixing or down-mixing must be conducted.
-There are three properties involved in mixing process: `channelCount`, [`ChannelCountMode`](/types/channel-count-mode), [`ChannelInterpretation`](/types/channel-interpretation).
+There are three properties involved in mixing process: `channelCount`, [`ChannelCountMode`](/docs/types/channel-count-mode), [`ChannelInterpretation`](/docs/types/channel-interpretation).
 Based on them we can obtain output's number of channels and mixing strategy.
 
 ## Properties
 
 | Name | Type | Description | |
 | :----: | :----: | :-------- | :-: |
-| `context` | [`BaseAudioContext`](/core/base-audio-context) | Associated context. | <ReadOnly /> |
+| `context` | [`BaseAudioContext`](/docs/core/base-audio-context) | Associated context. | <ReadOnly /> |
 | `numberOfInputs` | `number` | Integer value representing the number of input connections for the node. | <ReadOnly /> |
 | `numberOfOutputs` | `number` | Integer value representing the number of output connections for the node. | <ReadOnly /> |
 | `channelCount` | `number` | Integer used to determine how many channels are used when up-mixing or down-mixing node's inputs. | <ReadOnly /> |
-| `channelCountMode` | [`ChannelCountMode`](/types/channel-count-mode) | Enumerated value that specifies the method by which channels are mixed between the node's inputs and outputs. | <ReadOnly /> |
-| `channelInterpretation` | [`ChannelInterpretation`](/types/channel-interpretation) | Enumerated value that specifies how input channels are mapped to output channels when number of them is different. | <ReadOnly /> |
+| `channelCountMode` | [`ChannelCountMode`](/docs/types/channel-count-mode) | Enumerated value that specifies the method by which channels are mixed between the node's inputs and outputs. | <ReadOnly /> |
+| `channelInterpretation` | [`ChannelInterpretation`](/docs/types/channel-interpretation) | Enumerated value that specifies how input channels are mapped to output channels when number of them is different. | <ReadOnly /> |
 
 ## Examples
 
@@ -89,7 +89,7 @@ The above method lets you connect one of the node's outputs to a destination.
 
 | Parameters | Type | Description |
 | :---: | :---: | :---- |
-| `destination` | [`AudioNode`](/core/audio-node) or [`AudioParam`](/core/audio-param) | `AudioNode` or `AudioParam` to which to connect. |
+| `destination` | [`AudioNode`](/docs/core/audio-node) or [`AudioParam`](/docs/core/audio-param) | `AudioNode` or `AudioParam` to which to connect. |
 
 #### Errors:
 
@@ -105,7 +105,7 @@ The above method lets you disconnect one or more nodes from the node.
 
 | Parameters | Type | Description |
 | :---: | :---: | :---- |
-| `destination` <Optional /> | [`AudioNode`](/core/audio-node) or [`AudioParam`](/core/audio-param) | `AudioNode` or `AudioParam` from which to disconnect. |
+| `destination` <Optional /> | [`AudioNode`](/docs/core/audio-node) or [`AudioParam`](/docs/core/audio-param) | `AudioNode` or `AudioParam` from which to disconnect. |
 
 If no arguments provided node disconnects from all outgoing connections.
 

packages/audiodocs/docs/core/audio-param.mdx

@@ -6,7 +6,7 @@ import { Optional, ReadOnly } from '@site/src/components/Badges';
 
 # AudioParam
 
-The `AudioParam` interface represents audio-related parameter (such as `gain` property of [GainNode`](/effects/gain-node)).
+The `AudioParam` interface represents audio-related parameter (such as `gain` property of [GainNode`](/docs/effects/gain-node)).
 It can be set to specific value or schedule value change to happen at specific time, and following specific pattern.
 
 #### a-rate vs k-rate
@@ -86,7 +86,7 @@ The change begins at the time designated for the previous event. It follows a ex
 ### `setTargetAtTime`
 
 The above method schedules a gradual change to the new value at the start time.
-This method is useful for decay or release portions of [ADSR envelopes](/effects/gain-node#envelope---adsr).
+This method is useful for decay or release portions of [ADSR envelopes](/docs/effects/gain-node#envelope---adsr).
 
 ![](/img/setTargetAtTime.png)
 
@@ -159,4 +159,4 @@ The above method cancels all scheduled changes after given cancel time, but hold
 
 ## Remarks
 
-All time parameters should be in the same time coordinate system as [`BaseAudioContext.currentTime`](/core/base-audio-context).
+All time parameters should be in the same time coordinate system as [`BaseAudioContext.currentTime`](/docs/core/base-audio-context).