win_say – Модуль преобразования текста в речь для Windows для озвучивания сообщений и (необязательно) воспроизведения звуков

Новый в версии 2.3.

Описание
Параметры
Примечания
См. также
Примеры
Возвращаемые значения
Статус

Описание

Использует библиотеки .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()
Озвучивание может быть довольно медленным, поэтому лучше всего использовать короткие тексты.

См. также

win_msg – Отправка сообщения зарегистрированным пользователям на хостах Windows: Официальная документация модуля win_msg.
win_toast – Отправка уведомлений Toast в виде уведомлений Windows пользователям, зарегистрированным на хостах Windows 10 или более поздних версий: Официальная документация модуля win_toast.

Примеры

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

- name: Using a different voice and a start sound
  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
  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
  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, используется системный голос по умолчанию

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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.8/modules/win_say_module.html