@javascriptcommon/react-native-track-player 1.2.9 → 4.1.4

package/package.json

@@ -1,7 +1,40 @@
 {
   "name": "@javascriptcommon/react-native-track-player",
-  "version": "1.2.9",
+  "version": "4.1.4",
   "description": "A fully fledged audio module created for music apps",
+  "main": "lib/src/index.js",
+  "types": "lib/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "scripts": {
+    "build": "rimraf lib && tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src",
+    "format": "prettier --write src",
+    "types": "tsc --noEmit true",
+    "prepare": "yarn build",
+    "example": "yarn --cwd example",
+    "pods": "cd example/ios && pod install",
+    "bootstrap": "yarn example && yarn && yarn pods",
+    "version": "yarn format && git add -A src && yarn changelog && git add CHANGELOG.md",
+    "postversion": "if [[ ${npm_package_version} != *'nightly'* ]]; then yarn publish:git && yarn publish:npm; fi",
+    "ci:lint": "eslint src --max-warnings=0",
+    "ci:format": "prettier --check src",
+    "changelog": "conventional-changelog -p angular -s -i CHANGELOG.md -r 1",
+    "publish:git": "git push && git push --tags",
+    "publish:npm": "yarn prepare && npm publish --access public"
+  },
+  "files": [
+    "src",
+    "lib/**/*",
+    "ios/**/*",
+    "android/src/**/*",
+    "android/build.gradle",
+    "android/proguard-rules.txt",
+    "web/**/*",
+    "*.podspec",
+    "specs"
+  ],
   "contributors": [
     {
       "name": "David Chavez",
@@ -12,6 +45,10 @@
       "name": "Guilherme Chaguri",
       "email": "guichaguri@gmail.com",
       "url": "http://guichaguri.com"
+    },
+    {
+      "name": "Dustin Bahr",
+      "email": "dustin@curiousmedia.com"
     }
   ],
   "keywords": [
@@ -37,11 +74,53 @@
   "bugs": {
     "url": "https://github.com/doublesymmetry/react-native-track-player/issues"
   },
-  "scripts": {
-    "prepublishOnly": "git submodule update --init --recursive"
+  "codegenConfig": {
+    "name": "NativeTrackPlayerSpec",
+    "type": "modules",
+    "jsSrcsDir": "specs",
+    "android": {
+      "javaPackageName": "com.doublesymmetry.trackplayer"
+    },
+    "ios": {
+      "modulesProvider": {
+        "TrackPlayer": "NativeTrackPlayer"
+      }
+    }
   },
   "peerDependencies": {
-    "react": ">=16.8.6",
-    "react-native": ">=0.60.0-rc.2"
-  }
+    "react": "*",
+    "react-native": "*",
+    "react-native-windows": "*",
+    "shaka-player": "^4.7.9"
+  },
+  "peerDependenciesMeta": {
+    "react-native-windows": {
+      "optional": true
+    },
+    "shaka-player": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@react-native-community/cli": "20.0.0",
+    "@react-native/babel-preset": "0.81.1",
+    "@types/react": "^19.1.0",
+    "del-cli": "^5.1.0",
+    "react": "19.1.0",
+    "react-native": "0.81.1",
+    "shaka-player": "^4.15.4",
+    "typescript": "^5.8.3"
+  },
+  "funding": "https://github.com/doublesymmetry/react-native-track-player?sponsor=1",
+  "config": {
+    "commitizen": {
+      "path": "cz-conventional-changelog"
+    }
+  },
+  "tea": {
+    "dependencies": {
+      "classic.yarnpkg.com": "^1"
+    }
+  },
+  "packageManager": "yarn@1.22.19+sha1.4ba7fc5c6e704fce2066ecbfb0b0d8976fe62447"
 }

package/react-native-track-player.podspec

@@ -3,20 +3,20 @@ require "json"
 package = JSON.parse(File.read(File.join(__dir__, "package.json")))
 
 Pod::Spec.new do |s|
-  s.name         = "react-native-track-player"
-  s.version      = package["version"]
-  s.summary      = package['description']
-  s.license      = package['license']
+  s.name = package["name"]
+  s.version = package["version"]
+  s.summary = package["description"]
+  s.license = package["license"]
 
-  s.author       = "David Chavez"
-  s.homepage     = package['repository']['url']
-  s.platform     = { :ios => "11.0", :tvos => "11.0" }
+  s.author = "David Chavez"
+  s.homepage = package["repository"]["url"]
+  s.platform = :ios, "11.0"
 
-  s.ios.deployment_target = "11.0"
-  s.tvos.deployment_target = "11.0"
+  s.source = { :git => package["repository"]["url"], :tag => "v#{s.version}" }
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+  s.exclude_files = [ 'ios/Example', 'ios/SwiftAudioEx/Package.swift' ]
 
-  s.source       = { :git => package['repository']['url'], :tag => "v#{s.version}" }
-  s.source_files  = "ios/**/*.{h,m,swift}"
-
-  s.dependency "React-Core"
+  s.swift_version = "4.2"
+  
+  install_modules_dependencies(s)
 end

package/specs/NativeTrackPlayer.ts

@@ -0,0 +1,153 @@
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+import { type UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
+
+export interface Spec extends TurboModule {
+  // init and config
+  setupPlayer(options: UnsafeObject, background: boolean): Promise<void>;
+  updateOptions(options: UnsafeObject): Promise<void>;
+
+  // player api
+  load(track: UnsafeObject): Promise<number | void>;
+  reset(): Promise<void>;
+  play(): Promise<void>;
+  pause(): Promise<void>;
+  stop(): Promise<void>;
+  setPlayWhenReady(playWhenReady: boolean): Promise<boolean>;
+  getPlayWhenReady(): Promise<boolean>;
+  seekTo(position: number): Promise<void>;
+  seekBy(offset: number): Promise<void>;
+  setVolume(level: number): Promise<void>;
+  getVolume(): Promise<number>;
+  setRate(rate: number): Promise<void>;
+  getRate(): Promise<number>;
+  getProgress(): Promise<UnsafeObject>;
+  getPlaybackState(): Promise<UnsafeObject>;
+  retry(): Promise<void>;
+
+  // playlist management
+  add(
+    tracks: UnsafeObject[],
+    insertBeforeIndex: number,
+  ): Promise<number | void>;
+  move(fromIndex: number, toIndex: number): Promise<void>;
+  remove(indexes: number[]): Promise<void>;
+  removeUpcomingTracks(): Promise<void>;
+  skip(index: number, initialPosition: number): Promise<void>;
+  skipToNext(initialPosition: number): Promise<void>;
+  skipToPrevious(initialPosition: number): Promise<void>;
+  updateMetadataForTrack(
+    trackIndex: number,
+    metadata: UnsafeObject,
+  ): Promise<void>;
+  updateNowPlayingMetadata(metadata: UnsafeObject): Promise<void>;
+  setQueue(tracks: UnsafeObject[]): Promise<void>;
+  getQueue(): Promise<UnsafeObject[]>;
+  setRepeatMode(mode: number): Promise<number>;
+  getRepeatMode(): Promise<number>;
+  getTrack(index: number): Promise<UnsafeObject | undefined>;
+  getActiveTrackIndex(): Promise<number | undefined>;
+  getActiveTrack(): Promise<UnsafeObject | undefined>;
+  setBrowseTree(browseTree: UnsafeObject): Promise<string>;
+  setPlaybackState(mediaID: string): Promise<void>;
+  setBrowseTreeStyle(
+    browsableStyle: number,
+    playableStyle: number,
+  ): Promise<void>;
+  setSearchResults(searchResults: UnsafeObject[]): Promise<void>;
+  crossFadePrepare(previous: boolean, seekTo?: number): Promise<void>;
+  switchExoPlayer(
+    fadeDuration: number,
+    fadeInterval: number,
+    fadeToVolume: number,
+    waitUntil?: number,
+  ): Promise<void>;
+  getLastConnectedPackage(): Promise<string | undefined>;
+  setLoudnessEnhance(gain: number): Promise<void>;
+  setEqualizerPreset(preset: number): Promise<void>;
+  getCurrentEqualizerPreset(): Promise<number>;
+  getEqualizerPresets(): Promise<string[]>;
+
+  // event listeners
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
+
+  // constants
+  getConstants: () => {
+    CAPABILITY_PLAY: number;
+    CAPABILITY_PLAY_FROM_ID: number;
+    CAPABILITY_PLAY_FROM_SEARCH: number;
+    CAPABILITY_PAUSE: number;
+    CAPABILITY_STOP: number;
+    CAPABILITY_SEEK_TO: number;
+    CAPABILITY_SKIP: number;
+    CAPABILITY_SKIP_TO_NEXT: number;
+    CAPABILITY_SKIP_TO_PREVIOUS: number;
+    CAPABILITY_SET_RATING: number;
+    CAPABILITY_JUMP_FORWARD: number;
+    CAPABILITY_JUMP_BACKWARD: number;
+    CAPABILITY_LIKE: number;
+    CAPABILITY_DISLIKE: number;
+    CAPABILITY_BOOKMARK: number;
+
+    // States
+    STATE_NONE: string;
+    STATE_READY: string;
+    STATE_PLAYING: string;
+    STATE_PAUSED: string;
+    STATE_STOPPED: string;
+    STATE_BUFFERING: string;
+    STATE_LOADING: string;
+
+    // Rating Types
+    RATING_HEART: number;
+    RATING_THUMBS_UP_DOWN: number;
+    RATING_3_STARS: number;
+    RATING_4_STARS: number;
+    RATING_5_STARS: number;
+    RATING_PERCENTAGE: number;
+
+    // Repeat Modes
+    REPEAT_OFF: number;
+    REPEAT_TRACK: number;
+    REPEAT_QUEUE: number;
+
+    PITCH_ALGORITHM_LINEAR: number;
+    PITCH_ALGORITHM_MUSIC: number;
+    PITCH_ALGORITHM_VOICE: number;
+  };
+
+  // android methods
+
+  acquireWakeLock(): Promise<void>;
+  abandonWakeLock(): Promise<void>;
+  setAnimatedVolume(
+    volume: number,
+    duration: number,
+    interval: number,
+    msg: string,
+  ): Promise<void>;
+  fadeOutPause(duration: number, interval: number): Promise<void>;
+  fadeOutNext(
+    duration: number,
+    interval: number,
+    toVolume: number,
+  ): Promise<void>;
+  fadeOutPrevious(
+    duration: number,
+    interval: number,
+    toVolume: number,
+  ): Promise<void>;
+  fadeOutJump(
+    index: number,
+    duration: number,
+    interval: number,
+    toVolume: number,
+  ): Promise<void>;
+  setPitch(pitch: number): Promise<void>;
+  getPitch(): Promise<number>;
+}
+
+const module = TurboModuleRegistry.getEnforcing<Spec>('TrackPlayer');
+export const Constants = module?.getConstants();
+export default module;

package/src/TrackPlayerModule.web.ts

@@ -0,0 +1,2 @@
+import TrackPlayerModule from '../web';
+export default TrackPlayerModule;

package/src/VideoView.tsx

@@ -0,0 +1,51 @@
+import React from 'react';
+import {
+  StyleProp,
+  ViewStyle,
+  requireNativeComponent,
+  Platform,
+} from 'react-native';
+
+interface VideoViewProps {
+  /**
+   * Style object that will be applied to the underlying native video view.
+   */
+  style?: StyleProp<ViewStyle>;
+  /**
+   * How the video should be resized to fit its container. On iOS this maps to
+   * AVLayerVideoGravity, on Android to ExoPlayer's resize mode.
+   * Defaults to "contain" (AspectFit).
+   */
+  resizeMode?: 'contain' | 'cover' | 'stretch' | 'none';
+}
+
+/**
+ * VideoView is a convenience component that synchronises a <Video> component
+ * with the currently playing track from react-native-track-player.
+ *
+ * It will automatically:
+ * 1. Render nothing when the current track does not expose a video source.
+ * 2. Pause/resume playback based on TrackPlayer's playback state.
+ *
+ * This makes it trivial to embed alongside your existing audio UI:
+ *
+ * ```tsx
+ * <VideoView style={{ width: 300, height: 200 }} />
+ * ```
+ */
+const NativeVideoView = requireNativeComponent<VideoViewProps>(
+  Platform.select({
+    ios: 'RNTrackPlayerVideoView',
+    android: 'RNTrackPlayerVideoView',
+    default: 'RNTrackPlayerVideoView',
+  }) as string
+);
+
+export const VideoView: React.FC<VideoViewProps> = ({
+  style,
+  resizeMode = 'contain',
+}: VideoViewProps) => {
+  return <NativeVideoView style={style} resizeMode={resizeMode} />;
+};
+
+export default VideoView;

package/src/constants/AndroidAudioContentType.ts

@@ -0,0 +1,35 @@
+export enum AndroidAudioContentType {
+  /**
+   * Content type value to use when the content type is music.
+   *
+   * See https://developer.android.com/reference/android/media/AudioAttributes#CONTENT_TYPE_MUSIC
+   */
+  Music = 'music',
+  /**
+   * Content type value to use when the content type is speech.
+   *
+   * See https://developer.android.com/reference/android/media/AudioAttributes#CONTENT_TYPE_SPEECH
+   */
+  Speech = 'speech',
+  /**
+   * Content type value to use when the content type is a sound used to
+   * accompany a user action, such as a beep or sound effect expressing a key
+   * click, or event, such as the type of a sound for a bonus being received in
+   * a game. These sounds are mostly synthesized or short Foley sounds.
+   *
+   * See https://developer.android.com/reference/android/media/AudioAttributes#CONTENT_TYPE_SONIFICATION
+   */
+  Sonification = 'sonification',
+  /**
+   * Content type value to use when the content type is a soundtrack, typically
+   * accompanying a movie or TV program.
+   */
+  Movie = 'movie',
+  /**
+   * Content type value to use when the content type is unknown, or other than
+   * the ones defined.
+   *
+   * See https://developer.android.com/reference/android/media/AudioAttributes#CONTENT_TYPE_UNKNOWN
+   */
+  Unknown = 'unknown',
+}

package/src/constants/AndroidAutoContentStyle.ts

@@ -0,0 +1,10 @@
+/**
+ * Define Android Auto's content style. defualt is List. see
+ * https://developer.android.com/training/cars/media#apply_content_style
+ */
+export enum AndroidAutoContentStyle {
+  List = 0,
+  Grid = 1,
+  CategoryList = 2,
+  CategoryGrid = 3,
+}

package/src/constants/AppKilledPlaybackBehavior.ts

@@ -0,0 +1,19 @@
+/**
+ * Define how the audio playback should behave to removing the app from recents (killing it). Default is `ContinuePlayback`.
+ */
+export enum AppKilledPlaybackBehavior {
+  /**
+   * This option will continue playing audio in the background when the app is removed from recents. The notification remains. This is the default.
+   */
+  ContinuePlayback = 'continue-playback',
+
+  /**
+   * This option will pause playing audio in the background when the app is removed from recents. The notification remains and can be used to resume playback.
+   */
+  PausePlayback = 'pause-playback',
+
+  /**
+   * This option will stop playing audio in the background when the app is removed from recents. The notification is removed and can't be used to resume playback. Users would need to open the app again to start playing audio.
+   */
+  StopPlaybackAndRemoveNotification = 'stop-playback-and-remove-notification',
+}

package/src/constants/Capability.ts

@@ -0,0 +1,19 @@
+import {Constants as TrackPlayer} from '../../specs/NativeTrackPlayer';
+
+export enum Capability {
+  Play = TrackPlayer.CAPABILITY_PLAY,
+  PlayFromId = TrackPlayer.CAPABILITY_PLAY_FROM_ID,
+  PlayFromSearch = TrackPlayer.CAPABILITY_PLAY_FROM_SEARCH,
+  Pause = TrackPlayer.CAPABILITY_PAUSE,
+  Stop = TrackPlayer.CAPABILITY_STOP,
+  SeekTo = TrackPlayer.CAPABILITY_SEEK_TO,
+  Skip = TrackPlayer.CAPABILITY_SKIP,
+  SkipToNext = TrackPlayer.CAPABILITY_SKIP_TO_NEXT,
+  SkipToPrevious = TrackPlayer.CAPABILITY_SKIP_TO_PREVIOUS,
+  JumpForward = TrackPlayer.CAPABILITY_JUMP_FORWARD,
+  JumpBackward = TrackPlayer.CAPABILITY_JUMP_BACKWARD,
+  SetRating = TrackPlayer.CAPABILITY_SET_RATING,
+  Like = TrackPlayer.CAPABILITY_LIKE,
+  Dislike = TrackPlayer.CAPABILITY_DISLIKE,
+  Bookmark = TrackPlayer.CAPABILITY_BOOKMARK,
+}

package/src/constants/Event.ts

@@ -0,0 +1,173 @@
+export enum Event {
+  PlayerError = 'player-error',
+
+  /** Fired when the state of the player changes. */
+  PlaybackState = 'playback-state',
+  /** Fired when a playback error occurs. */
+  PlaybackError = 'playback-error',
+  /** (Android Only) Fired when animated volume completed changing. */
+  PlaybackAnimatedVolumeChanged = 'playback-animated-volume-changed',
+  /** Fired after playback has paused due to the queue having reached the end. */
+  PlaybackQueueEnded = 'playback-queue-ended',
+  /**
+   * Fired when another track has become active or when there no longer is an
+   * active track.
+   *
+   * @deprecated use `playback-active-track-changed` instead.
+   **/
+  PlaybackTrackChanged = 'playback-track-changed',
+  /**
+   * Fired when another track has become active or when there no longer is an
+   * active track.
+   **/
+  PlaybackActiveTrackChanged = 'playback-active-track-changed',
+  /**
+   * Fired when the current track receives metadata encoded in. (e.g. ID3 tags,
+   * Icy Metadata, Vorbis Comments or QuickTime metadata).
+   * @deprecated use `AudioChapterMetadataReceived, AudioTimedMetadataReceived, AudioCommonMetadataReceived` instead.
+   **/
+  PlaybackMetadataReceived = 'playback-metadata-received',
+  /**
+   * Fired when playback play when ready has changed.
+   **/
+  PlaybackPlayWhenReadyChanged = 'playback-play-when-ready-changed',
+  /**
+   * Fired when playback progress has been updated.
+   * See https://rntp.dev/docs/api/events#playbackprogressupdated
+   **/
+  PlaybackProgressUpdated = 'playback-progress-updated',
+  /**
+   * Android media3 playback resumption. most likely require a
+   * headless setup.
+   */
+  PlaybackResume = 'playback-resume-android',
+  /**
+   * Fired when the user presses the play button.
+   * See https://rntp.dev/docs/api/events#remoteplay
+   **/
+  RemotePlay = 'remote-play',
+  /**
+   * Fired when the user presses the play/pause button.
+   **/
+  RemotePlayPause = 'remote-play-pause',
+  /**
+   * Fired when the user presses the pause button.
+   * See https://rntp.dev/docs/api/events#remotepause
+   **/
+  RemotePause = 'remote-pause',
+  /**
+   * Fired when the user presses the stop button.
+   * See https://rntp.dev/docs/api/events#remotestop
+   **/
+  RemoteStop = 'remote-stop',
+  /**
+   * Fired when the user presses the next track button.
+   * See https://rntp.dev/docs/api/events#remotenext
+   **/
+  RemoteNext = 'remote-next',
+  /**
+   * Fired when the user presses the previous track button.
+   * See https://rntp.dev/docs/api/events#remoteprevious
+   **/
+  RemotePrevious = 'remote-previous',
+  /**
+   * Fired when the user presses the jump forward button.
+   * See https://rntp.dev/docs/api/events#remotejumpforward
+   **/
+  RemoteJumpForward = 'remote-jump-forward',
+  /**
+   * Fired when the user presses the jump backward button.
+   * See https://rntp.dev/docs/api/events#remotejumpbackward
+   **/
+  RemoteJumpBackward = 'remote-jump-backward',
+  /**
+   * Fired when the user changes the position of the timeline.
+   * See https://rntp.dev/docs/api/events#remoteseek
+   **/
+  RemoteSeek = 'remote-seek',
+  /**
+   * Fired when the user changes the rating for the track remotely.
+   * See https://rntp.dev/docs/api/events#remotesetrating
+   **/
+  RemoteSetRating = 'remote-set-rating',
+  /**
+   * Fired when the app needs to handle an audio interruption.
+   * See https://rntp.dev/docs/api/events#remoteduck
+   **/
+  RemoteDuck = 'remote-duck',
+  /**
+   * (iOS only) Fired when the user presses the like button in the now playing
+   * center.
+   * See https://rntp.dev/docs/api/events#remotelike-ios-only
+   **/
+  RemoteLike = 'remote-like',
+  /**
+   * (iOS only) Fired when the user presses the dislike button in the now playing
+   * center.
+   * See https://rntp.dev/docs/api/events#remotedislike-ios-only
+   **/
+  RemoteDislike = 'remote-dislike',
+  /** (iOS only) Fired when the user presses the bookmark button in the now
+   * playing center.
+   * See https://rntp.dev/docs/api/events#remotebookmark-ios-only
+   **/
+  RemoteBookmark = 'remote-bookmark',
+  /**
+   * (Android only) Fired when the user selects a track from an external device.
+   * See https://rntp.dev/docs/api/events#remoteplayid
+   **/
+  RemotePlayId = 'remote-play-id',
+  /**
+   * (Android only) Fired when the user searches for a track (usually voice search).
+   * See https://rntp.dev/docs/api/events#remoteplaysearch
+   **/
+  RemotePlaySearch = 'remote-play-search',
+  /**
+   * (Android only) Fired when the user searches for content.
+   * See https://rntp.dev/docs/api/events#remotesearch
+   **/
+  RemoteSearch = 'remote-search',
+  /**
+   * (Android only) Fired when the user presses the skip button.
+   * See https://rntp.dev/docs/api/events#remoteskip
+   **/
+  RemoteSkip = 'remote-skip',
+  /**
+   * (Android only) Fired when the user enters a browsable children in android auto.
+   * See https://rntp.dev/docs/api/events#remoteBrowse
+   **/
+  RemoteBrowse = 'remote-browse',
+  /**
+   * (Android only) Fired when a custom action button is pressed.
+   * See https://rntp.dev/docs/api/events#remoteCustomAction
+   **/
+  RemoteCustomAction = 'remote-custom-action',
+  /** (iOS only) Fired when chapter metadata is received.
+   * See https://rntp.dev/docs/api/events#chaptermetadatareceived
+   **/
+  MetadataChapterReceived = 'metadata-chapter-received',
+  /**
+   * Fired when metadata is received at a specific time in the audio.
+   * See https://rntp.dev/docs/api/events#timedmetadatareceived
+   **/
+  MetadataTimedReceived = 'metadata-timed-received',
+  /**
+   * Fired when common (static) metadata is received.
+   * See https://rntp.dev/docs/api/events#commonmetadatareceived
+   **/
+  MetadataCommonReceived = 'metadata-common-received',
+  /**
+   * Fired when an android connector connects to MusicService.
+   * typical controllers are media notification and Android Auto.
+   **/
+  connectorConnected = 'android-controller-connected',
+  /**
+   * Fired when an android connector connects to MusicService.
+   * typical controllers are media notification and Android Auto.
+   **/
+  connectorDisconnected = 'android-controller-disconnected',
+  /**
+   * Fired when there is an fft update
+   **/
+  fftUpdate = 'fft-updated',
+}

package/src/constants/IOSCategory.ts

@@ -0,0 +1,36 @@
+export enum IOSCategory {
+  /**
+   * The category for playing recorded music or other sounds that are central
+   * to the successful use of your app.
+   * See https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616509-playback
+   **/
+  Playback = 'playback',
+  /**
+   * The category for recording (input) and playback (output) of audio, such as
+   * for a Voice over Internet Protocol (VoIP) app.
+   * See https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616568-playandrecord
+   **/
+  PlayAndRecord = 'playAndRecord',
+  /**
+   * The category for routing distinct streams of audio data to different
+   * output devices at the same time.
+   * See https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616484-multiroute
+   **/
+  MultiRoute = 'multiRoute',
+  /**
+   * The category for an app in which sound playback is nonprimary — that is,
+   * your app also works with the sound turned off.
+   * See https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616560-ambient
+   **/
+  Ambient = 'ambient',
+  /**
+   * The default audio session category.
+   * See https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616488-soloambient
+   **/
+  SoloAmbient = 'soloAmbient',
+  /**
+   * The category for recording audio while also silencing playback audio.
+   * See https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616451-record
+   **/
+  Record = 'record',
+}