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()
- Произнесение текста может быть неожиданно медленным, поэтому лучше всего использовать короткие сообщения.
Примеры
- 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. Подробнее см. Поддержка модулей и поддержка.
Список других модулей, которые также поддерживаются сообществом 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.6/modules/win_say_module.html
