Neocortex Logo

ИИ-NPC для Unity WebGL и браузерных игр в 2026

В сборках Unity WebGL нет доступа к микрофону. Какие инструменты ИИ-NPC работают в браузере и как запустить озвученного персонажа в Unity WebGL.

Neocortex TeamThe team behind Neocortex

· Обновлено 20 окт. 2026 г. · 6 мин чтения

В сборках Unity WebGL нет доступа к микрофону. Какие инструменты ИИ-NPC работают в браузере и как запустить озвученного персонажа в Unity WebGL.

Ваш ИИ-NPC прекрасно работает в редакторе Unity. Вы нажимаете Build, загружаете сборку WebGL на itch.io, открываете ссылку, нажимаете кнопку разговора, и ничего не происходит. Ни ошибки, ни транскрипта, ни ответа. Персонаж просто стоит на месте.

Это самый частый способ, которым ИИ-NPC ломаются в браузерных играх, и причина простая: Unity не поддерживает класс Microphone в сборках WebGL. Браузерные игры по-прежнему самый быстрый способ показать игру игрокам (без установки, по одной ссылке), поэтому этот пост объясняет, почему ломается голос, какие инструменты ИИ-NPC работают в Unity WebGL и в браузере и как выпустить озвученного персонажа, который работает с первого клика.

Почему голос ломается в сборках WebGL

На десктопе Unity читает микрофон напрямую. В браузере так не получится: браузер владеет микрофоном, ставит его за запрос разрешения и открывает только для JavaScript. Встроенный API Microphone в Unity в WebGL недоступен, поэтому любой инструмент ИИ-NPC, который на него опирается, работает в редакторе и тихо не работает в вашей браузерной сборке.

У вывода аудио тоже есть своя особенность. Некоторые скриптовые аудио-колбэки Unity в WebGL тоже недоступны, поэтому инструментам, которые передают речь через них, нужен аудиопуть на стороне браузера. К тому же браузеры вводят два собственных правила: страница должна открываться по HTTPS, а звук может начаться только после того, как игрок нажмет или коснется экрана.

Инструмент, который работает в WebGL, должен решить все это с помощью моста между аудио браузера и Unity.

Какие инструменты ИИ-NPC работают в Unity WebGL и в браузере

ИнструментUnity WebGLГолосовой ввод в WebGLОбычный веб или JSПримечания
NeocortexДаДа, через шаблон WebGL в SDKWeb SDK (npm) и Web APIТе же персонажи в WebGL, на десктопе, мобильных устройствах и в других движках
ConvaiДа, указан в его матрице платформ для UnityДа, нужен HTTPS и действие пользователяWeb SDK, плагин PlayCanvasУдаленное аудио воспроизводится через браузер, а не через AudioSource Unity
InworldНе указан для Unity Runtime SDKНе описано в документацииNode.js Runtime SDKВ прежнем Unity SDK был плагин микрофона для WebGL
Charisma.aiНе описано в документацииНе описано в документацииJS- и React-SDK с помощниками распознавания речиОриентирован на историю, только облако
Player2Аудиоскрипты WebGL в репозитории Unity SDK, не указаны как платформаНеясноИспользовать API напрямуюИгрокам нужны аккаунты Player2
ElevenLabs AgentsРанний Unity SDK с мостом WebGL, Unity 6.3 LTS или новееДа, через мостБраузерный SDK поверх WebRTCГолосовые агенты, а не игровые персонажи

Выпустите озвученного NPC в Unity WebGL за шесть шагов

Neocortex решает проблему с микрофоном с помощью шаблона WebGL, который соединяет аудио браузера с Unity. О том, как это работает, мы писали в посте поддержка микрофона в Unity WebGL. Вкратце:

  1. Установите Neocortex Unity SDK. Шаблон WebGL импортируется вместе с ним. Его также можно импортировать через Tools > Neocortex > Import WebGL Template.
  2. Переключите целевую платформу сборки на WebGL.
  3. Выберите шаблон. В Project Settings > Player > Resolution and Presentation установите WebGL Template на Neocortex. Внешний вид шаблона можно изменить под свою страницу.
  4. Начните с WebGL Audio Sample. Импортируйте примеры из Package Manager и добавьте сцену в сборку.
  5. Запускайте микрофон по клику. Привяжите запись к кнопке или клавише, которую нажимает игрок, чтобы запрос разрешения браузера появлялся в понятный момент.
  6. Соберите и проверьте по HTTPS. Загрузите на хост с HTTPS и проверьте как минимум в двух браузерах.

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

Перед загрузкой: чек-лист браузерной сборки

  • HTTPS. Браузеры разрешают доступ к микрофону только на защищенных страницах. Исключение - localhost во время разработки.
  • Действие пользователя. Микрофон и звук запускаются после того, как игрок нажмет или коснется экрана.
  • Iframe. Если игра работает внутри другой страницы (так делают многие игровые порталы), iframe нужно разрешение на использование микрофона.
  • Ключи. Считайте все в сборке WebGL публичным, потому что его может прочитать любой. Проверьте, какие ключи содержит сборка и что они разрешают.
  • Размер сборки. Локальные модели в браузере редко практичны, поэтому нормой является облачный вывод.
  • Запасной вариант. Предложите текстовый ввод для игроков, которые отказались от запроса микрофона.

Частые вопросы перед выпуском браузерной сборки

Можно ли запустить локальную модель внутри сборки WebGL?

Редко. Файлы моделей весят от сотен мегабайт до нескольких гигабайт, что долго загружать для браузерной игры, а у сборок WebGL жесткие лимиты памяти. Облачный вывод сохраняет сборку маленькой и первый разговор быстрым.

Должны ли игроки разрешать доступ к микрофону каждый раз?

Браузеры спрашивают при первом запросе микрофона со страницы и запоминают ответ для сайта по собственным правилам каждого браузера. Закладывайте вариант, когда игрок скажет «нет».

Можно ли использовать того же персонажа в обычной веб-игре?

Да. Web API Neocortex работает из любого языка, поэтому персонаж, которого вы создали для Unity WebGL, может также разговаривать внутри JavaScript-игры, на сайте или в серверном сервисе.

Будет ли это работать на itch.io и других игровых порталах?

Многие порталы встраивают вашу сборку в iframe на своей странице. Доступ к микрофону тогда зависит от разрешений этого iframe, поэтому проверяйте голос на самом портале, а не только на своем хосте с HTTPS, и сохраняйте текстовый запасной вариант для игроков, у которых браузер его блокирует.

Что должны видеть игроки, пока персонаж отвечает?

В браузерной игре нет экрана загрузки между репликами, поэтому показывайте состояние. Выводите транскрипт сразу, как только распознавание речи его вернет, показывайте индикатор «думает», пока не придет ответ, и запускайте потоковый голос как можно раньше. Игроки прощают короткое ожидание, которое видят. Кнопку, которая как будто ничего не делает, они не прощают.

Что меняется между сборкой WebGL и десктопной сборкой?

С Neocortex персонаж остается тем же. Для браузерных сборок вы включаете шаблон WebGL, а остальное делают голосовые компоненты.

Короткий итог

Голос в WebGL требует моста между микрофоном браузера и Unity, и большинство инструментов ИИ-NPC оставляют это вам или описывают нечетко. Neocortex поставляет мост в составе SDK: ввод с микрофона и потоковые голосовые ответы в браузере, один персонаж, который работает в вашей сборке WebGL, в десктопной сборке и через Web API, а также визуальный редактор, где дизайнеры владеют характером, эмоциями, знаниями, намерениями и действиями и проверяют их в браузере до любой сборки.

Данные об инструментах в последний раз проверялись в октябре 2026 года.

Частые вопросы

Поддерживает ли Unity микрофон в WebGL?

Нет, встроенный класс Microphone в Unity не работает в сборках WebGL. Unity SDK от Neocortex включает шаблон WebGL, который подключает микрофон браузера к Unity, поэтому голосовые NPC работают в браузере.

Работает ли Convai в Unity WebGL?

Да, Convai указывает WebGL в своей матрице платформ для Unity и требует HTTPS и действие пользователя для микрофона. Neocortex также поддерживает голосовой ввод в Unity WebGL, с теми же персонажами, которых вы используете на десктопе, в Unreal и в Godot.

Есть ли у ElevenLabs SDK для Unity?

Да, у ElevenLabs есть ранний SDK ElevenAgents для Unity 6.3 LTS и новее, с мостом WebGL, созданный для голосовых агентов. Neocortex дает игровых персонажей с характером, знаниями, эмоциями и действиями, которые задаются в визуальном редакторе.

Почему микрофон моего ИИ-NPC работает в редакторе Unity, но не в браузере?

API Microphone в Unity недоступен в WebGL, поэтому в браузерной сборке нет аудиовхода. Переключите сборку на шаблон WebGL Neocortex, и те же голосовые компоненты заработают в браузере.

Нужен ли HTTPS для голосового чата в браузерных играх?

Да, браузеры разрешают доступ к микрофону только на защищенных страницах, за исключением localhost во время разработки. Размещайте сборку Neocortex WebGL по HTTPS и запускайте микрофон после клика или касания.

Похожие статьи

Читайте также