react-native-audio-api/lib/module/system/AudioManager.js

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

"use strict";

import { AudioEventEmitter } from "../events/index.js";
import { NativeAudioAPIModule } from "../specs/index.js";
import { parseNativeError } from "./errors.js";
class AudioManager {
  constructor() {
    this.audioEventEmitter = new AudioEventEmitter(globalThis.AudioEventEmitter);
  }
  getDevicePreferredSampleRate() {
    return NativeAudioAPIModule.getDevicePreferredSampleRate();
  }

  /**
   * Activates or deactivates the audio session.
   *
   * Resolves when the session activity was set successfully. On failure it
   * rejects with a {@link SessionActivationError} carrying the native error
   * details (`nativeErrorInfo`) when available.
   */
  async setAudioSessionActivity(enabled) {
    try {
      await NativeAudioAPIModule.setAudioSessionActivity(enabled);
    } catch (error) {
      throw parseNativeError(error);
    }
  }
  setAudioSessionOptions(options) {
    NativeAudioAPIModule.setAudioSessionOptions(options.iosCategory ?? '', options.iosMode ?? '', options.iosOptions ?? [], options.iosAllowHaptics ?? false, options.iosNotifyOthersOnDeactivation ?? true);
  }
  disableSessionManagement() {
    NativeAudioAPIModule.disableSessionManagement();
  }
  observeAudioInterruptions(param) {
    if (typeof param === 'string') {
      NativeAudioAPIModule.observeAudioInterruptions(param, true);
    } else {
      // audiofocusgain as default value if not provided
      NativeAudioAPIModule.observeAudioInterruptions('gain', param === true);
    }
  }

  /**
   * @param enabled - Whether to actively reclaim the session or not
   * @experimental more aggressively try to reactivate the audio session during interruptions.
   * It is subject to change in the future and might be removed.
   *
   * In some cases (depends on app session settings and other apps using audio) system may never
   * send the `interruption ended` event. This method will check if any other audio is playing
   * and try to reactivate the audio session, as soon as there is "silence".
   * Although this might change the expected behavior.
   *
   * Internally method uses `AVAudioSessionSilenceSecondaryAudioHintNotification` as well as
   * interval polling to check if other audio is playing.
   */
  activelyReclaimSession(enabled) {
    NativeAudioAPIModule.activelyReclaimSession(enabled);
  }
  observeVolumeChanges(enabled) {
    NativeAudioAPIModule.observeVolumeChanges(enabled);
  }
  addSystemEventListener(name, callback) {
    return this.audioEventEmitter.addAudioEventListener(name, callback);
  }
  async requestRecordingPermissions() {
    return NativeAudioAPIModule.requestRecordingPermissions();
  }
  async checkRecordingPermissions() {
    return NativeAudioAPIModule.checkRecordingPermissions();
  }
  async requestNotificationPermissions() {
    return NativeAudioAPIModule.requestNotificationPermissions();
  }
  async checkNotificationPermissions() {
    return NativeAudioAPIModule.checkNotificationPermissions();
  }
  async getDevicesInfo() {
    return NativeAudioAPIModule.getDevicesInfo();
  }

  /**
   * Selects the given device as the current audio input.
   *
   * Resolves when the input device was set successfully and rejects when the
   * device cannot be found or the system fails to switch to it.
   */
  async setInputDevice(deviceId) {
    await NativeAudioAPIModule.setInputDevice(deviceId);
  }
}
export default new AudioManager();
//# sourceMappingURL=AudioManager.js.map