win_say – Модуль преобразования текста в речь для Windows для озвучивания сообщений и, необязательно, воспроизведения звуков
Описание
- Использует библиотеки .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 строка | success | Текст, который модуль пытался озвучить. Пример: Предупреждение, развертывание начнется через 5 минут. |
| voice строка | success | Использованный голос для озвучивания текста. Пример: 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.9/modules/win_say_module.html
