项目
版本

Uppy 音频

@uppy/audio 插件允许您使用内置或外置麦克风,或其他任何音频设备,在桌面和移动设备上录制音频。界面在录音时会显示实时的声音波形。

何时应该使用这个?

当您希望用户在他们的计算机上录制音频时。

安装

  • npm

    npm install @uppy/audio
    
  • yarn

    yarn add @uppy/audio
    
  • CDN

    <!-- 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 选择器或插件( stringElementFunction,或 UIPlugin ,默认:Dashboard )。

showAudioSourceDropdown

配置是否显示用于选择音频设备的下拉菜单( boolean,默认:false )。

locale

export default {
  strings: {
    pluginNameAudio: "音频",
    // 用作启动音频录制的按钮的标签。
    // 这不会被直接渲染,但会被屏幕阅读器读取。
    startAudioRecording: "开始音频录制",
    // 用作停止音频录制的按钮的标签。
    // 这不会被直接渲染,但会被屏幕阅读器读取。
    stopAudioRecording: "停止音频录制",
    // 在“允许访问”屏幕上的标题
    allowAudioAccessTitle: "请允许访问您的麦克风",
    // 在“允许访问”屏幕上的描述
    allowAudioAccessDescription: "为了录制音频,请为此站点允许麦克风访问。",
    // 在“设备不可用”屏幕上的标题
    noAudioTitle: "麦克风不可用",
    // 在“设备不可用”屏幕上的描述
    noAudioDescription: "为了录制音频,请连接麦克风或其他音频输入设备",
    // 关于文件大小的消息将在通知气泡中显示
    recordingStoppedMaxSize: "录音已停止,因为文件大小即将超过限制",
    // 用作显示录音时长(如`1:25`)的计数器的标签。
    // 这不会被直接渲染,但会被屏幕阅读器读取。
    recordingLength: "录音时长 %{recording_length}",
    // 用作提交已录制文件的对勾按钮的标签。
    // 这不会被直接渲染,但会被屏幕阅读器读取。
    submitRecordedFile: "提交已录制文件",
    // 用作丢弃已录制文件的叉号按钮的标签。
    // 这不会被直接渲染,但会被屏幕阅读器读取。
    discardRecordedFile: "丢弃已录制文件",
  },
};
在本文档中