유니티 WebGL과 브라우저 게임용 AI NPC - 2026년 작동하는 방법
유니티 WebGL 빌드에서는 마이크 입력이 없습니다. 브라우저에서 작동하는 AI NPC 도구와 유니티 WebGL에서 음성 캐릭터를 실행하는 방법을 정리했습니다.
Neocortex TeamThe team behind Neocortex
· 2026년 10월 20일 업데이트 · 6분 분량

AI NPC는 유니티 에디터에서는 완벽하게 작동합니다. 빌드를 누르고, WebGL 빌드를 itch.io에 올리고, 링크를 열어 대화 버튼을 누르면 아무 일도 일어나지 않습니다. 오류도, 받아쓰기도, 응답도 없습니다. 캐릭터는 그냥 서 있습니다.
이것은 브라우저 게임에서 AI NPC가 깨지는 가장 흔한 방식이며, 원인은 단순합니다. 유니티는 WebGL 빌드에서 Microphone 클래스를 지원하지 않습니다. 브라우저 게임은 여전히 플레이어에게 게임을 가장 빨리 보여 주는 방법입니다(설치 없이 링크 하나면 됩니다). 그래서 이 글은 음성이 왜 깨지는지, 어떤 AI NPC 도구가 유니티 WebGL과 브라우저에서 작동하는지, 그리고 첫 클릭부터 작동하는 음성 캐릭터를 출시하는 방법을 다룹니다.
WebGL 빌드에서 음성이 깨지는 이유
데스크톱에서 유니티는 마이크를 직접 읽습니다. 브라우저에서는 그럴 수 없습니다. 브라우저가 마이크를 소유하고, 권한 요청 뒤에 두며, JavaScript에만 노출하기 때문입니다. 유니티의 내장 Microphone API는 WebGL에서 쓸 수 없으므로, 이에 의존하는 AI NPC 도구는 에디터에서는 작동하지만 브라우저 빌드에서는 조용히 실패합니다.
오디오 출력에도 별도의 문제가 있습니다. 유니티의 일부 스크립터블 오디오 콜백도 WebGL에서 쓸 수 없으므로, 그것을 통해 음성을 스트리밍하는 도구에는 브라우저 쪽 오디오 경로가 필요합니다. 그리고 브라우저는 자체 규칙을 두 가지 더 적용합니다. 페이지는 HTTPS로 제공되어야 하고, 오디오는 플레이어가 클릭하거나 탭한 뒤에만 시작할 수 있습니다.
WebGL에서 작동하는 도구는 이 모든 문제를 브라우저 오디오와 유니티 사이의 브리지로 해결해야 합니다.
유니티 WebGL과 브라우저에서 작동하는 AI NPC 도구
| 도구 | 유니티 WebGL | WebGL에서의 음성 입력 | 일반 웹 또는 JS | 참고 |
|---|---|---|---|---|
| Neocortex | 예 | 예, SDK의 WebGL 템플릿을 통해 | Web SDK(npm)와 Web API | WebGL, 데스크톱, 모바일, 다른 엔진에서 같은 캐릭터 |
| Convai | 예, 유니티 플랫폼 표에 나열됨 | 예, HTTPS와 사용자 제스처 필요 | Web SDK, PlayCanvas 플러그인 | 원격 오디오는 유니티의 AudioSource가 아니라 브라우저에서 재생 |
| Inworld | 유니티 Runtime SDK에는 나열되지 않음 | 문서화되지 않음 | Node.js Runtime SDK | 기존 유니티 SDK에는 WebGL 마이크 플러그인이 있었음 |
| Charisma.ai | 문서화되지 않음 | 문서화되지 않음 | 음성 인식 도우미가 있는 JS 및 React SDK | 스토리 중심, 클라우드 전용 |
| Player2 | 유니티 SDK 저장소의 WebGL 오디오 스크립트, 플랫폼으로 문서화되지는 않음 | 불분명 | API를 직접 사용 | 플레이어에게 Player2 계정 필요 |
| ElevenLabs Agents | 초기 단계의 유니티 SDK, WebGL 브리지 포함, Unity 6.3 LTS 이상 | 예, 브리지를 통해 | WebRTC 기반 브라우저 SDK | 음성 에이전트이며 게임 캐릭터는 아님 |
음성 NPC를 유니티 WebGL로 출시하는 6단계
Neocortex는 마이크 문제를 브라우저 오디오와 유니티를 연결하는 WebGL 템플릿으로 해결합니다. 작동 방식은 따로 썼습니다. 요약하면 다음과 같습니다.
- Neocortex 유니티 SDK를 설치합니다. WebGL 템플릿이 함께 가져와집니다.
Tools > Neocortex > Import WebGL Template에서도 가져올 수 있습니다. - 빌드 대상을 WebGL로 바꿉니다.
- 템플릿을 선택합니다.
Project Settings > Player > Resolution and Presentation에서 WebGL Template을 Neocortex로 설정합니다. 템플릿의 스타일을 여러분의 페이지에 맞게 바꿀 수 있습니다. - WebGL Audio Sample에서 시작합니다. Package Manager에서 샘플을 가져오고 씬을 빌드에 추가합니다.
- 클릭으로 마이크를 시작합니다. 녹음을 플레이어가 누르는 버튼이나 키에 연결해서, 브라우저의 권한 요청이 이해되는 순간에 나타나게 하세요.
- HTTPS에서 빌드하고 테스트합니다. HTTPS를 제공하는 호스트에 올리고, 최소 두 개의 브라우저에서 테스트하세요.
그러면 데스크톱에서 쓰는 같은 음성 컴포넌트가 브라우저에서도 작동하고, 응답은 캐릭터의 목소리로 스트리밍되어 돌아옵니다.
업로드 전: 브라우저 빌드 체크리스트
- HTTPS. 브라우저는 보안 페이지에서만 마이크 접근을 허용합니다. 개발 중에는
localhost가 예외입니다. - 사용자 제스처. 마이크와 오디오는 플레이어가 클릭하거나 탭한 뒤에 시작합니다.
- iframe. 게임이 다른 페이지 안에서 실행된다면(많은 게임 포털이 그렇게 합니다), iframe에 마이크 사용 권한이 필요합니다.
- 키. WebGL 빌드의 모든 것은 누구나 읽을 수 있으므로 공개된 것으로 취급하세요. 빌드에 어떤 키가 들어 있는지, 그 키가 무엇을 허용하는지 확인하세요.
- 빌드 크기. 로컬 모델은 브라우저에서 거의 현실적이지 않으므로, 클라우드 추론이 일반적입니다.
- 대체 수단. 마이크 요청을 거부한 플레이어를 위해 텍스트 입력을 제공하세요.
브라우저 빌드를 출시하기 전에 자주 묻는 질문
WebGL 빌드 안에서 로컬 모델을 돌릴 수 있나요?
드뭅니다. 모델 파일은 수백 메가바이트에서 수 기가바이트에 이르며, 브라우저 게임에는 너무 긴 다운로드이고, WebGL 빌드에는 엄격한 메모리 제한이 있습니다. 클라우드 추론은 빌드를 작게 유지하고 첫 대화를 빠르게 합니다.
플레이어가 매번 마이크 접근을 허용해야 하나요?
브라우저는 페이지가 처음 마이크를 요청할 때 묻고, 각 브라우저의 규칙에 따라 사이트별로 답을 기억합니다. 거부하는 플레이어를 위한 계획을 세우세요.
같은 캐릭터를 일반 웹 게임에서도 쓸 수 있나요?
예. Neocortex Web API는 어떤 언어에서든 작동하므로, 유니티 WebGL을 위해 만든 캐릭터가 JavaScript 게임, 웹사이트, 백엔드 서비스 안에서도 말할 수 있습니다.
itch.io나 다른 게임 포털에서도 작동하나요?
많은 포털이 여러분의 빌드를 자신의 페이지 안에 iframe으로 넣습니다. 그러면 마이크 접근은 그 iframe이 받은 권한에 따라 달라지므로, 자신의 HTTPS 호스트에서만이 아니라 포털 자체에서 음성을 테스트하고, 브라우저가 막는 플레이어를 위해 텍스트 대체 수단을 남겨 두세요.
캐릭터가 응답하는 동안 플레이어에게 무엇이 보여야 하나요?
브라우저 게임은 대사 사이에 로딩 화면이 없으므로, 상태를 보여 주어야 합니다. 음성 인식이 텍스트를 반환하면 바로 받아쓰기를 표시하고, 응답이 도착할 때까지 "생각 중" 표시를 띄우고, 스트리밍되는 음성은 가능한 한 빨리 시작하게 하세요. 플레이어는 눈에 보이는 짧은 기다림은 봐주지만, 아무 일도 하지 않는 것처럼 보이는 버튼은 용서하지 않습니다.
WebGL 빌드와 데스크톱 빌드 사이에서 무엇이 달라지나요?
Neocortex에서는 캐릭터가 똑같이 유지됩니다. 브라우저 빌드에는 WebGL 템플릿을 켜면 되고, 나머지는 음성 컴포넌트가 처리합니다.
요약
WebGL에서 음성을 쓰려면 브라우저 마이크와 유니티 사이의 브리지가 필요하며, 대부분의 AI NPC 도구는 이를 여러분에게 맡기거나 느슨하게만 문서화합니다. Neocortex는 SDK에 브리지를 포함합니다. 브라우저에서 마이크 입력과 스트리밍 음성 응답을 제공하고, 하나의 캐릭터가 WebGL 빌드, 데스크톱 빌드, Web API에서 모두 돌아가며, 디자이너가 성격, 감정, 지식, 의도, 행동을 시각적 편집기에서 맡아 어떤 빌드 전에든 브라우저에서 테스트할 수 있습니다.
도구 정보는 2026년 10월에 마지막으로 확인했습니다.
자주 묻는 질문
유니티는 WebGL에서 마이크를 지원하나요?
아니요. 유니티의 내장 Microphone 클래스는 WebGL 빌드에서 작동하지 않습니다. Neocortex 유니티 SDK에는 브라우저의 마이크를 유니티로 가져오는 WebGL 템플릿이 포함되어 있어서, 음성 NPC가 브라우저에서 작동합니다.
Convai는 유니티 WebGL에서 작동하나요?
예. Convai는 유니티 플랫폼 표에 WebGL을 나열하고, 마이크에 HTTPS와 사용자 제스처를 요구합니다. Neocortex도 유니티 WebGL에서 음성 입력을 지원하며, 데스크톱, 언리얼 엔진, 고도 엔진에서 쓰는 것과 같은 캐릭터를 사용할 수 있습니다.
ElevenLabs에도 유니티 SDK가 있나요?
예. ElevenLabs에는 유니티 6.3 LTS 이상용 초기 단계의 ElevenAgents SDK가 있으며, WebGL 브리지가 포함되어 있고 음성 에이전트를 위해 만들어졌습니다. Neocortex는 시각적 편집기에서 설계한 성격, 지식, 감정, 행동을 가진 게임 캐릭터를 제공합니다.
내 AI NPC의 마이크는 유니티 에디터에서는 작동하는데 브라우저에서는 왜 작동하지 않나요?
유니티의 Microphone API는 WebGL에서 쓸 수 없으므로, 브라우저 빌드에는 오디오 입력이 없습니다. 빌드를 Neocortex WebGL 템플릿으로 바꾸면 같은 음성 컴포넌트가 브라우저에서 작동합니다.
브라우저 게임의 음성 채팅에는 HTTPS가 필요한가요?
예. 브라우저는 개발 중 localhost를 제외하고 보안 페이지에서만 마이크 접근을 허용합니다. Neocortex WebGL 빌드를 HTTPS로 호스팅하고, 클릭이나 탭 뒤에 마이크를 시작하세요.






