更新记录

1.0.4（2026-03-27） 下载此版本

安卓测试过了 iOS未测试

1.0.3（2026-03-27） 下载此版本

调试

1.0.2（2026-03-27） 下载此版本

geg

平台兼容性

uni-app(5.05)

uni-app x(5.05)

fyq-xqsszxdmx 讯飞实时录音转写大模型

基于讯飞 SparkChain SDK 的实时录音转写大模型插件，支持 Android SDK 和 iOS WebSocket 方式。通过麦克风实时采集音频，将语音转写为文本，适用于语音输入、语音笔记等场景。

版本： 1.0.1

平台支持

• HBuilderX >= 3.6.8
• uni-app >= 5.05

导入方式

本插件为 UTS 插件，在 uni-app（非 uni-app x）项目中，通过 ES module 方式导入：

import { checkAudioPermissions, startRecording, stopRecording } from '@/uni_modules/fyq-xqsszxdmx'

注意： uni.checkAudioPermissions()、uni.startRecording() 等 uni.xxx() 形式仅在 uni-app x 项目中可用，普通 uni-app 项目请使用上述 import 方式。

API 参考

checkAudioPermissions(options)

检查录音权限状态。

参数（CheckPermissionsOptions）：

success 回调参数（CheckPermissionsResult）：

权限状态码（code）：

startRecording(options)

开始实时录音转写。Android 端基于讯飞 SparkChain SDK，iOS 端基于 WebSocket 连接。

参数（StartRecordingOptions）：

onTextReceived 回调参数：

音频格式： PCM 16-bit little-endian，单声道，采样率 16000Hz。

stopRecording(options)

停止当前录音并断开转写连接。

参数（StopRecordingOptions）：

错误码

错误通过 fail 回调返回，格式为 { errCode: number, errMsg: string }。运行时错误通过 onError 回调以字符串形式返回。

完整示例

<template>
  <view>
    <button @click="handleVoiceTap">
      {{ isRecording ? '停止录音' : '开始录音' }}
    </button>
    <textarea v-model="inputText" placeholder="语音转写结果..." />
  </view>
</template>

<script>
import { checkAudioPermissions, startRecording, stopRecording } from '@/uni_modules/fyq-xqsszxdmx'

export default {
  data() {
    return {
      isRecording: false,
      inputText: '',
      confirmedText: ''
    }
  },
  beforeDestroy() {
    // 组件销毁时停止录音，避免资源泄漏
    if (this.isRecording) {
      this.stopVoice()
    }
  },
  methods: {
    handleVoiceTap() {
      if (this.isRecording) {
        this.stopVoice()
      } else {
        this.startVoice()
      }
    },
    startVoice() {
      // 重置文本
      this.inputText = ''
      this.confirmedText = ''

      // 检查权限
      checkAudioPermissions({
        success: (res) => {
          if (res.code === 2) {
            uni.showToast({
              title: '录音权限已被拒绝，请在设置中开启',
              icon: 'none'
            })
            return
          }
        }
      })

      this.isRecording = true

      // 开始录音转写
      startRecording({
        appId: 'your_app_id',
        apiKey: 'your_api_key',
        apiSecret: 'your_api_secret',
        lang: 'autodialect',
        onTextReceived: (text, isFinal) => {
          if (isFinal) {
            // 最终结果：累积到已确认文本
            this.confirmedText += text
            this.inputText = this.confirmedText
          } else {
            // 中间结果：已确认文本 + 当前识别内容
            this.inputText = this.confirmedText + text
          }
        },
        onError: (errMsg) => {
          console.error('转写错误:', errMsg)
          uni.showToast({ title: errMsg, icon: 'none' })
          this.isRecording = false
        },
        success: (res) => {
          console.log('录音转写已启动:', res)
        }
      })
    },
    stopVoice() {
      if (!this.isRecording) return
      this.isRecording = false
      this.confirmedText = ''
      stopRecording({
        success: (res) => {
          console.log('停止录音:', res)
        }
      })
    }
  }
}
</script>

注意事项

1. 生命周期管理 — 在组件的 beforeDestroy 中必须调用 stopRecording() 停止录音，否则会导致录音资源无法释放、回调泄漏等问题。建议同时监听应用隐藏事件（如 uni.$on('app-hide', ...)），在应用切到后台时也停止录音。

2. 权限配置

   • Android： 插件已通过 AndroidManifest.xml 自动声明 RECORD_AUDIO 和 INTERNET 权限，无需手动配置。
   • iOS： 需要在项目的 Info.plist 中配置 NSMicrophoneUsageDescription（麦克风使用说明），否则应用会崩溃。示例：

     <key>NSMicrophoneUsageDescription</key>
     <string>需要使用麦克风进行语音转写</string>

3. 录音状态 — 插件内部维护全局录音状态，同一时间只能有一个录音会话。在未停止当前录音时再次调用 startRecording 会导致未定义行为。

4. 累积文本模式 — onTextReceived 回调中 isFinal 为 false 时返回的是临时中间结果（可能被修正），isFinal 为 true 时返回的是最终确认结果。推荐使用"累积文本"策略：将 isFinal === true 的文本追加到已确认文本，将 isFinal === false 的文本作为实时预览拼接显示。