Stage Say
stage_saySends captions or spoken messages to a performer, queuing them by scene and showing sender-styled text in desktop or VR so agents can deliver cues without disrupting takes.
Instructions
Tell the person something (page command: say). Desktop: a caption, one at a time, queued, shown only while the tab is visible. VR (or voice=True on the desktop): also spoken by Kokoro (voice_name picks the voice; the server default is af_heart), and in VR shown for min(120, 25 + 0.8 x words) seconds as a caption panel. A line that waited 20 s or more in the queue is captioned, not spoken; 60 s or more, no VR panel either. Page replies {captions_ahead}, plus {spoken: false, stale_s} for a stale line. Emits: voice_spoken, voice_hushed (the person started a voice note mid-line), voice_dropped, voice_error, and in VR panel_shown and panel_closed. sender= your name as the person should see it (e.g. "crossroads film"): the caption and its VR card say it, in that name's colour, on that name's side of their body. While the person performs (someone follows them) the line is shown, not spoken, since it would be in the recording (page replies held: ...); aloud=True speaks it anyway (an answer they asked for).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| aloud | No | ||
| scene | Yes | ||
| voice | No | ||
| sender | No | ||
| seconds | No | ||
| voice_name | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |