Setting media track constraints.

问题场景

用户在 Gradio 的 Audio 组件中录音时，部分 Demo 用户反馈录音质量差，问题表现为随机出现、难以稳定复现。报告者尝试用纯 JavaScript 自制录音器，在试过若干 MediaTrackConstraints 组合后取得更好的效果，于是希望 Gradio 的 Python API 能接受这些约束参数，让 Demo 与自制录音器保持一致。

报错原文

Setting media track constraints.

该 Issue 本身是功能请求，正文没有贴出完整的浏览器异常堆栈，核心诉求即围绕 getUserMedia 的 MediaTrackConstraints 展开。

原因分析

可能原因是 Gradio 音频组件在调用 getUserMedia 时使用了默认的媒体轨道约束，没有把这些参数暴露给 Python 侧；当用户使用的录音设备（尤其是耳机）对默认约束更敏感时，录出来的音频质量会不稳定。报告者验证的有效配置为 {echoCancellation: false, noiseSuppression: false, autoGainControl: true}，但这个组合并非在所有场景都优于默认值，因此问题表现出随机性。

环境排查

• 确认当前安装的 Gradio 版本，是否包含 #13931 的改动；该 PR 合并进 7.0-dev，随 Gradio 7 发布。
• 确认触发问题的组件类型：Audio 组件（录音）或摄像头相关组件，两者都走 getUserMedia。
• 确认浏览器类型与版本，以及是否在多个操作系统、多台设备上复现。
• 确认录音设备类型，Issue 中明确指出使用耳机时在多个操作系统和设备上稳定复现。
• Issue 未提供 Python、CUDA、PyTorch、显卡等信息，这些与问题无直接关联，不必作为排查项。

解决步骤

1. 先升级或切换到包含 #13931 的 Gradio 版本（7.0-dev 及之后随 Gradio 7 发布的版本）。
2. 按报告者验证过的组合，尝试通过 Python API 传参：{echoCancellation: false, noiseSuppression: false, autoGainControl: true}。可优先尝试，因为这是 Issue 中被明确点名有效的配置，但仅在该场景下验证过。
3. 如果所用版本尚不支持直接传参，可参考官方自定义组件指南（Five Minute Guide），基于现有组件改造出一个可设置 getUserMedia 约束的社区组件；Issue 中维护者正是以此作为备选方向。
4. 若只是想让默认表现更好，可关注是否把上述约束合并进默认值，但 Issue 中明确提醒要验证不会在其他场景破坏音频质量。

验证方法

用同一副耳机、在之前能稳定复现的系统和设备上重新录音，对比设置约束前后的录音质量；同时换一组设备（例如不使用耳机）确认没有引入新的质量下降。由于原问题本身是随机出现的，建议多录几次再判断是否改善。

参考来源

gradio-app/gradio #5024

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。