一、播放音频文件audio对象当需要播放特定的音频文件如提示音、背景音乐、录音回放等时应使用audio对象。该对象提供了播放与停止两个核心方法。1.audio.play(fullPath)—— 播放音频功能播放指定的音频文件。参数fullPathstring必填音频文件的完整路径。支持的路径类型本地文件路径以/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();二、文本转语音TTStts对象当需要将动态生成的文本内容如状态播报、预警信息、进度提示等实时转换为语音时应使用tts对象。其 API 设计与audio对象保持一致。1.tts.play(text)—— 播放文本功能将传入的文本字符串转换为语音并实时播放。参数textstring必填待转换的文本内容支持中文、英文、数字及符号混合输入。特点无需初始化平台底层自动完成语音合成与播放开箱即用。自动中断连续调用时后一次播放会自动中断前一次未完成的语音避免声音叠加。完全本地运行无需网络请求无调用频率限制无额外费用适合离线自动化场景。2.tts.stop()—— 停止播放功能立即终止当前正在播放的 TTS 语音。参数无。即使当前没有语音在播放调用此方法也不会报错。使用示例// 基础文本播报 tts.play(任务已启动正在执行自动化操作。); // 带变量的动态播报 var count 10; tts.play(操作完成共执行了 count 次任务。); // 停止当前播报 tts.stop();三、audio与tts的选择与对比对比维度audio对象tts对象输入类型预先准备好的音频文件MP3等动态生成的文本字符串适用场景固定提示音、背景音乐、录音回放状态播报、预警信息、进度提示灵活性低内容固定高内容可动态拼接资源依赖依赖音频文件存在无需外部文件仅依赖系统 TTS 引擎核心方法play(fullPath)/stop()play(text)/stop()四、典型应用场景自动化任务状态播报在脚本的关键节点启动、完成、异常调用tts.play()进行语音提醒无需盯着屏幕查看日志。设备监控预警当检测到存储空间不足、网络断开等异常时通过 TTS 发出语音告警。批量操作进度提示在批量点击、批量数据处理过程中播报当前进度避免重复操作。固定提示音播放在特定操作完成时播放预设的音频文件如成功提示音、错误提示音使用audio.play()实现。无障碍辅助为界面文本提供语音朗读提升工具的普惠性。五、注意事项文件路径使用audio.play()时务必确保路径正确且文件存在。本地路径需以/sdcard/开头资源路径需以asset:开头。权限播放本地存储的音频文件可能需要存储权限请确保冰狐 APP 已获取相应权限。音频格式建议使用常见的 MP3 格式以确保兼容性。连续调用无论是audio.play()还是tts.play()连续调用时后者会自动中断前者无需手动调用stop()。总结冰狐智能辅助平台的播音能力通过audio和tts两个对象提供API 设计简洁统一——都只包含play()和stop()两个方法。audio面向固定音频文件的播放tts面向动态文本的语音合成。开发者可根据实际需求灵活选用在自动化脚本中快速集成语音播报功能提升任务执行的感知度和交互体验。