webMUSHRA: 基于Web Audio API的MUSHRA兼容听力实验软件安装与使用教程-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00970/article/details/142808300

webMUSHRA: 基于Web Audio API的MUSHRA兼容听力实验软件安装与使用教程

webMUSHRA a MUSHRA compliant web audio API based experiment software 项目地址: https://gitcode.com/gh_mirrors/we/webMUSHRA

1. 项目目录结构及介绍

webMUSHRA项目遵循清晰的结构设计，便于开发者和研究者快速理解与定制。下面是主要的目录及其简要介绍：

configs: 存放所有实验配置文件。每个.yaml文件定义了一个具体的实验设置，支持MUSHRA、AB测试等。
design: 若存在，通常存放项目的设计文档或界面元素，但在给出的链接中未直接显示详细内容。
doc: 包含项目相关的技术文档，帮助用户理解项目原理和使用方法。
lib: 第三方库或者自定义的JavaScript库，用于实现项目的功能。
res/spatial: 可能存储与空间音频特性相关的资源或数据。
results: 实验结果通常保存的地方，虽然实际运行时可能由服务器处理。
service: 后端服务相关文件，如果项目包含客户端与服务端交互的话，这里可能存放API或处理脚本。
tests: 单元测试或集成测试文件，确保代码质量。
基本文件如gitignore, Dockerfile, Gruntfile.js, LICENSE.txt, README.md, AUTHORS.md, package-lock.json, package.json, startup.js等，分别负责忽略特定文件、容器化部署、构建流程管理、许可协议、项目介绍、作者信息、依赖锁定、基础包配置、启动脚本等关键项目元数据。

2. 项目启动文件介绍

启动主要入口未直接指明一个特定的“启动文件”，但依据说明，若通过PHP内置服务器进行本地开发，通过命令行执行php -S localhost:8000后，访问http://localhost:8000即可启动应用。从实践角度看，启动过程涉及到配置文件的调用而非单一的可执行文件。
关键运行脚本在开发环境下，可能需要关注的是前端JavaScript入口文件，虽然具体路径未提供，常见于lib或根目录下以main.js、app.js等形式存在，但在webMUSHRA中，启动的关键在于正确的URL参数和后台服务（如PHP服务）的配合。

3. 项目的配置文件介绍

配置文件格式：webMUSHRA使用YAML作为配置文件的格式，文件一般位于configs/目录下。这些.yaml文件定义了实验的类型（如MUSHRA、AB测试）、参考信号、刺激信号列表、以及是否展示波形图等详细参数。

示例配置：

pages:
  - type: mushra
    id: Item 1
    name: Orchestra
    content: "Add additional notes for the participants"
    showWaveform: true
    reference: reference.wav
    stimuli:
      C1: codec1.wav
      C2: codec2.wav
      C3: codec3.wav