在自动化脚本中如何实现播音？

一、播放音频文件：audio对象

当需要播放特定的音频文件（如提示音、背景音乐、录音回放等）时，应使用audio对象。该对象提供了播放与停止两个核心方法。

1.audio.play(fullPath)—— 播放音频

• 功能：播放指定的音频文件。

• 参数：

  • fullPath（string，必填）：音频文件的完整路径。

• 支持的路径类型：

  • 本地文件路径：以/sdcard/开头，指向设备存储中的具体文件。例如：/sdcard/my.mp3。

  • 打包资源路径：以asset:开头，指向打包到冰狐 APP 中的声音文件。例如：asset:test.mp3。这种方式适合将常用音频随 APP 一起分发，无需额外存储权限。

2.audio.stop()—— 停止播放

• 功能：立即停止当前正在播放的音频。

• 参数：无。

使用示例：

// 播放设备存储中的音频文件 audio.play('/sdcard/my.mp3'); // 播放打包到冰狐APP中的资源文件 audio.play('asset:test.mp3'); // 停止当前播放 audio.stop();

二、文本转语音（TTS）：tts对象

当需要将动态生成的文本内容（如状态播报、预警信息、进度提示等）实时转换为语音时，应使用tts对象。其 API 设计与audio对象保持一致。

1.tts.play(text)—— 播放文本

• 功能：将传入的文本字符串转换为语音并实时播放。

• 参数：

  • text（string，必填）：待转换的文本内容，支持中文、英文、数字及符号混合输入。

• 特点：

  • 无需初始化：平台底层自动完成语音合成与播放，开箱即用。

  • 自动中断：连续调用时，后一次播放会自动中断前一次未完成的语音，避免声音叠加。

  • 完全本地运行：无需网络请求，无调用频率限制，无额外费用，适合离线自动化场景。

2.tts.stop()—— 停止播放

• 功能：立即终止当前正在播放的 TTS 语音。

• 参数：无。即使当前没有语音在播放，调用此方法也不会报错。

使用示例：

// 基础文本播报 tts.play('任务已启动，正在执行自动化操作。'); // 带变量的动态播报 var count = 10; tts.play('操作完成，共执行了' + count + '次任务。'); // 停止当前播报 tts.stop();

三、audio与tts的选择与对比

四、典型应用场景

1. 自动化任务状态播报：在脚本的关键节点（启动、完成、异常）调用tts.play()进行语音提醒，无需盯着屏幕查看日志。

2. 设备监控预警：当检测到存储空间不足、网络断开等异常时，通过 TTS 发出语音告警。

3. 批量操作进度提示：在批量点击、批量数据处理过程中，播报当前进度，避免重复操作。

4. 固定提示音播放：在特定操作完成时，播放预设的音频文件（如成功提示音、错误提示音），使用audio.play()实现。

5. 无障碍辅助：为界面文本提供语音朗读，提升工具的普惠性。

五、注意事项

• 文件路径：使用audio.play()时，务必确保路径正确且文件存在。本地路径需以/sdcard/开头，资源路径需以asset:开头。

• 权限：播放本地存储的音频文件可能需要存储权限，请确保冰狐 APP 已获取相应权限。

• 音频格式：建议使用常见的 MP3 格式，以确保兼容性。

• 连续调用：无论是audio.play()还是tts.play()，连续调用时后者会自动中断前者，无需手动调用stop()。

总结

冰狐智能辅助平台的播音能力通过audio和tts两个对象提供，API 设计简洁统一——都只包含play()和stop()两个方法。audio面向固定音频文件的播放，tts面向动态文本的语音合成。开发者可根据实际需求灵活选用，在自动化脚本中快速集成语音播报功能，提升任务执行的感知度和交互体验。