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. [community]
Авторы
- 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.7/modules/win_say_module.html
