Streamlit Audio Recorder 项目常见问题解决方案-CSDN博客

本文链接：https://blog.csdn.net/gitblog_01247/article/details/143048354

Streamlit Audio Recorder 项目常见问题解决方案

streamlit-audio-recorder Record Audio from the User's Microphone in Apps that are Deployed to the Web. (via Browser Media-API, REACT-based, Streamlit Custom Component) 项目地址: https://gitcode.com/gh_mirrors/st/streamlit-audio-recorder

项目基础介绍

Streamlit Audio Recorder 是一个基于 Streamlit 的音频录制组件，允许用户在部署到 Web 的应用程序中通过浏览器的 Media-API 录制音频。该项目主要使用 TypeScript、Python、HTML、CSS 和 JavaScript 进行开发。

主要编程语言

TypeScript: 29.5%
Python: 28.5%
HTML: 18.3%
CSS: 12.6%
JavaScript: 11.1%

新手使用注意事项及解决方案

1. 安装依赖时出现版本冲突

问题描述: 在安装 streamlit-audiorec 组件时，可能会遇到与其他已安装库的版本冲突问题。

解决步骤:

检查依赖版本: 首先，检查当前环境中已安装的库版本，确保它们与 streamlit-audiorec 兼容。
使用虚拟环境: 建议使用虚拟环境（如 venv 或 conda）来隔离项目依赖，避免全局环境中的版本冲突。
手动安装依赖: 如果自动安装失败，可以尝试手动安装依赖库，并指定兼容版本。

pip install streamlit-audiorec

2. 音频录制无响应或无声音

问题描述: 在应用程序中使用 st_audiorec 组件时，可能会遇到录制无响应或录制后无声音的问题。

解决步骤:

检查浏览器权限: 确保浏览器允许访问麦克风权限。可以在浏览器的设置中检查并授予权限。
更新组件版本: 检查 streamlit-audiorec 是否有新版本发布，更新到最新版本可能修复已知问题。
调试代码: 在代码中添加调试信息，检查 st_audiorec 返回的音频数据是否为空或异常。

wav_audio_data = st_audiorec()
if wav_audio_data is not None:
    st.audio(wav_audio_data, format='audio/wav')
else:
    st.error("音频数据为空，请检查录制权限或浏览器设置。")

3. 音频文件无法下载或保存

问题描述: 录制完成后，用户无法下载或保存录制的音频文件。

解决步骤:

检查文件格式: 确保录制的音频文件格式为 wav，并且采样率为 44.1 kHz，位深度为 16 位。
添加下载按钮: 在代码中添加下载按钮，允许用户直接下载录制的音频文件。
保存到服务器: 如果需要将音频文件保存到服务器，可以使用 st.file_uploader 组件或直接将音频数据保存为文件。

import base64

def download_link(object_to_download, download_filename, download_link_text):
    if isinstance(object_to_download, bytes):
        b64 = base64.b64encode(object_to_download).decode()
    else:
        b64 = base64.b64encode(object_to_download.encode()).decode()
    href = f'<a href="data:file/txt;base64,{b64}" download="{download_filename}">{download_link_text}</a>'
    return href

wav_audio_data = st_audiorec()
if wav_audio_data is not None:
    st.audio(wav_audio_data, format='audio/wav')
    st.markdown(download_link(wav_audio_data, "recording.wav", "下载录音文件"), unsafe_allow_html=True)

通过以上步骤，新手用户可以更好地理解和使用 Streamlit Audio Recorder 项目，解决常见问题。