Translations by baekansi

This is done by creating voice files that match the identifier for each line of dialogue. To determine the identifiers to use , first export the dialogue to a spreadsheet by choosing from the launcher "Extract Dialogue", "Tab-delimited Spreadsheet (dialogue.tab)", and "Continue". This will produce a file, dialogue.tab, that can be loaded in a spreasheet program.

Voice

Ren'Py includes support for playing back voice in conjunction with dialogue. This is done through the voice statement, which gives the voice filename to play::

Normally, a playing voice is stopped at the start of the next interaction. The voice sustain statement can sustain voice playback through an interaction. ::

The :var:`config.voice_filename_format` variable allows you to customize the voice filename, making it possible to omit directories and extensions.

Voice Tags

Ren'Py includes a voice tag system that makes it possible to selectively mute or unmute a character's voice. To take advantage of this system, supply a voice_tag argument to each :func:`Character`, and use the :func:`SetVoiceMute` or :func:`ToggleVoiceMute` actions to allow the player to toggle the voice.

For example::

Automatic Voice

Ren'Py includes support for automatically determining the voice file to play, making it possible to play back voice without having to put voice statements before each line of dialogue.

This is done by creating voice files that match the identifier for each line of dialogue. To determine the identifiers to use , first export the dialogue to a spreadsheet by choosing from the launcher "Extract Dialogue", "Tab-delimited Spreadsheet (dialogue.tab)", and "Continue". This will produce a file, dialogue.tab, that can be loaded in a spreadsheet program.

The first column of the spreadsheet is the identifier to use, with other columns giving more information about the dialogue.

To make Ren'Py automatically play voices, set :var:`config.auto_voice` to a string containing `{id}`. When dialogue occurs, `{id}` is replaced with the dialogue identifier, forming a filename. If the filename exists, it is played.

For example, if we have::

And the dialogue identifier is ``demo_minigame_03fc91ef``, then when the corresponding line is shown, Ren'Py will look for the file ``voice/demo_minigame_03fc91ef.ogg``. If the file exists, Ren'Py will play it.

Voice Functions

Plays `filename` on the voice channel. The equivalent of the voice statement.

`filename`

The filename to play. This is used with :var:`config.voice_filename_format` to produce the filename that will be played.

`tag`

If this is not None, it should be a string giving a voice tag to be played. If None, this takes its default value from the voice_tag of the Character that causes the next interaction.

The voice tag is used to specify which character is speaking, to allow a user to mute or unmute the voices of particular characters.

Returns true if it's possible to replay the current voice.

Replays the current voice, if possible.

The equivalent of the voice sustain statement.

Voice Actions

If `mute` is true, mutes voices that are played with the given `voice_tag`. If `mute` is false, unmutes voices that are played with `voice_tag`.

Toggles the muting of `voice_tag`. This is selected if the given voice tag is muted, unless `invert` is true, in which case it's selected if the voice is unmuted.

Replays the most recently played voice.