javascript - typescript 网络音频 API 缺少定义

Question

我有兴趣开始在我的一些项目中使用 Typescript。现在我想使用 Web Audio API 使用麦克风作为输入流源进行一些实时音频处理。我在 Visual Studio 2015 中工作，因为我将使用 ASP.NET 5。

我正在这样定义我的音频上下文:var audioCtx: AudioContext;

它的工作原理是 AudioContext 定义存在于位于 A:\Program\Microsoft Visual Studio 14.0\Common7\IDE\CommonExtensions\Microsoft\TypeScript 的 lib.d.ts 文件中

尽管当我稍后尝试使用 audioCtx.createMediaStreamSource(stream)时，我在尝试转译 TS 代码时遇到错误，它告诉我 Property "createMediaStreamSource"does not exist在类型“AudioContext”上。

这个错误似乎是正确的，因为这是使用的 lib.d.ts 文件的内容:

interface AudioContext extends EventTarget {
    currentTime: number;
    destination: AudioDestinationNode;
    listener: AudioListener;
    sampleRate: number;
    createAnalyser(): AnalyserNode;
    createBiquadFilter(): BiquadFilterNode;
    createBuffer(numberOfChannels: number, length: number, sampleRate: number): AudioBuffer;
    createBufferSource(): AudioBufferSourceNode;
    createChannelMerger(numberOfInputs?: number): ChannelMergerNode;
    createChannelSplitter(numberOfOutputs?: number): ChannelSplitterNode;
    createConvolver(): ConvolverNode;
    createDelay(maxDelayTime?: number): DelayNode;
    createDynamicsCompressor(): DynamicsCompressorNode;
    createGain(): GainNode;
    createMediaElementSource(mediaElement: HTMLMediaElement): MediaElementAudioSourceNode;
    createOscillator(): OscillatorNode;
    createPanner(): PannerNode;
    createPeriodicWave(real: any, imag: any): PeriodicWave;
    createScriptProcessor(bufferSize?: number, numberOfInputChannels?: number, numberOfOutputChannels?: number): ScriptProcessorNode;
    createStereoPanner(): StereoPannerNode;
    createWaveShaper(): WaveShaperNode;
    decodeAudioData(audioData: ArrayBuffer, successCallback: DecodeSuccessCallback, errorCallback?: DecodeErrorCallback): void;
}

所以我想知道的是，是否有办法为音频 API 获得更“完整”的定义？这样我至少可以使用大部分可用的函数和对象。

我不想自己添加定义，所以我宁愿使用标准的 ES5。但我认为，如果 Web Audio API 没有更完整的 TS 定义，那将是相当奇怪的，因为它已经存在了几年(尽管它仍然不时发生一些变化)。

Answer 1

lib.d.ts 定义倾向于遵循标准的当前 Microsoft 实现，并随着 Microsoft 添加对新方面的支持而增长。有时这意味着它领先于其他浏览器，有时则落后于其他浏览器。在 Mozilla 引入新想法的地方，他们当然会在实现方面领先于其他所有人，并且设备 API 是他们最喜欢的主题，因为它们与 Firefox OS 高度相关。

没有太多遗漏，您可以使用以下内容插入遗漏的部分。当您需要删除以下任何内容时，编译器会通过给您一个“重复标识符”错误来告诉您:

interface MediaStream {
    id: string;
    active: boolean;
}

interface MediaStreamAudioSourceNode extends AudioNode {
    
}

interface MediaStreamAudioDestinationNode extends AudioNode {
    stream: MediaStream;
}

interface AudioContext {
    state: string;
    close: () => void;
    createMediaStreamSource: () => MediaStreamAudioSourceNode;
    createMediaStreamDestination: () => any;
    resume: () => void;
    suspend: () => void;
}

MediaStream 与 MDN 文档一样完整 - 请注意这一点，因为似乎对该对象的成员的浏览器支持最少。