源码学习——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控制音量,重点还是数据的处理,将数据进行了一次格式化,根据不同的声道处理数据。

相关推荐
Ankle7 分钟前
vue3 父子组件v-model传值方法总结
前端·vue.js
Liquidliang13 分钟前
用Claude Code构建AI创意工作流:连接nano banana与veo3
前端·aigc
半花13 分钟前
【Vue】defineProps直接和withDefaults设置默认值区别
前端·vue.js
游九尘14 分钟前
服务器都是用的iis, 前端部署后报跨域,不是用同一个服务器 是前端项目的服务器做Nginx转发,还是后端项目的服务器做Nginx转发?
服务器·前端·nginx
携欢17 分钟前
PortSwigger靶场之DOM XSS in jQuery selector sink using a hashchange event通关秘籍
前端·jquery·xss
Apifox30 分钟前
如何让 Apifox 发布的在线文档具备更好的调试体验?
前端·后端·测试
咔咔一顿操作33 分钟前
【CSS 3D 交互】打造沉浸式 3D 照片墙:结合 JS 实现拖拽交互
前端·javascript·css·3d·交互·css3
0x00035 分钟前
Uniapp - 自定义 Tabbar 实现
前端·uni-app
用户4582031531737 分钟前
Flexbox布局上手:10分钟告别垂直居中难题
前端·css
牛蛙点点申请出战38 分钟前
仿微信语音 WaveView 实现
android·前端·ios