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 窗口通知。

示例

- 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)