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 | нет | Скорость чтения текста. Должно быть целое число в диапазоне от -10 до 10. -10 — самая медленная, 10 — самая быстрая скорость. | ||
| start_sound_path | нет | Полный путь к файлу .wav, содержащему звук, который нужно воспроизвести перед чтением текста.Полезно на конференц-связи, чтобы оповестить других участников, что ansible хочет что-то сказать. | ||
| voice | нет | голос по умолчанию | Голос, который нужно использовать. Смотрите заметки, как узнать установленные голоса. Если запрошенный голос недоступен, будет использоваться голос по умолчанию. Примеры имён голосов из Windows 10: Microsoft Zira Desktop и Microsoft Hazel Desktop. |
Примеры
- 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, используется голос по умолчанию |
Примечания
Примечание
- Для работы необходимы динамики или наушники.
-
Чтобы узнать, какие голоса установлены, выполните следующие команды Powershell.
Add-Type -AssemblyName System.Speech $speech = New-Object -TypeName System.Speech.Synthesis.SpeechSynthesizer $speech.GetInstalledVoices() | ForEach-Object { $_.VoiceInfo } $speech.Dispose()
- Чтение может быть неожиданно медленным, поэтому лучше использовать короткие сообщения.
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет совместим с предыдущими версиями.
Для помощи в разработке модулей, если у вас есть желание, пожалуйста, прочитайте Справочная информация по сообществу и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_say_module.html
