FolioTier 1
voice
Play a voice clip on the voice channel via `sound play <ref> on voice` (a dedicated auto-attach `voice` verb is planned).
Use this pattern to play a character's recorded dialogue on the dedicated voice channel. You trigger it by calling the general sound play construct with the voice channel specified, immediately before the matching say or narrate line. The voice channel is designed for spoken lines - it behaves differently from the music and ambient channels in ways that will matter once the planned voice verb is available.
Because the dedicated voice verb is not yet implemented, you are responsible for placing the sound play call in the right position yourself. If you put it even one line too early or too late, the audio and the text line fall out of sync visually. The safest habit is to keep the sound play call and its matching say or narrate line adjacent with nothing between them. Also be aware that if a player skips or fast-forwards through dialogue, the voice channel does not automatically stop the clip - you may want to account for that in scenes where fast-forwarding is likely.
Placeholder. The parser does not accept voice as a top-level verb
today - a Ren'Py voice directive imports as an audio cue on the
voice channel (sound play <ref> on voice) instead. This page documents the
intended shape so future contributors share a target.
Parameters
| Parameter | Kind | Required | Default | Notes |
|---|---|---|---|---|
| reference | string | yes | - | Audio reference for the voice clip, played on the `voice` channel with `sound play <ref> on voice`. A dedicated `voice` verb that auto-attaches the clip to the next `say` / `narrate` line is planned but not yet implemented. |
Canonical example
sound play "scene-1/emma-001.ogg" on voice
say "Emma": "I missed you."voice "scene-1/emma-001.ogg"
e "I missed you."When this construct ships, voice "<ref>" will be a standalone line
that sets up the next say line to play a voice clip in sync
with its dialogue. The auto-attachment semantics match Ren'Py's
voice directive: the clip starts when the line displays and stops
on advance; lines without their own preceding voice directive play
silently.
Notes
Today a Ren'Py voice directive lowers to a plain audio cue on the
voice channel, so the clip plays but nothing binds it to the next
line. When the construct ships, the importer will attach it directly.
A voice sustain extension (Ren'Py's "keep the voice playing across
multiple says" form) is out of scope for the initial implementation
and will be tracked as a follow-up if the corpus shows demand.