更新记录

1.0.0(2025-02-26)

  • 初始版本

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
Android:4.4,iOS:9,HarmonyNext:不支持 × × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序 鸿蒙元服务
× × × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

bsf-baidu-realtime-speech-trans

此项目是基于百度实时语音翻译API专为uniapp/uniappx的App项目定制的UTS插件。

平台支持

  • Android
  • iOS
  • Vue2/Vue3

使用说明

使用前的准备

  • 需要导百度云平台申请对应的产品和参数

引入插件

import * as SpeechRealTimeTrans from "@uni_modules/bsf-baidu-realtime-speech-trans";

API接口

requestRecordingPermission (请求录音权限)

SpeechRealTimeTrans.requestRecordingPermission();

start (开始实时语音翻译)

SpeechRealTimeTrans.start({
    url: "wss://aip.baidubce.com/ws/realtime_speech_trans", // WebSocket服务地址
    appId: "your_app_id",  // 百度应用的AppID
    appKey: "your_app_key", // 百度应用的AppKey
    samplingRate: 16000,    // 音频采样率
    fromLan: "zh",         // 源语言
    toLan: "en",          // 目标语言
    isReturnTts: true,    // 是否返回TTS语音
    ttsSpeaker: "woman",  // TTS发音人

    // 开始失败回调
    onStartFailure: (code, msg) => {
        console.log("启动失败", code, msg);
    },

    // WebSocket连接成功回调
    onWebsocketConnected: () => {
        console.log("WebSocket已连接");
    },

    // WebSocket断开连接回调
    onWebsocketDisconnect: (code, reason) => {
        console.log("WebSocket断开连接", code, reason);
    },

    // 接收文本消息回调
    onReceiveTextMessage: (message) => {
        console.log("收到翻译文本", message);
    },

    // 接收TTS语音回调
    onReceiveTtsMessage: (audioPath) => {
        console.log("收到TTS音频文件路径", audioPath);
    },

    // 接收消息失败回调
    onReceiveMessageFailure: (error) => {
        console.log("接收消息失败", error);
    }
});

stop (停止实时语音翻译)

SpeechRealTimeTrans.stop();

playAudio (播放音频)

SpeechRealTimeTrans.playAudio(audioPath);

参数说明

StartOptions 参数说明

参数 类型 必填 说明
url String WebSocket服务地址
appId String 百度应用的AppID
appKey String 百度应用的AppKey
samplingRate Number 音频采样率,通常为16000
fromLan String 源语言代码,如"zh"代表中文
toLan String 目标语言代码,如"en"代表英语
isReturnTts Boolean 是否返回TTS语音,默认false
ttsSpeaker String TTS发音人,可选值:"woman"/"man"
onStartFailure Function 启动失败回调
onWebsocketConnected Function WebSocket连接成功回调
onWebsocketDisconnect Function WebSocket断开连接回调
onReceiveTextMessage Function 接收文本消息回调
onReceiveTtsMessage Function 接收TTS语音回调
onReceiveMessageFailure Function 接收消息失败回调

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<!-- 录音权限 --> <uses-permission android:name="android.permission.RECORD_AUDIO" /> <!-- 网络权限 --> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- 存储权限 --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问