community.windows.win_say 模块 – 用于 Windows 的文本转语音模块，可朗读消息并可选播放声音

注意

此模块是 community.windows 集合 (版本 2.3.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.windows。

要在 playbook 中使用它，请指定：community.windows.win_say。

概要

  • 使用 .NET 库将文本转换为语音，并可以选择播放 .wav 声音。需要运行音频服务，并且需要将某种扬声器或耳机连接到 Windows 目标才能听到语音。

参数

参数

注释

end_sound_path

路径

包含要在文本朗读后播放的声音的 .wav 文件的完整路径。

在电话会议中很有用，可以提醒其他发言者 Ansible 已完成发言。

msg

字符串

要朗读的文本。

使用 msg 或 msg_file。

可选，以便您仅使用此模块播放声音。

msg_file

路径

包含要朗读文本的 Windows 格式文本文件的完整路径。

使用 msg 或 msg_file。

可选，以便您仅使用此模块播放声音。

speech_speed

整数

朗读文本的速度。

必须是 -10 到 10 范围内的整数值。

-10 最慢，10 最快。

默认值： 0

start_sound_path

路径

包含要在文本朗读前播放的声音的 .wav 文件的完整路径。

在电话会议中很有用，可以提醒其他发言者 Ansible 有话要说。

voice

字符串

要使用的语音。有关如何发现已安装语音的信息，请参阅备注。

如果请求的语音不可用，则将使用默认语音。Windows 10 中的示例语音名称为 Microsoft Zira Desktop 和 Microsoft Hazel Desktop。

备注

注意

  • 需要扬声器或耳机才能发挥作用。

  • 要查找已安装的语音，请运行以下 PowerShell 命令：Add-Type -AssemblyName System.Speech $speech = New-Object -TypeName System.Speech.Synthesis.SpeechSynthesizer $speech.GetInstalledVoices() | ForEach-Object { $_.VoiceInfo } $speech.Dispose()

  • 语音可能出奇地慢，因此最好使消息文本简短。

另请参阅

另请参阅

community.windows.win_msg

向 Windows 主机上登录的用户发送消息。

community.windows.win_toast

向 Windows 10 或更高版本主机上登录的用户发送 Toast Windows 通知。

示例

- name: Warn of impending deployment
  community.windows.win_say:
    msg: Warning, deployment commencing in 5 minutes, please log out.

- name: Using a different voice and a start sound
  community.windows.win_say:
    start_sound_path: C:\Windows\Media\ding.wav
    msg: Warning, deployment commencing in 5 minutes, please log out.
    voice: Microsoft Hazel Desktop

- name: With start and end sound
  community.windows.win_say:
    start_sound_path: C:\Windows\Media\Windows Balloon.wav
    msg: New software installed
    end_sound_path: C:\Windows\Media\chimes.wav

- name: Text from file example
  community.windows.win_say:
    start_sound_path: C:\Windows\Media\Windows Balloon.wav
    msg_file: AppData\Local\Temp\morning_report.txt
    end_sound_path: C:\Windows\Media\chimes.wav

返回值

常见的返回值已在 此处 记录，以下是此模块特有的字段

键

描述

message_text

字符串

模块尝试朗读的文本。

返回：成功

示例： "警告，部署将在 5 分钟内开始。"

voice

字符串

用于朗读文本的语音。

返回：成功

示例： "Microsoft Hazel Desktop"

voice_info

字符串

用于朗读文本的语音。

返回：当请求的语音无法加载时

示例： "无法加载语音 TestVoice，使用系统默认语音"

作者

  • Jon Hawkesworth (@jhawkesworth)