mirror of
https://github.com/Boof2015/astra-mobile.git
synced 2026-08-12 05:10:52 +02:00
Boof2015
70 lines
3.0 KiB
TypeScript
70 lines
3.0 KiB
TypeScript
import { requireNativeModule, type NativeModule } from 'expo-modules-core';
|
|
|
|
/** Number of spectrum bins returned by getSpectrumFrame (fftSize/2, fftSize=2048). */
|
|
export const SPECTRUM_BINS = 1024;
|
|
|
|
/** Spectrum values are dB magnitudes in this range (silence ~ -100). */
|
|
export const SPECTRUM_DB_MIN = -100;
|
|
export const SPECTRUM_DB_MAX = 0;
|
|
|
|
/** Render-ready oscilloscope point count requested by the mobile UI. */
|
|
export const OSCILLOSCOPE_POINTS = 256;
|
|
|
|
declare class AstraScopeModuleType extends NativeModule {
|
|
/** Gate the audio-thread PCM tap. Off when backgrounded/paused/reduced-motion. */
|
|
setActive(active: boolean): void;
|
|
/**
|
|
* Fill `out` (length should be {@link SPECTRUM_BINS}) with the latest dB
|
|
* spectrum magnitudes in place; returns the number of bins written. Call once
|
|
* per render frame from the JS thread.
|
|
*/
|
|
getSpectrumFrame(out: Float32Array): number;
|
|
/**
|
|
* Fill `out` with render-ready, evenly spaced points from the latest
|
|
* pitch-locked oscilloscope window. Values are interpolated visual samples in
|
|
* ~[-1, 1]. Returns the number of points written (0 before warmup).
|
|
*/
|
|
getOscilloscopeFrame(out: Float32Array): number;
|
|
/** Gate the post-EQ tap (true only while the EQ screen is visible). */
|
|
setActivePostEq(active: boolean): void;
|
|
/**
|
|
* Like {@link getSpectrumFrame} but for the POST-EQ tap (ring #2) — feeds the
|
|
* EQ screen's spectrum behind the response curve. Returns bins written.
|
|
*/
|
|
getSpectrumFramePostEq(out: Float32Array): number;
|
|
|
|
// --- M4 EQ + per-track gain (params pushed from JS; biquad coeffs computed
|
|
// natively at the real stream sample rate) ---
|
|
|
|
/** Master EQ bypass. When false the EqAudioProcessor is passthrough. */
|
|
setEqEnabled(enabled: boolean): void;
|
|
/** EQ preamp as a linear amplitude (1 = unity). */
|
|
setEqPreamp(linear: number): void;
|
|
/**
|
|
* Flat band params: 5 values per band — [typeOrdinal, frequency, gain, Q,
|
|
* enabled?1:0]. Native recomputes biquad coefficients at the stream rate.
|
|
*/
|
|
setEqBands(params: number[]): void;
|
|
/** Glide the active normalization gain to an explicit linear value (1 = unity). */
|
|
setNormalizationGain(linear: number): void;
|
|
/**
|
|
* Register a queued track's gain by URL. The player switches the active gain to the
|
|
* matching entry natively at the media-item transition (no JS round-trip).
|
|
*/
|
|
setTrackGain(url: string, linear: number): void;
|
|
/**
|
|
* Bulk-register queued tracks' gains (url -> linear) in one bridge call. With
|
|
* `clearExisting` the native map is cleared first (bounds it to the live queue).
|
|
*/
|
|
setTrackGains(entries: Record<string, number>, clearExisting: boolean): void;
|
|
/** Glide to the registered gain for this URL now (mount/settings/late measurement). */
|
|
activateTrackGain(url: string): void;
|
|
/**
|
|
* Conservative temp gain (linear) applied when a media-item transition hits a URL
|
|
* with no registered gain (unanalyzed track). Keep at 1 while normalization is off.
|
|
*/
|
|
setFallbackGain(linear: number): void;
|
|
}
|
|
|
|
export const AstraScope = requireNativeModule<AstraScopeModuleType>('AstraScope');
|