community.windows.win_say – Модуль для преобразования текста в речь для Windows, позволяющий говорить сообщения и (необязательно) воспроизводить звуки

Примечание

Этот плагин входит в состав коллекции community.windows (версия 1.2.0).

Для его установки используйте: ansible-galaxy collection install community.windows.

Для использования в playbook укажите: community.windows.win_say.

Описание
Параметры
Примечания
См. также
Примеры
Значения возврата

Описание

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

См. также

community.windows.win_msg: Официальная документация модуля community.windows.win_msg.
community.windows.win_toast: Официальная документация модуля community.windows.win_toast.

Примеры

- name: Warn of impending deployment
  community.windows.win_say:
    msg: Warning, deployment commencing in 5 minutes, please log out.

- name: Using a different voice and a start sound
  community.windows.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
  community.windows.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
  community.windows.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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/windows/win_say_module.html