react-native-audio-api 0.4.13 → 0.5.0

package/src/core/AudioBuffer.ts

@@ -17,7 +17,7 @@ export default class AudioBuffer {
     this.numberOfChannels = buffer.numberOfChannels;
   }
 
-  public getChannelData(channel: number): number[] {
+  public getChannelData(channel: number): Float32Array {
     if (channel < 0 || channel >= this.numberOfChannels) {
       throw new IndexSizeError(
         `The channel number provided (${channel}) is outside the range [0, ${this.numberOfChannels - 1}]`
@@ -27,7 +27,7 @@ export default class AudioBuffer {
   }
 
   public copyFromChannel(
-    destination: number[],
+    destination: Float32Array,
     channelNumber: number,
     startInChannel: number = 0
   ): void {
@@ -47,7 +47,7 @@ export default class AudioBuffer {
   }
 
   public copyToChannel(
-    source: number[],
+    source: Float32Array,
     channelNumber: number,
     startInChannel: number = 0
   ): void {

package/src/core/AudioBufferSourceNode.ts

@@ -4,7 +4,6 @@ import BaseAudioContext from './BaseAudioContext';
 import AudioBuffer from './AudioBuffer';
 import AudioParam from './AudioParam';
 import { InvalidStateError, RangeError } from '../errors';
-import { TimeStretchType } from '../types';
 
 export default class AudioBufferSourceNode extends AudioScheduledSourceNode {
   readonly playbackRate: AudioParam;
@@ -58,14 +57,6 @@ export default class AudioBufferSourceNode extends AudioScheduledSourceNode {
     (this.node as IAudioBufferSourceNode).loopEnd = value;
   }
 
-  public get timeStretch(): TimeStretchType {
-    return (this.node as IAudioBufferSourceNode).timeStretch;
-  }
-
-  public set timeStretch(value: TimeStretchType) {
-    (this.node as IAudioBufferSourceNode).timeStretch = value;
-  }
-
   public start(when: number = 0, offset: number = 0, duration?: number): void {
     if (when < 0) {
       throw new RangeError(

package/src/core/AudioParam.ts

@@ -85,7 +85,7 @@ export default class AudioParam {
   }
 
   public setValueCurveAtTime(
-    values: number[],
+    values: Float32Array,
     startTime: number,
     duration: number
   ): AudioParam {

package/src/core/BaseAudioContext.ts

@@ -1,5 +1,9 @@
 import { IBaseAudioContext } from '../interfaces';
-import { ContextState, PeriodicWaveConstraints } from '../types';
+import {
+  ContextState,
+  PeriodicWaveConstraints,
+  AudioBufferSourceNodeOptions,
+} from '../types';
 import AudioDestinationNode from './AudioDestinationNode';
 import OscillatorNode from './OscillatorNode';
 import GainNode from './GainNode';
@@ -46,8 +50,15 @@ export default class BaseAudioContext {
     return new BiquadFilterNode(this, this.context.createBiquadFilter());
   }
 
-  createBufferSource(): AudioBufferSourceNode {
-    return new AudioBufferSourceNode(this, this.context.createBufferSource());
+  createBufferSource(
+    options?: AudioBufferSourceNodeOptions
+  ): AudioBufferSourceNode {
+    const pitchCorrection = options?.pitchCorrection ?? false;
+
+    return new AudioBufferSourceNode(
+      this,
+      this.context.createBufferSource(pitchCorrection)
+    );
   }
 
   createBuffer(
@@ -79,8 +90,8 @@ export default class BaseAudioContext {
   }
 
   createPeriodicWave(
-    real: number[],
-    imag: number[],
+    real: Float32Array,
+    imag: Float32Array,
     constraints?: PeriodicWaveConstraints
   ): PeriodicWave {
     if (real.length !== imag.length) {
@@ -110,4 +121,10 @@ export default class BaseAudioContext {
       await this.context.decodeAudioDataSource(sourcePath)
     );
   }
+
+  async decodeAudioData(arrayBuffer: ArrayBuffer): Promise<AudioBuffer> {
+    return new AudioBuffer(
+      await this.context.decodeAudioData(new Uint8Array(arrayBuffer))
+    );
+  }
 }

package/src/core/BiquadFilterNode.ts

@@ -28,9 +28,9 @@ export default class BiquadFilterNode extends AudioNode {
   }
 
   public getFrequencyResponse(
-    frequencyArray: number[],
-    magResponseOutput: number[],
-    phaseResponseOutput: number[]
+    frequencyArray: Float32Array,
+    magResponseOutput: Float32Array,
+    phaseResponseOutput: Float32Array
   ) {
     if (
       frequencyArray.length !== magResponseOutput.length ||

package/src/interfaces.ts

@@ -5,7 +5,6 @@ import {
   ChannelCountMode,
   ChannelInterpretation,
   WindowType,
-  TimeStretchType,
 } from './types';
 
 export interface AudioAPIInstaller {
@@ -22,19 +21,20 @@ export interface IBaseAudioContext {
   createGain(): IGainNode;
   createStereoPanner(): IStereoPannerNode;
   createBiquadFilter: () => IBiquadFilterNode;
-  createBufferSource: () => IAudioBufferSourceNode;
+  createBufferSource: (pitchCorrection: boolean) => IAudioBufferSourceNode;
   createBuffer: (
     channels: number,
     length: number,
     sampleRate: number
   ) => IAudioBuffer;
   createPeriodicWave: (
-    real: number[],
-    imag: number[],
+    real: Float32Array,
+    imag: Float32Array,
     disableNormalization: boolean
   ) => IPeriodicWave;
   createAnalyser: () => IAnalyserNode;
   decodeAudioDataSource: (sourcePath: string) => Promise<IAudioBuffer>;
+  decodeAudioData: (arrayBuffer: ArrayBuffer) => Promise<IAudioBuffer>;
 }
 
 export interface IAudioContext extends IBaseAudioContext {
@@ -71,9 +71,9 @@ export interface IBiquadFilterNode extends IAudioNode {
   type: BiquadFilterType;
 
   getFrequencyResponse(
-    frequencyArray: number[],
-    magResponseOutput: number[],
-    phaseResponseOutput: number[]
+    frequencyArray: Float32Array,
+    magResponseOutput: Float32Array,
+    phaseResponseOutput: Float32Array
   ): void;
 }
 
@@ -100,7 +100,6 @@ export interface IAudioBufferSourceNode extends IAudioScheduledSourceNode {
   loopEnd: number;
   detune: IAudioParam;
   playbackRate: IAudioParam;
-  timeStretch: TimeStretchType;
 
   start: (when?: number, offset?: number, duration?: number) => void;
 }
@@ -111,14 +110,14 @@ export interface IAudioBuffer {
   readonly sampleRate: number;
   readonly numberOfChannels: number;
 
-  getChannelData(channel: number): number[];
+  getChannelData(channel: number): Float32Array;
   copyFromChannel(
-    destination: number[],
+    destination: Float32Array,
     channelNumber: number,
     startInChannel: number
   ): void;
   copyToChannel(
-    source: number[],
+    source: Float32Array,
     channelNumber: number,
     startInChannel: number
   ): void;
@@ -139,7 +138,7 @@ export interface IAudioParam {
     timeConstant: number
   ) => void;
   setValueCurveAtTime: (
-    values: number[],
+    values: Float32Array,
     startTime: number,
     duration: number
   ) => void;
@@ -157,8 +156,8 @@ export interface IAnalyserNode extends IAudioNode {
   smoothingTimeConstant: number;
   window: WindowType;
 
-  getFloatFrequencyData: (array: number[]) => void;
-  getByteFrequencyData: (array: number[]) => void;
-  getFloatTimeDomainData: (array: number[]) => void;
-  getByteTimeDomainData: (array: number[]) => void;
+  getFloatFrequencyData: (array: Float32Array) => void;
+  getByteFrequencyData: (array: Uint8Array) => void;
+  getFloatTimeDomainData: (array: Float32Array) => void;
+  getByteTimeDomainData: (array: Uint8Array) => void;
 }

package/src/types.ts

@@ -31,4 +31,6 @@ export interface AudioContextOptions {
 
 export type WindowType = 'blackman' | 'hann';
 
-export type TimeStretchType = 'linear' | 'speech-music';
+export interface AudioBufferSourceNodeOptions {
+  pitchCorrection: boolean;
+}

package/src/utils/index.ts

@@ -0,0 +1,3 @@
+export function clamp(value: number, min: number, max: number): number {
+  return Math.min(Math.max(value, min), max);
+}

package/src/web-core/AnalyserNode.tsx

@@ -29,41 +29,19 @@ export default class AnalyserNode extends AudioNode {
     );
   }
 
-  public getByteFrequencyData(array: number[]): void {
-    const data = new Uint8Array(array);
-
-    (this.node as globalThis.AnalyserNode).getByteFrequencyData(data);
-
-    for (let i = 0; i < array.length; i++) {
-      array[i] = data[i];
-    }
+  public getByteFrequencyData(array: Uint8Array): void {
+    (this.node as globalThis.AnalyserNode).getByteFrequencyData(array);
   }
 
-  public getByteTimeDomainData(array: number[]): void {
-    const data = new Uint8Array(array);
-
-    (this.node as globalThis.AnalyserNode).getByteTimeDomainData(data);
-
-    for (let i = 0; i < array.length; i++) {
-      array[i] = data[i];
-    }
+  public getByteTimeDomainData(array: Uint8Array): void {
+    (this.node as globalThis.AnalyserNode).getByteTimeDomainData(array);
   }
 
-  public getFloatFrequencyData(array: number[]): void {
-    const data = new Float32Array(array);
-    (this.node as globalThis.AnalyserNode).getFloatFrequencyData(data);
-
-    for (let i = 0; i < array.length; i++) {
-      array[i] = data[i];
-    }
+  public getFloatFrequencyData(array: Float32Array): void {
+    (this.node as globalThis.AnalyserNode).getFloatFrequencyData(array);
   }
 
-  public getFloatTimeDomainData(array: number[]): void {
-    const data = new Float32Array(array);
-    (this.node as globalThis.AnalyserNode).getFloatTimeDomainData(data);
-
-    for (let i = 0; i < array.length; i++) {
-      array[i] = data[i];
-    }
+  public getFloatTimeDomainData(array: Float32Array): void {
+    (this.node as globalThis.AnalyserNode).getFloatTimeDomainData(array);
   }
 }

package/src/web-core/AudioBuffer.tsx

@@ -28,7 +28,7 @@ export default class AudioBuffer {
   }
 
   public copyFromChannel(
-    destination: number[],
+    destination: Float32Array,
     channelNumber: number,
     startInChannel: number = 0
   ): void {
@@ -44,17 +44,11 @@ export default class AudioBuffer {
       );
     }
 
-    const array = new Float32Array(destination);
-
-    this.buffer.copyFromChannel(array, channelNumber, startInChannel);
-
-    for (let i = 0; i < destination.length; i++) {
-      destination[i] = array[i];
-    }
+    this.buffer.copyFromChannel(destination, channelNumber, startInChannel);
   }
 
   public copyToChannel(
-    source: number[],
+    source: Float32Array,
     channelNumber: number,
     startInChannel: number = 0
   ): void {
@@ -70,10 +64,6 @@ export default class AudioBuffer {
       );
     }
 
-    this.buffer.copyToChannel(
-      new Float32Array(source),
-      channelNumber,
-      startInChannel
-    );
+    this.buffer.copyToChannel(source, channelNumber, startInChannel);
   }
 }