Uppy 音频
@uppy/audio
插件允许您使用内置或外置麦克风,或其他任何音频设备,在桌面和移动设备上录制音频。界面在录音时会显示实时的声音波形。
何时应该使用这个?
当您希望用户在他们的计算机上录制音频时。
安装
npm
npm install @uppy/audio
yarn
yarn add @uppy/audio
CDN
警告
此捆绑包包含了大部分Uppy插件,因此不建议在生产环境中使用此方法,因为尽管您可能仅仅用到其中一小部分插件,但用户却需要下载全部插件。
然而,这对于加速您的开发环境非常有帮助,所以在起步阶段,请放心使用它来提升开发速度。<!-- 1. Add CSS to `<head>` --> <link href="https://releases.transloadit.com/uppy/v3.27.3/uppy.min.css" rel="stylesheet"> <!-- 2. Initialize --> <div id="uppy"></div> <script type="module"> import { Uppy, Dashboard, Audio } from "https://releases.transloadit.com/uppy/v3.27.3/uppy.min.mjs" const uppy = new Uppy() uppy.use(Dashboard, { inline: true, target: 'body' }) uppy.use(Audio) </script>
使用
import Uppy from "@uppy/core";
import Dashboard from "@uppy/dashboard";
import Audio from "@uppy/audio";
import "@uppy/core/dist/style.min.css";
import "@uppy/dashboard/dist/style.min.css";
import "@uppy/audio/dist/style.min.css";
new Uppy().use(Dashboard, { inline: true, target: "body" }).use(Audio);
API
选项
id
此插件的唯一标识符( string
,默认值:'audio'
)。
title
配置在 UI 中显示的标题/名称,例如,在 Dashboard 标签上( string
,默认值:'Audio'
)。
target
放置拖放区域的目标 DOM 元素、CSS 选择器或插件( string
,Element
,Function
,或 UIPlugin
,默认:Dashboard
)。
showAudioSourceDropdown
配置是否显示用于选择音频设备的下拉菜单( boolean
,默认:false
)。
locale
export default {
strings: {
pluginNameAudio: "音频",
// 用作启动音频录制的按钮的标签。
// 这不会被直接渲染,但会被屏幕阅读器读取。
startAudioRecording: "开始音频录制",
// 用作停止音频录制的按钮的标签。
// 这不会被直接渲染,但会被屏幕阅读器读取。
stopAudioRecording: "停止音频录制",
// 在“允许访问”屏幕上的标题
allowAudioAccessTitle: "请允许访问您的麦克风",
// 在“允许访问”屏幕上的描述
allowAudioAccessDescription: "为了录制音频,请为此站点允许麦克风访问。",
// 在“设备不可用”屏幕上的标题
noAudioTitle: "麦克风不可用",
// 在“设备不可用”屏幕上的描述
noAudioDescription: "为了录制音频,请连接麦克风或其他音频输入设备",
// 关于文件大小的消息将在通知气泡中显示
recordingStoppedMaxSize: "录音已停止,因为文件大小即将超过限制",
// 用作显示录音时长(如`1:25`)的计数器的标签。
// 这不会被直接渲染,但会被屏幕阅读器读取。
recordingLength: "录音时长 %{recording_length}",
// 用作提交已录制文件的对勾按钮的标签。
// 这不会被直接渲染,但会被屏幕阅读器读取。
submitRecordedFile: "提交已录制文件",
// 用作丢弃已录制文件的叉号按钮的标签。
// 这不会被直接渲染,但会被屏幕阅读器读取。
discardRecordedFile: "丢弃已录制文件",
},
};