https://habr.com/post/424477/

• Python
• Accessibility

Всем привет.

В статье Звуковые игры: невидимый рынок ждёт героев были рассмотрены звуковые игры с крутым объемным звуком, и библиотеки для его создания.

Ну а я решил начать с малого, и для начала организовать озвучивание синтезатором действий в пошаговых играх на pygame.

Конечно не для всех игр подходит такой прием, но в некоторых очень даже.

Создадим модуль speech.

В нем организуем два варианта работы:

• подключение к экранному диктору NVDA через его Controller dll;
• напрямую на синтезатор windows через SAPI5;

Сначала импортируем все необходимые модули.
Для подключения nvdaControllerClient32.dll нам нужен ctypes.

import ctypes

А при отсутствии NVDA на компьютере, работаем напрямую с синтезатором SAPI через win32api.

import win32com.client

Создаем класс для нашей говорилки.

class Speech:

    def __init__(self, config):
        """Initialize speech class."""
        self.config = config

Здесь наверно надо пояснить про config. В общем классе Game, который занимается инициализацией всех модулей игры и крутит основной цикл, идет загрузка настроек игры.

Настройки можно загружать откуда удобнее: ini файлы, json, sqlite, или любой другой удобный вариант.

Но продолжим инициализацию нашего Speech.

        # подключаем синтезатор как COM объект.
        self.speaker = win32com.client.Dispatch("Sapi.SpVoice")
        # Получаем все доступные синтезаторы в системе и сохраняем в списке
        self.voices = self.speaker.GetVoices()
        # Создаем список имен полученных голосов
        self.voices_names = [voice.GetDescription() for voice in self.voices]

Настроим подключенный синтезатор некоторыми параметрами из настроек.
В данном примере я беру просто индекс установленного голоса (установленный по умолчанию имеет индекс 0), но можно сделать настройки с выбором из выпадающего списка по имени, полученных как описывалось выше.

Скорость голоса устанавливается в диапозоне от -10 до +10. Но не думаю, что кто-то захочет слушать голос со скоростью ниже 5. Можете самостоятельно поэкспериментировать, меняя значение в настройках.

Ну и конечно громкость голоса. Тут стандартно от 0 до 100.

        self.set_voice(self.config.voice)
        self.speaker.Rate = self.config.rate
        self.speaker.Volume = self.config.volume

Ну и наконец инициализируем nvda.

        self.nvda = self.config.nvda
        self.nvda_error = False
        self.sLib = ctypes.windll.LoadLibrary('./nvdaControllerClient32.dll')

Сразу проверяем может ли наша программа подключиться к работающей программе NVDA.

        nvda_error = self.sLib.nvdaController_testIfRunning()
        errorMessage = str(ctypes.WinError(nvda_error))
        if 0 != nvda_error:
            print('NVDA error: ' + errorMessage)
            self.nvda_error = True

После того как проинициализировали и синтезатор SAPI, и nvda dll можно запустить функцию выбора аудио вывода речи.

        self.set_speak_out()
        

Добавим функцию установки голоса из списка доступных по индексу.

    def set_voice(self, index):
        """Set voice for speak."""
        try:
            self.speaker.Voice = self.voices[index]
            self.speak_sapi(self.voices_names[index])
        except:
            print('error: do not set voice')

А теперь функция по выбору аудио вывода речи. Тут мы собственно и выбираем, что будем использовать для работы: nvda или синтезатор напрямую.

Выбор заключается в двух параметрах:

• Флаг в настройках, хочет ли пользователь вообще чтоб игра использовала NVDA;
• Возможные ошибки при подключении к NVDA;

    def set_speak_out(self):
        """Set speak out: nvda or sapi."""
        if self.nvda and not self.nvda_error:
            self.speak = self.speak_nvda
        else:
            self.speak = self.speak_sapi

Ну и конечно пропишем функции произношения.

Для NVDA:

    def speak_nvda(self, phrase):
        self.sLib.nvdaController_speakText(phrase)

А это функция для произношения напрямую на синтезатор:

    def speak_sapi(self, phrase):
        self.speaker.Speak(phrase)

Вот и все. Теперь в любом месте игровой логики отправляем нужную информацию на speech.speak().

Надеюсь данная статья кому-то окажется полезной и будет появляться больше доступных игр.