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, используется голос по умолчанию |
Статус
Этот модуль помечен как экспериментальный, что означает, что его интерфейс не гарантирует обратной совместимости.
Автор
- 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.5/modules/win_say_module.html
