更新记录

1.0.0(2025-02-26)

  • 初始版本

平台兼容性

uni-app(4.07)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ - - - - 4.4 12 ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × - × × - × ×

uni-app x(4.07)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - 5.0 12 × ×

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× × × √

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. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无