community.windows.win_say – Модуль для озвучивания текста на Windows и дополнительного воспроизведения звуков

Примечание

Этот плагин входит в коллекцию community.windows (версия 1.2.0).

Для его установки используйте: 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 целое число	По умолчанию: 0	Скорость произнесения текста. Должно быть целым числом в диапазоне от -10 до 10. -10 — самая медленная, 10 — самая быстрая скорость.
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: Официальная документация по модулю community.windows.win_msg.
community.windows.win_toast: Официальная документация по модулю community.windows.win_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)

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