HarmonyOS NEXT AI 基础语音服务 - 文章播报
作者：zhousg
- 2025-03-30 北京
本文字数：3044 字
阅读完需：约 10 分钟
案例描述
这是一个基于 AI 基础语音服务实现的文字语音播报案例
实现步骤：
1. 引入必要的模块
引入 textToSpeech 和 promptAction 模块，分别用于文字转语音和提示信息展示。
import { textToSpeech } from '@kit.CoreSpeechKit'import { promptAction } from '@kit.ArkUI'
复制代码
说明：textToSpeech 模块提供了文字转语音的功能，promptAction 模块用于在界面上显示提示信息。
2. 定义组件
使用 @Entry 和 @ComponentV2 装饰器定义一个名为 CoreSpeechKit 的组件。
@Entry@ComponentV2struct CoreSpeechKit { // 待播报的文本内容 text: string = ` 北纬45度的三月，时光在这里打了个温柔的结。松花江畔的晨雾裹着细雪，将每根枝条都雕琢成剔透的琉璃，冰晶在枝头堆叠出千重瓣的玉兰花，风穿过枝桠时簌簌抖落的不是雪粒，分明是星辰坠入人间的碎屑。 而此时江南的杏花正枕着暖风酿蜜，绯云般的花影漫过白墙黛瓦，连空气都沁着微醺的甜。季节的调色师悄悄把颜料盘一分为二——北国仍执着地续写冬的尾章，用冰棱作笔，在窗棂勾勒霜花；南疆已迫不及待地翻开春的扉页，让雨燕衔着柳色掠过水墨长巷。 这相隔三千里的温差，在晨昏线两端织就两幅绸缎：北方是银丝绣的素锦，凛冽里裹着未尽的絮语；南方是蚕娘染的软罗，温润中漾开初生的呢喃。当哈尔滨的树挂迎着朝阳融化第一滴璀璨，杭州的玉兰恰好抖落肩头第三片月光，原来春天正踏着经纬线，把料峭与暄暖谱成天地间最动人的复调。 ` // 文字转语音引擎实例 ttsEngine?: textToSpeech.TextToSpeechEngine
// 本地状态，用于标记是否正在播放 @Local isPlaying: boolean = false
// 初始化文字转语音引擎 async initTextToSpeechEngine() { if (canIUse('SystemCapability.AI.TextToSpeech')) { const params: textToSpeech.CreateEngineParams = { language: 'zh-CN', person: 0, online: 1 } this.ttsEngine = await textToSpeech.createEngine(params) } }
// 组件即将显示时调用 aboutToAppear(): void { this.initTextToSpeechEngine() }
// 组件即将消失时调用 aboutToDisappear(): void { if (canIUse('SystemCapability.AI.TextToSpeech')) { this.ttsEngine?.stop() this.ttsEngine?.shutdown() } }
// 播放语音 play() { if (canIUse('SystemCapability.AI.TextToSpeech')) { if (this.ttsEngine?.isBusy()) { return promptAction.showToast({ message: '正在播报...' }) } const params: textToSpeech.SpeakParams = { requestId: '10000' } this.ttsEngine?.speak(this.text, params) this.isPlaying = true } }
// 构建组件界面 build() { Stack({ alignContent: Alignment.BottomEnd }) { List() { ListItem() { Text(this.text) .lineHeight(32) } } .padding({ left: 15, right: 15 }) .height('100%') .width('100%')
Row() { Image(this.isPlaying ? $r('sys.media.AI_playing') : $r('sys.media.AI_play')) .width(24) .onClick(() => this.play()) } .borderRadius(24) .shadow({ color: Color.Gray, offsetX: 5, offsetY: 5, radius: 15 }) .width(48) .aspectRatio(1) .justifyContent(FlexAlign.Center) .margin({ right: 50, bottom: 50 }) } .height('100%') .width('100%') }}
复制代码
说明：
text存储待播报的文本内容。ttsEngine是文字转语音引擎的实例。isPlaying用于标记是否正在播放语音。initTextToSpeechEngine方法用于初始化文字转语音引擎。aboutToAppear方法在组件即将显示时调用，初始化引擎。aboutToDisappear方法在组件即将消失时调用，停止并关闭引擎。play方法用于播放语音，若引擎正在忙碌则显示提示信息。build方法构建组件的界面，包括显示文本的列表和播放按钮。
总结梳理：
核心点
使用
textToSpeech模块实现文字转语音功能。在组件生命周期方法中初始化和关闭引擎。
通过
isPlaying状态控制播放按钮的显示。
完整代码
import { textToSpeech } from '@kit.CoreSpeechKit'import { promptAction } from '@kit.ArkUI'
@Entry@ComponentV2struct CoreSpeechKit { text: string = ` 北纬45度的三月，时光在这里打了个温柔的结。松花江畔的晨雾裹着细雪，将每根枝条都雕琢成剔透的琉璃，冰晶在枝头堆叠出千重瓣的玉兰花，风穿过枝桠时簌簌抖落的不是雪粒，分明是星辰坠入人间的碎屑。 而此时江南的杏花正枕着暖风酿蜜，绯云般的花影漫过白墙黛瓦，连空气都沁着微醺的甜。季节的调色师悄悄把颜料盘一分为二——北国仍执着地续写冬的尾章，用冰棱作笔，在窗棂勾勒霜花；南疆已迫不及待地翻开春的扉页，让雨燕衔着柳色掠过水墨长巷。 这相隔三千里的温差，在晨昏线两端织就两幅绸缎：北方是银丝绣的素锦，凛冽里裹着未尽的絮语；南方是蚕娘染的软罗，温润中漾开初生的呢喃。当哈尔滨的树挂迎着朝阳融化第一滴璀璨，杭州的玉兰恰好抖落肩头第三片月光，原来春天正踏着经纬线，把料峭与暄暖谱成天地间最动人的复调。 ` ttsEngine?: textToSpeech.TextToSpeechEngine
@Local isPlaying: boolean = false
async initTextToSpeechEngine() { if (canIUse('SystemCapability.AI.TextToSpeech')) { const params: textToSpeech.CreateEngineParams = { language: 'zh-CN', person: 0, online: 1 } this.ttsEngine = await textToSpeech.createEngine(params) } }
aboutToAppear(): void { this.initTextToSpeechEngine() }
aboutToDisappear(): void { if (canIUse('SystemCapability.AI.TextToSpeech')) { this.ttsEngine?.stop() this.ttsEngine?.shutdown() } }
play() { if (canIUse('SystemCapability.AI.TextToSpeech')) { if (this.ttsEngine?.isBusy()) { return promptAction.showToast({ message: '正在播报...' }) } const params: textToSpeech.SpeakParams = { requestId: '10000' } this.ttsEngine?.speak(this.text, params) this.isPlaying = true } }
build() { Stack({ alignContent: Alignment.BottomEnd }) { List() { ListItem() { Text(this.text) .lineHeight(32) } } .padding({ left: 15, right: 15 }) .height('100%') .width('100%')
Row() { Image(this.isPlaying ? $r('sys.media.AI_playing') : $r('sys.media.AI_play')) .width(24) .onClick(() => this.play()) } .borderRadius(24) .shadow({ color: Color.Gray, offsetX: 5, offsetY: 5, radius: 15 }) .width(48) .aspectRatio(1) .justifyContent(FlexAlign.Center) .margin({ right: 50, bottom: 50 }) } .height('100%') .width('100%') }}
复制代码
划线
评论
复制
发布于: 刚刚阅读数: 2
版权声明: 本文为 InfoQ 作者【zhousg】的原创文章。
原文链接:【http://xie.infoq.cn/article/3d8c2f94a2e7eaef21e08f072】。文章转载请联系作者。
zhousg
关注
还未添加个人签名 2025-03-14 加入
还未添加个人简介
评论