Модуль community.windows.win_say — модуль преобразования текста в речь для Windows, который озвучивает сообщения и при необходимости воспроизводит звуки

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.windows.

Чтобы использовать её в плейбуке, укажите: 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: Отправляет уведомления Toast пользователям, вошедшим в систему на узлах Windows 10 или более поздних версий.

Примеры

- 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 строка	Текст, который модуль пытался озвучить. Возвращается: при успешном выполнении Пример: `"Warning, deployment commencing in 5 minutes."`
voice строка	Голос, использованный для озвучивания текста. Возвращается: при успешном выполнении Пример: `"Microsoft Hazel Desktop"`
voice_info строка	Голос, использованный для озвучивания текста. Возвращается: если не удалось загрузить запрошенный голос Пример: `"Could not load voice TestVoice, using system default voice"`

Авторы

Jon Hawkesworth (@jhawkesworth)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_say_module.html