react-native-audio-api/src/core/AudioBufferQueueSourceNode.ts

react-native-audio-api provides system for controlling audio in React Native environment compatible with Web Audio API specification

import { IAudioBufferQueueSourceNode } from '../jsi-interfaces';
import AudioBufferBaseSourceNode from './AudioBufferBaseSourceNode';
import AudioBuffer from './AudioBuffer';
import { RangeError } from '../errors';
import type BaseAudioContext from './BaseAudioContext';
import { BaseAudioBufferSourceOptions } from '../types';
import { OnBufferEndEventType } from '../events/types';

export default class AudioBufferQueueSourceNode extends AudioBufferBaseSourceNode {
  private onBufferEndedCallback?: (event: OnBufferEndEventType) => void;

  constructor(
    context: BaseAudioContext,
    options?: BaseAudioBufferSourceOptions
  ) {
    const node = context.context.createBufferQueueSource(options || {});
    super(context, node);
  }

  public enqueueBuffer(buffer: AudioBuffer): string {
    return (this.node as IAudioBufferQueueSourceNode).enqueueBuffer(
      buffer.buffer
    );
  }

  public dequeueBuffer(bufferId: string): void {
    const id = parseInt(bufferId, 10);
    if (isNaN(id) || id < 0) {
      throw new RangeError(
        `bufferId must be a non-negative integer: ${bufferId}`
      );
    }
    (this.node as IAudioBufferQueueSourceNode).dequeueBuffer(id);
  }

  public clearBuffers(): void {
    (this.node as IAudioBufferQueueSourceNode).clearBuffers();
  }

  public override start(when: number = 0, offset: number = -1): void {
    if (when < 0) {
      throw new RangeError(
        `when must be a finite non-negative number: ${when}`
      );
    }

    if (offset && offset < 0) {
      throw new RangeError(
        `offset must be a finite non-negative number: ${offset}`
      );
    }

    (this.node as IAudioBufferQueueSourceNode).start(when, offset);
  }

  public override stop(when: number = 0): void {
    if (when < 0) {
      throw new RangeError(
        `when must be a finite non-negative number: ${when}`
      );
    }

    (this.node as IAudioBufferQueueSourceNode).stop(when);
  }

  public get onBufferEnded():
    | ((event: OnBufferEndEventType) => void)
    | undefined {
    return this.onBufferEndedCallback;
  }

  public set onBufferEnded(
    callback: ((event: OnBufferEndEventType) => void) | null
  ) {
    if (!callback) {
      (this.node as IAudioBufferQueueSourceNode).onBufferEnded = '0';
      this.onBufferEndedCallback = undefined;
      return;
    }

    this.onBufferEndedCallback = callback;
    const sub = this.audioEventEmitter.addAudioEventListener(
      'bufferEnded',
      callback
    );

    (this.node as IAudioBufferQueueSourceNode).onBufferEnded =
      sub.subscriptionId;
  }

  public pause(): void {
    (this.node as IAudioBufferQueueSourceNode).pause();
  }
}