XSound - v4.2.0
    Preparing search index...

    Interface MediaModule

    This class processes sound data from HTMLMediaElement. Namely, this class enables to create audio player that has higher features from HTMLMediaElement. But, this class is disadvantage to play many one shot audios. In that case, developer should use OneshotModule.

    interface MediaModule {
        analyser: Analyser;
        autopanner: Autopanner;
        bitcrusher: BitCrusher;
        chorus: Chorus;
        compressor: Compressor;
        context: AudioContext;
        delay: Delay;
        destination: AudioDestinationNode | MediaStreamAudioDestinationNode;
        envelopegenerator: EnvelopeGenerator;
        equalizer: Equalizer;
        filter: Filter;
        flanger: Flanger;
        fuzz: Fuzz;
        listener: Listener;
        mastervolume: GainNode;
        mixed: boolean;
        modules: Connectable[];
        noisegate: NoiseGate;
        noisesuppressor: NoiseSuppressor;
        overdrive: OverDrive;
        panner: Panner;
        phaser: Phaser;
        pitchshifter: PitchShifter;
        preamp: Preamp;
        processor: AudioWorkletNode;
        recorder: Recorder;
        reverb: Reverb;
        ringmodulator: Ringmodulator;
        runningAnalyser: boolean;
        stereo: Stereo;
        tremolo: Tremolo;
        vocalcanceler: VocalCanceler;
        wah: Wah;
        get INPUT(): AudioWorkletNode;
        get OUTPUT(): GainNode;
        audioDestination(): MediaModule;
        connect(source: AudioNode): void;
        demix(): MediaModule;
        disconnect(): void;
        edit(modules: Connectable[]): Connectable[];
        exitPictureInPicture(): Promise<void>;
        fadeIn(time?: number): number | MediaModule;
        fadeOut(time?: number): number | MediaModule;
        get(): MediaElementAudioSourceNode | null;
        hasMedia(): boolean;
        hasSource(): boolean;
        init(context: AudioContext): void;
        install<ExtendedEffector extends Effector>(
            effector: new (context: AudioContext) => ExtendedEffector,
        ): ExtendedEffector;
        mix(): MediaModule;
        module(moduleName: "analyser"): Analyser;
        module(moduleName: "recorder"): Recorder;
        module(moduleName: "autopanner"): Autopanner;
        module(moduleName: "bitcrusher"): BitCrusher;
        module(moduleName: "chorus"): Chorus;
        module(moduleName: "compressor"): Compressor;
        module(moduleName: "delay"): Delay;
        module(moduleName: "envelopegenerator"): EnvelopeGenerator;
        module(moduleName: "equalizer"): Equalizer;
        module(moduleName: "filter"): Filter;
        module(moduleName: "flanger"): Flanger;
        module(moduleName: "fuzz"): Fuzz;
        module(moduleName: "listener"): Listener;
        module(moduleName: "noisegate"): NoiseGate;
        module(moduleName: "noisesuppressor"): NoiseSuppressor;
        module(moduleName: "overdrive"): OverDrive;
        module(moduleName: "panner"): Panner;
        module(moduleName: "phaser"): Phaser;
        module(moduleName: "pitchshifter"): PitchShifter;
        module(moduleName: "preamp"): Preamp;
        module(moduleName: "reverb"): Reverb;
        module(moduleName: "ringmodulator"): Ringmodulator;
        module(moduleName: "stereo"): Stereo;
        module(moduleName: "tremolo"): Tremolo;
        module(moduleName: "vocalcanceler"): VocalCanceler;
        module(moduleName: "wah"): Wah;
        off(stopTime?: number): MediaModule;
        on(startTime?: number): MediaModule;
        param(params: "mastervolume"): number;
        param(params: "autoplay"): boolean;
        param(params: "playbackRate"): number;
        param(params: "currentTime"): number;
        param(params: "controls"): boolean;
        param(params: "loop"): boolean;
        param(params: "muted"): boolean;
        param(params: "duration"): boolean;
        param(params: "duration"): boolean;
        param(params: MediaModuleParams): MediaModule;
        params(): Required<MediaModuleParams>;
        paused(): boolean;
        ready(src: string, mimeType?: string): MediaModule;
        requestPictureInPicture(): Promise<PictureInPictureWindow>;
        setSinkId(
            sinkId: string,
            successCallback?: () => void,
            errorCallback?: (error: Error) => void,
        ): MediaModule;
        setup(
            params: {
                autoplay?: boolean;
                formats?: string[];
                listeners?: { [eventType: string]: (event: Event | Error) => void };
                media: HTMLAudioElement | HTMLVideoElement;
            },
        ): MediaModule;
        start(
            position?: number,
            errorCallback?: (error: Error) => void,
        ): MediaModule;
        stop(
            successCallback?: () => void,
            errorCallback?: (error: Error) => void,
        ): MediaModule;
        streamDestination(
            params?: {
                errorCallback?: (error: Error) => void;
                sinkId: string;
                successCallback?: () => void;
            },
        ): MediaModule;
        suspend(): MediaModule;
        toJSON(): string;
    }

    Hierarchy (View Summary)

    Index

    Properties

    analyser autopanner bitcrusher chorus compressor context delay destination envelopegenerator equalizer filter flanger fuzz listener mastervolume mixed modules noisegate noisesuppressor overdrive panner phaser pitchshifter preamp processor recorder reverb ringmodulator runningAnalyser stereo tremolo vocalcanceler wah

    Accessors

    INPUT OUTPUT

    Methods

    audioDestination connect demix disconnect edit exitPictureInPicture fadeIn fadeOut get hasMedia hasSource init install mix module off on param params paused ready requestPictureInPicture setSinkId setup start stop streamDestination suspend toJSON

    Properties

    analyser: Analyser
    autopanner: Autopanner
    bitcrusher: BitCrusher
    chorus: Chorus
    compressor: Compressor
    context: AudioContext
    delay: Delay
    destination: AudioDestinationNode | MediaStreamAudioDestinationNode
    envelopegenerator: EnvelopeGenerator
    equalizer: Equalizer
    filter: Filter
    flanger: Flanger
    fuzz: Fuzz
    listener: Listener
    mastervolume: GainNode
    mixed: boolean = false
    modules: Connectable[] = []
    noisegate: NoiseGate
    noisesuppressor: NoiseSuppressor
    overdrive: OverDrive
    panner: Panner
    phaser: Phaser
    pitchshifter: PitchShifter
    preamp: Preamp
    processor: AudioWorkletNode
    recorder: Recorder
    reverb: Reverb
    ringmodulator: Ringmodulator
    runningAnalyser: boolean = false
    stereo: Stereo
    tremolo: Tremolo
    vocalcanceler: VocalCanceler
    wah: Wah

    Accessors

    Methods

    • This method connects AudioNodes.

      Parameters

      • source: AudioNode

        This argument is AudioNode as sound source.

      Returns void

    • This method exits from Picture In Picture (PIP).

      Returns Promise<void>

      Return value is Promise.

    • This method gets or sets fade-in time.

      Parameters

      • Optionaltime: number

        This argument is fade-in time. If this argument is omitted, this method is getter.

      Returns number | MediaModule

      Return value is fade-in time. Otherwise, return value is for method chain.

    • This method gets or sets fade-out time.

      Parameters

      • Optionaltime: number

        This argument is fade-out time. If this argument is omitted, this method is getter.

      Returns number | MediaModule

      Return value is fade-out time. Otherwise, return value is for method chain.

    • This method gets instance of MediaElementAudioSourceNode.

      Returns MediaElementAudioSourceNode | null

    • This method determines whether instance of HTMLMediaElement exists.

      Returns boolean

      If instance of HTMLMediaElement already exists, this value is true. Otherwise, this value is false.

    • This method determines whether instance of MediaElementAudioSourceNode exists.

      Returns boolean

      If instance of MediaElementAudioSourceNode already exists, this value is true. Otherwise, this value is false.

    • This method re-initials modules.

      Parameters

      • context: AudioContext

        This argument is in order to use Web Audio API.

      Returns void

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "analyser"

        This argument selects module.

      Returns Analyser

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "recorder"

        This argument selects module.

      Returns Recorder

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "autopanner"

        This argument selects module.

      Returns Autopanner

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "bitcrusher"

        This argument selects module.

      Returns BitCrusher

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "chorus"

        This argument selects module.

      Returns Chorus

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "compressor"

        This argument selects module.

      Returns Compressor

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "delay"

        This argument selects module.

      Returns Delay

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "envelopegenerator"

        This argument selects module.

      Returns EnvelopeGenerator

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "equalizer"

        This argument selects module.

      Returns Equalizer

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "filter"

        This argument selects module.

      Returns Filter

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "flanger"

        This argument selects module.

      Returns Flanger

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "fuzz"

        This argument selects module.

      Returns Fuzz

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "listener"

        This argument selects module.

      Returns Listener

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "noisegate"

        This argument selects module.

      Returns NoiseGate

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "noisesuppressor"

        This argument selects module.

      Returns NoiseSuppressor

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "overdrive"

        This argument selects module.

      Returns OverDrive

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "panner"

        This argument selects module.

      Returns Panner

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "phaser"

        This argument selects module.

      Returns Phaser

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "pitchshifter"

        This argument selects module.

      Returns PitchShifter

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "preamp"

        This argument selects module.

      Returns Preamp

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "reverb"

        This argument selects module.

      Returns Reverb

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "ringmodulator"

        This argument selects module.

      Returns Ringmodulator

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "stereo"

        This argument selects module.

      Returns Stereo

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "tremolo"

        This argument selects module.

      Returns Tremolo

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "vocalcanceler"

        This argument selects module.

      Returns VocalCanceler

    • This method gets instance of Module (Analyser, Recorder, Effector ... etc).

      Parameters

      • moduleName: "wah"

        This argument selects module.

      Returns Wah

    • This method gets or sets parameters for media module. This method is overloaded for type interface and type check.

      Parameters

      • params: "mastervolume"

        This argument is string if getter. Otherwise, setter.

      Returns number

      Return value is parameter for media module if getter. Otherwise, return value is for method chain.

    • This method gets or sets parameters for media module. This method is overloaded for type interface and type check.

      Parameters

      • params: "autoplay"

        This argument is string if getter. Otherwise, setter.

      Returns boolean

      Return value is parameter for media module if getter. Otherwise, return value is for method chain.

    • This method gets or sets parameters for media module. This method is overloaded for type interface and type check.

      Parameters

      • params: "playbackRate"

        This argument is string if getter. Otherwise, setter.

      Returns number

      Return value is parameter for media module if getter. Otherwise, return value is for method chain.

    • This method gets or sets parameters for media module. This method is overloaded for type interface and type check.

      Parameters

      • params: "currentTime"

        This argument is string if getter. Otherwise, setter.

      Returns number

      Return value is parameter for media module if getter. Otherwise, return value is for method chain.

    • This method gets or sets parameters for media module. This method is overloaded for type interface and type check.

      Parameters

      • params: "controls"

        This argument is string if getter. Otherwise, setter.

      Returns boolean

      Return value is parameter for media module if getter. Otherwise, return value is for method chain.

    • This method gets or sets parameters for media module. This method is overloaded for type interface and type check.

      Parameters

      • params: "loop"

        This argument is string if getter. Otherwise, setter.

      Returns boolean

      Return value is parameter for media module if getter. Otherwise, return value is for method chain.

    • This method gets or sets parameters for media module. This method is overloaded for type interface and type check.

      Parameters

      • params: "muted"

        This argument is string if getter. Otherwise, setter.

      Returns boolean

      Return value is parameter for media module if getter. Otherwise, return value is for method chain.

    • This method gets or sets parameters for media module. This method is overloaded for type interface and type check.

      Parameters

      • params: "duration"

        This argument is string if getter. Otherwise, setter.

      Returns boolean

      Return value is parameter for media module if getter. Otherwise, return value is for method chain.

    • This method gets or sets parameters for media module. This method is overloaded for type interface and type check.

      Parameters

      • params: "duration"

        This argument is string if getter. Otherwise, setter.

      Returns boolean

      Return value is parameter for media module if getter. Otherwise, return value is for method chain.

    • This method gets or sets parameters for media module. This method is overloaded for type interface and type check.

      Parameters

      Returns MediaModule

      Return value is parameter for media module if getter. Otherwise, return value is for method chain.

    • This method determines whether media is paused.

      Returns boolean

      If media is paused, this value is true. Otherwise, this value is false.

    • This method prepares for playing media anytime after loading media resource.

      Parameters

      • src: string

        This argument is Object URL or file name for media resource.

      • OptionalmimeType: string

        This argument is required in case of audio streaming.

      Returns MediaModule

      Return value is for method chain.

    • This method requests Picture In Picture (PIP).

      Returns Promise<PictureInPictureWindow>

      Return value is Promise.

    • This method enables to use multiple output devices.

      Parameters

      • sinkId: string

        This argument is string as output device ID.

      • OptionalsuccessCallback: () => void

        This argument is invoked on success.

      • OptionalerrorCallback: (error: Error) => void

        This argument is invoked on failure.

      Returns MediaModule

      Return value is for method chain.

    • This method gets HTMLMediaElement and selects media format. In addition, this method adds event listeners that are defined by HTMLMediaElement.

      Parameters

      • params: {
            autoplay?: boolean;
            formats?: string[];
            listeners?: { [eventType: string]: (event: Event | Error) => void };
            media: HTMLAudioElement | HTMLVideoElement;
        }

      Returns MediaModule

      Return value is for method chain.

    • This method starts media from designated time.

      Parameters

      • Optionalposition: number

        This argument is time that media is started at. The default value is 0.

      • OptionalerrorCallback: (error: Error) => void

        This argument is invoked on failure.

      Returns MediaModule

      Return value is for method chain.

    • This method stops media.

      Parameters

      • OptionalsuccessCallback: () => void

        This argument is invoked on success.

      • OptionalerrorCallback: (error: Error) => void

        This argument is invoked on failure.

      Returns MediaModule

      Return value is for method chain.

    • This method switches destination over to MediaStreamAudioDestinationNode.

      Parameters

      • Optionalparams: {
            errorCallback?: (error: Error) => void;
            sinkId: string;
            successCallback?: () => void;
        }

      Returns MediaModule

      Return value is for method chain.

    Settings

    Member Visibility

    On This Page

    Properties
    Accessors
    Methods