VoiceLib

Библиотека преобразования речи в текст для Minecraft

Использование

Класс VoiceLibApi предоставляет основной API для работы. Вот основные методы, которые вам понадобятся:

VoiceLibApi.registerServerPlayerSpeechListener(Consumer<ServerPlayerTalkEvent> consumer)
Этот метод регистрирует обработчик события ServerPlayerTalkEvent. Событие срабатывает каждый раз, когда игрок говорит. ServerPlayerTalkEvent содержит информацию об игроке и текст сказанного.

VoiceLibApi.registerClientSpeechListener(Consumer<ClientTalkEvent> consumer)
Регистрирует обработчик ClientTalkEvent, который работает только на стороне клиента. Срабатывает, когда пользователь говорит.

VoiceLibApi.setPrintToChat(boolean printToChat)
Настраивает вывод событий речи в чат (только на клиенте). По умолчанию отключено.

VoiceLibApi.setPrintToConsole(boolean printToConsole)
Аналогично предыдущему, но для вывода в консоль. По умолчанию отключено.

Все методы снабжены JavaDoc с подробной информацией об использовании.

Пример

Вот пример, который поджигает любого игрока на сервере, если он скажет "ой":

VoiceLibApi.registerServerPlayerSpeechListener((serverPlayerTalkEvent -> {
    if (serverPlayerTalkEvent.getText().contains("ой"))
        serverPlayerTalkEvent.getPlayer().igniteForSeconds(2);
}));

Дополнительные примеры можно найти в VoiceLibExample.

Безопасность

Важные моменты, которые следует учитывать:

• При первом запуске мод автоматически загружает модель vosk из интернета (около 40 МБ)
• По умолчанию мод постоянно записывает и отправляет все текстовые данные на сервер. Это означает, что злоумышленник может прослушивать ваши разговоры (только в текстовом виде, аудио не передается)
• Клавиша "push to talk" по умолчанию инвертирована - нажатие выключает микрофон
• Другие моды могут принудительно включить постоянную запись или отключить её (см. VoiceLibClient)