更新记录

1.0.0（2025-10-21）

新增功能

• 新增了initTTS(初始化 TTS 引擎)、resetTTS(重置 TTS 引擎)、 isTTS(检查是否支持 TTS)、isSpeaking(检查是否正在播报)、getVoices(获取音色列表)、getLanguages(获取可用语言列表)、setVoice(设置发音人)、setLanguage(设置语言)、setVolume(设置音调)、setPitch(设置音调)、setSpeed(设置语速)、speak(语音播报)、pause(暂停播报)、resume(恢复播报)、stop(停止播报)、destroy(释放资源)的方法
• 支持Android、Harmony、Web
• 初始版本

问题修复

• 无

功能优化

• 无

平台兼容性

uni-app(4.55)

uni-app x(4.55)

其他

离线 TTS 文本转语音播报中、英文（ima-tts）

ima-tts 是一款使用系统自带的能力将文字转成语音播报的UTS插件，支持选择语言、语速、音调等配置,支持Android、Harmony、Web

需要权限

• 无

使用示例【此示例的代码只实现了语音播报、暂停播报、恢复播报、停止播报的逻辑，更多示例请导入项目】

<template>
    <view class="container content">
        <view class="content-title">语音控制</view>
        <view class="content-message">(语音播放、暂停、继续、停止等)</view>
        <view class="content-button ima-xxx" @click="initTTSHandle">初始化</view>
        <view class="content-button ima-xxx" @click="playSpeak">播放语音</view>
        <view class="content-button ima-xxx" @click="pauseSpeak">暂停播放</view>
        <view class="content-button ima-xxx" @click="resumeSpeak">继续播放</view>
        <view class="content-button ima-xxx" @click="stopSpeak">停止播放</view>
    </view>
</template>

<script lang="ts">
import {
    IReturn,
    initTTS,
    speak,
    stop,
    pause,
    resume,
    destroy
} from '@/uni_modules/ima-tts'

export default {
    data() {
        return {}
    },
    onLoad(options) {
        this.initTTSHandle()
    },
    methods: {
        // 初始化
        initTTSHandle() {
            initTTS('zh-CN').then((res: IReturn) => {
                if (res.success) {
                    console.log(res.message)
                } else {
                    console.log(res.message)
                }
            })
        },
        // 播放
        playSpeak() {
            const text1 = '1 2 3 4 5，上山打老虎。老虎不在家，打了小松鼠。松鼠有几只，仔细数一数，1 2 3 4 5。'
            speak(text2).then((res: IReturn) => {
                if (res.success) {
                    console.log(res.message)
                } else {
                    console.log(res.message)
                }
            })
        },
        // 暂停播放
        pauseSpeak() {
            pause().then((res: IReturn) => {
                if (res.success) {
                    console.log(res.message)
                } else {
                    console.log(res.message)
                }
            })
        },
        // 继续播放
        resumeSpeak() {
            resume().then((res: IReturn) => {
                if (res.success) {
                    console.log(res.message)
                } else {
                    console.log(res.message)
                }
            })
        },
        // 停止播放
        stopSpeak() {
            stop().then((res: IReturn) => {
                if (res.success) {
                    console.log(res.message)
                } else {
                    console.log(res.message)
                }
            })
        },
    },

    onUnmounted() {
        destroy().then((res: IReturn) => {
            if (res.success) {
                console.log(res.message)
            } else {
                console.log(res.message)
            }
        })
    }
}
</script>

<style lang="scss">
.content {
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;

    &-title {
        margin-top: 10rpx;
        padding: 10rpx;
        font-size: 44rpx;
        font-weight: 800;
        color: #ff0000;
    }

    &-message {
        font-size: 28rpx;
        font-weight: 800;
        text-align: center;
        color: #ff6700;
    }

    &-button {
        height: 65rpx;
        width: 750rpx;
        padding: 20rpx;
        line-height: 65rpx;
        text-align: center;
        background: #00e0f1;
        margin-bottom: 25rpx;
    }
}
</style>

方法

ISpeakOptions 参数类型