Your game backend decides who can hear whom. Wave delivers the voice: keys, access control, WebRTC signaling and STUN. No registration — everything is identified by a single API key.
No registration required. Paid plans are activated after payment (automated checkout is coming soon — until then an operator activates your order). The Free plan is active immediately.
1050_Hero). This is done by your backend team — the client cannot do it itself./voice with the key and the exact same player ID. Wave accepts it only if your backend announced this player.voice:peer-on. When they move apart — voice:peer-off.voice:signal. The relay works only between allowed pairs.| Method | Endpoint | Description |
|---|---|---|
| GET | /api/voice/plans | List available plans and prices |
| POST | /api/voice/order | Issue a key. Body: { plan, serverIp, label }. Returns the key, the secret (once), expiry and payment status |
| GET | /api/voice/key/:id/status | Key status: active / expired, online players, traffic stats |
| GET | /voice | Ready-made voice page for the launcher: ?key=...&player=...&auto=1 |
The fastest integration: point a WebView2 / iframe / browser window at the ready-made voice page. It handles the microphone, WebRTC, nearby list and text chat for you.
| Parameter | Required | Description |
|---|---|---|
key | yes | Your API key (wg-...) |
player | yes | Player ID — exactly the same string your game backend announces (URL-encode it) |
auto | no | 1 — try to enable the microphone automatically after the first user gesture |
/voiceConnection handshake: auth = { role: "player", key: "wg-...", playerId: "1050_Hero" }. The player is accepted only while the game backend keeps the player announced.
| Direction | Event | Description |
|---|---|---|
| YOU ← | voice:peer-on { playerId, name } | A player entered your hearing range — start a WebRTC call |
| YOU ← | voice:peer-off { playerId } | A player left the range — hang up |
| YOU ← | voice:peer-name { playerId, name } | Display name update for a connected peer |
| YOU → | voice:signal { to, data } | WebRTC signaling (offer / answer / ICE) to an allowed peer |
| YOU ← | voice:signal { from, data } | Incoming signaling from an allowed peer |
| YOU → | chat { text } | Text message to everyone currently in range (max 500 chars) |
| YOU ← | chat { from, text } | Incoming proximity text message |
| YOU ← | voice:error { error } | Key expired / character left the game / kicked |
Full reference implementation of the call logic. The deterministic initiator rule (myId < peerId creates the offer) prevents double offers when both players appear in range at the same moment.
| Error (connect_error / voice:error) | Meaning |
|---|---|
| ERR | Invalid key — the key does not exist |
| ERR | Key expired / Key revoked — renew or replace the key |
| ERR | Key not paid yet — the order is waiting for payment |
| ERR | Player not announced by game server — the character is not in the game |
| ERR | Key player limit — the CCU cap of the plan is reached |
| Limit | Value |
|---|---|
| Signaling messages | 30 / second per player |
| Chat messages | 5 / second, max 500 characters |
| Player ID format | A–Z a–z 0–9 _ -, length 2–80 |
| Online players | per plan: 30 / 50 / 100 / 500 / 1000 |
NuGet: Microsoft.Web.WebView2. The key is public and safe to ship in the launcher config. The secret must never be here.
Prefer your own infrastructure? We will deploy a dedicated Wave Voice instance on your own VPS and integrate it with your game — you own the server, the keys and the data. Or let us run it for you.
Player not announced by game server.<characterId>_<characterName>. The launcher must build exactly the same string.