Where a character can live
Four surfaces, one character. Same brain, same voice, same documents — different audience and different chrome.
| Surface | Who it's for | Needs a key? |
|---|---|---|
| Playground | You, while building | No — you're signed in |
| Embed | Visitors to your website | Not for a published character |
| Kiosk | An unattended touchscreen | Yes, built into the URL |
| Live room | A crowd talking to one character together | No |
Playground — for you
Opened from the character editor's Test in Playground button. Full conversation plus the 3D scene editor. Covered in Playground & scene editor.
Embed — on your website
The iframe from the character's Publish tab. Drop it into any page:
<iframe src="https://iamxlive.com/embed/YOUR_CHARACTER_ID"
width="400" height="600"
allow="microphone"></iframe>
The character must be Unlisted or Public for a keyless embed. A Private character needs a key added to the URL, which means the key is visible in your page source — only do that on pages you control.
Options you can add to the URL
| Option | Effect |
|---|---|
?chat=false | Hides the chat column, leaving just the character. Note this also removes the microphone button, so use it only for a display-only character. |
?speakerId=… | Identifies the visitor, so memory and emotional state follow a specific person across visits. Pass your own user ID here if you have one. |
?render=liveface / ?render=pixelstream | Forces a specific look, overriding what the character is set to. |
?apiKey=… | An authenticated session, required for a Private character and for LiveFace. |
Kiosk — an unattended screen
A fullscreen, self-healing layout for a touchscreen left running all day: no browser chrome, one large microphone button, the last couple of messages, and a small emotion readout. If the network drops it reconnects by itself.
https://iamxlive.com/kiosk/YOUR_CHARACTER_ID?apiKey=YOUR_IAMX_KEY
Build that URL by hand, create a dedicated API key for that device — one key per terminal, so you can revoke a single stolen machine — and set it as the browser's start page in kiosk mode.
Live room — everyone at once
A shared page where every visitor sees the same character and the same chat. People enter a name, then talk to it together — the character addresses them by name and replies in whatever language they write in.
https://iamxlive.com/live/YOUR_CHARACTER_ID
This is the surface behind a landing-page demo or a public installation. It is the only surface where visitors see each other's messages.
Choosing between them
| You want… | Use |
|---|---|
| To test a change you just made | Playground |
| A support assistant in the corner of your website | Embed |
| A greeter on a screen in your lobby | Kiosk |
| A demo everyone can try at once from a link | Live room |
| An NPC inside your game | The Unreal plugin |
| Something none of these cover | The WebSocket API |