uni-app实战案例:实现H5页面麦克风权限获取与录音功能

2024-08-09 21:24:14 浏览数 (3)

目录

  • 前言
  • 技术背景与需求分析
  • 具体实现
    • 在uni-app中配置麦克风权限
    • 实现麦克风权限获取与录音功能
      • 功能一:将音频流转换为Blob文件并上传
      • 功能二:将音频流转换为Base64字符串并上传
      • 功能三:下载录制的音频文件
  • 结语

前言

你好,我是喵喵侠。在我们日常的前端开发中,时常会遇到需要获取设备麦克风权限并进行录音的需求。比如,接到一个需求,要求在聊天对话框中实现语音识别功能,用户点击按钮开始录音,再次点击按钮停止录音,并将录制的音频转换成文字进行显示。在这个过程中,技术上的难点主要集中在如何通过浏览器获取麦克风权限,以及如何处理麦克风接收到的音频流。

在这篇文章中,我将带你一步步实现这一功能,并探讨如何使用uni-app开发H5页面获取麦克风权限并进行录音。

技术背景与需求分析

在浏览器环境中,获取麦克风权限并进行录音通常需要依赖Web API中的navigator.mediaDevices.getUserMediaMediaRecorder接口。getUserMedia用于获取媒体流,包括音频、视频等,而MediaRecorder则用于录制这些媒体流。

在实际项目中,我们可能会将录制的音频处理为两种形式:一种是生成Blob文件并上传至后端,另一种是将音频流转换为Base64字符串上传。这两种方式最终的目的都是为了将音频数据传递到服务器进行处理,如语音识别(TTS)等。

具体实现

在uni-app中配置麦克风权限

在uni-app开发H5页面时,需要在manifest.json文件中添加录音权限的配置。具体如下:

代码语言:json复制
{
  "h5": {
    "permissions": {
      "scope.record": {
        "desc": "请授权使用录音功能"
      }
    }
  }
}

这段配置代码是用于向用户请求麦克风权限,确保应用在运行时可以访问设备的音频输入。

注意:默认的mainfest.json文件打开是一个菜单,你把左边滚动条拉到最后面,点击最后一个,就可以切换到代码视图了。

实现麦克风权限获取与录音功能

在获取了麦克风权限后,我们可以利用navigator.mediaDevices.getUserMedia接口获取音频流,然后通过MediaRecorder接口进行录音。接下来,我们将实现一个简单的录音功能。

首先,我们在页面中添加录音按钮和录音状态显示的HTML结构:

代码语言:html复制
<template>
  <view>
    <button @click="startRecording">开始录音</button>
    <button @click="stopRecording" :disabled="!isRecording">停止录音</button>
    <text>录音状态:{{ isRecording ? '录音中' : '未录音' }}</text>
  </view>
</template>

这个部分用于在页面上展示录音的控制按钮和状态信息。接下来,我们编写JavaScript代码,分别实现将音频流转换为Blob文件并上传、将音频流转换为Base64字符串上传,以及将音频文件下载到本地的功能。

功能一:将音频流转换为Blob文件并上传
代码语言:javascript复制
<script>
export default {
  data() {
    return {
      isRecording: false,
      mediaRecorder: null,
      audioChunks: []
    };
  },
  methods: {
    async startRecording() {
      try {
        const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
        this.mediaRecorder = new MediaRecorder(stream);
        this.mediaRecorder.ondataavailable = (event) => {
          this.audioChunks.push(event.data);
        };
        this.mediaRecorder.onstop = () => {
          const audioBlob = new Blob(this.audioChunks, { type: 'audio/wav' });
          this.uploadAudio(audioBlob);
        };
        this.mediaRecorder.start();
        this.isRecording = true;
      } catch (error) {
        console.error('获取麦克风权限失败:', error);
      }
    },
    stopRecording() {
      if (this.mediaRecorder) {
        this.mediaRecorder.stop();
        this.isRecording = false;
      }
    },
    uploadAudio(audioBlob) {
      const formData = new FormData();
      formData.append('audio', audioBlob, 'recorded_audio.wav');

      uni.uploadFile({
        url: 'https://xxx.com/upload', // 替换为你的后端接口地址
        filePath: URL.createObjectURL(audioBlob),
        name: 'audio',
        formData: formData,
        success: (res) => {
          console.log('上传成功:', res);
        },
        fail: (err) => {
          console.error('上传失败:', err);
        }
      });
    }
  }
};
</script>
功能二:将音频流转换为Base64字符串并上传
代码语言:javascript复制
<script>
export default {
  data() {
    return {
      isRecording: false,
      mediaRecorder: null,
      audioChunks: []
    };
  },
  methods: {
    async startRecording() {
      try {
        const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
        this.mediaRecorder = new MediaRecorder(stream);
        this.mediaRecorder.ondataavailable = (event) => {
          this.audioChunks.push(event.data);
        };
        this.mediaRecorder.onstop = () => {
          const audioBlob = new Blob(this.audioChunks, { type: 'audio/wav' });
          this.convertToBase64(audioBlob);
        };
        this.mediaRecorder.start();
        this.isRecording = true;
      } catch (error) {
        console.error('获取麦克风权限失败:', error);
      }
    },
    stopRecording() {
      if (this.mediaRecorder) {
        this.mediaRecorder.stop();
        this.isRecording = false;
      }
    },
    convertToBase64(audioBlob) {
      const reader = new FileReader();
      reader.readAsDataURL(audioBlob);
      reader.onloadend = () => {
        const base64Audio = reader.result;
        this.sendAudioToBackend(base64Audio);
      };
    },
    sendAudioToBackend(base64Audio) {
      uni.request({
        url: 'https://xxx.com/upload', // 替换为你的后端接口地址
        method: 'POST',
        data: {
          audio: base64Audio
        },
        success: (res) => {
          console.log('上传成功:', res);
        },
        fail: (err) => {
          console.error('上传失败:', err);
        }
      });
    }
  }
};
</script>
功能三:下载录制的音频文件

在某些场景中,你可能还需要将录制的音频文件下载到用户本地。我们可以在录音结束后,提供一个下载链接来实现这一功能:

代码语言:javascript复制
downloadAudio(audioBlob) {
  const url = URL.createObjectURL(audioBlob);
  const a = document.createElement('a');
  a.style.display = 'none';
  a.href = url;
  a.download = 'recorded_audio.wav';
  document.body.appendChild(a);
  a.click();
  window.URL.revokeObjectURL(url);
}

另外说下,经过我的测试发现,这样生成的wav音频文件,用普通的播放器还打不开,用VLC是可以的。

结语

通过本文的介绍,我们已经实现了在uni-app的H5页面中获取麦克风权限并进行录音的功能,提供了将音频流处理为Blob文件和Base64字符串的两种方案,并且还补充了将录制的音频文件下载到本地的功能。这些实现方案可以根据项目需求进行灵活调整。如果你在开发中遇到类似的需求,希望这篇文章能为你提供参考和帮助。

0 人点赞