源码学习——pcm-player

前言

最近做需求用到了pcm-player插件,当时翻了一下源码,简单清晰,入手级别的源码学习,下面我们就来学习pcm-player源码。

pcm-player

pcm-player是一款简单的pcm数据流播放器,用法很简单,传入配置项初始化实例,然后用feed方法播放语音流,我们在github上打开pcm-player找到src文件夹,里面就是功能源码。

ts声明文件

首先我们来看下ts声明文件,这里面包含着参数类型,能够帮助我们理解源码,感觉作者正在用ts重构源码,因为下面方法还是用js写的。我们从上往下阅读声明文件,declare module声明文件/模块的语法,然后定义了几个接口,最后是定义了一个类。

接口option就是初始化的配置项,包括四个参数与两个函数,下面定义的类就是核心功能,整个文件我们需要注意两个类型:

  • AudioContext:Audio相关的API,播放就是通过原生API实现的。
  • typedArrays接口: 类型化数据类型,跟pcm流的编码格式相关,也就是我们传入的数据格式,只接受定义的四种格式。

init

从定义的类我们知道定义的公共方法有五个:

  • feed:播放语音流。
  • volumn:控制音量。
  • destory:销毁实例。
  • pause:暂停播放。
  • continue:继续播放。
    我们就从这个方法入手阅读源码,第一步是我们找到init 方法。
  1. 初始化配置项:init接收一个option可选参数,函数中定义了defaultOption默认配置项,用Object.assign合并传入的参数。
  2. 根据配置项赋值:interval表示缓存播放,具体时间由配置项flushTime 决定。convertValue表示编码位数,typedArray表示具体的二进制数据,这两个都由配置项中的inputCodec 决定。
  3. 初始化音频:intiAudioContext用来初始化音频上下文,bindAudioContextEvent用来绑定音频事件,AudioContext可以控制音频处理解码等执行。具体由new AudioContext创建实例,实例的createGain 方法用于控制音量,而绑定事件由onstatechange 方法控制。 以上就是init的大致过程,interval的时候会执行flush 函数,这个函数我们不能忽略,该函数包含了录音播放的逻辑,首先使用createBufferSource 创建一个播放源bufferSource,通过createBuffer创建audioBuffer,将audio数据填入到audioBuffer,将数据赋值给bufferSource的buffer,用bufferSource.connect 连接音量,最后用bufferSource.start播放。

feed

init之后,接下来就是feed方法,该方法接收一个data数据。在flush函数中数据来源是samples 变量,feed主要是将我们传过来的数据处理赋值给samples。

  1. 数据校验,校验传入的数据是否符合ArrayBuffer或TypedArray。
  2. 格式化数据,对于闯入的数据都会用Float32Array重新拷贝一份,然后赋值给samples进行播放。最终格式化的缓冲区数据都在-1到1之间。

其他

剩下的方法就非常简单,通过调用实例化的方法或赋值控制。

  • volumn控制音量:音量是通过gainNode控制,接收的参数直接赋值给value。
js 复制代码
volume(volume) {
this.gainNode.gain.value = volume
}
  • destroy:销毁实例,将涉及到的变量赋值为null,interval用clearInterval,audioCtx用close方法。
  • pause、continue:暂停与继续就是调用audioCtx相关方法,suspend ------暂停,resume ------继续。

总结

pcm-player就是通过AudioContext播放录音数据,gainNode控制音量,重点还是数据的处理,将数据进行了一次格式化,根据不同的声道处理数据。

相关推荐
兆子龙7 分钟前
Node.js ESM Loader Hooks 介绍:用 module.register 做转译、Import Map 与自定义解析
前端
四眼肥鱼8 分钟前
flutter 利用flutter_libserialport 实现SQ800 串口通信
前端·flutter
ZFSS8 分钟前
OpenAI Images Edits API 申请及使用
前端·人工智能
Lee川20 分钟前
从零构建AI对话应用:Vite脚手架搭建与API密钥安全实践
前端·程序员
允许部分打工人先富起来22 分钟前
在node项目中执行python脚本
前端·python·node.js
钟智强22 分钟前
Flutter引擎Android平台JNI层未验证指针转换漏洞
前端
骑着小黑马27 分钟前
Electron + Vue3 + AI 做了一个新闻生成器:从 0 到 1 的完整实战记录
前端·人工智能
Sailing29 分钟前
LLM 调用从 60s 卡死降到 3s!彻底绕过 tiktoken 网络阻塞(LangChain.js 必看)
前端·langchain·llm
洋洋技术笔记29 分钟前
计算属性与侦听器
前端·vue.js
用户8144869581129 分钟前
“马上”有惊喜:在 Rokid 灵珠平台上构建 FPS 级 AR 红包雷达应用
前端