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

Примечание

Этот модуль входит в коллекцию community.windows (версия 2.3.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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_say_module.html