自動語音 link

Ren’Py支持自動語音模式。在自動語音模式下使用一個語音合成器朗讀出文本和其他介面元素。這個功能能讓有視力缺陷的人也能使用Ren’Py遊戲。

自動語音模式可以按 v 鍵切換開關。

處於自動語音模式時，鍵盤導航會發生變化，上下方向鍵會讓循環經過界面上所有可獲得焦點的可視組件。

當某個可視組件獲得焦點時，Ren’Py會大聲朗讀出與那個可視組件關聯的文本。如果沒有可視組件獲得焦點，Ren’Py會讀出界面上無法獲得焦點的文本內容。自動語音透過這種方式大體上覆蓋了構成遊戲的所有對話和文本。

語音合成 link

Ren’Py針對不同的操作系統提供不同的語音合成服務。要調整語音合成的速度和使用的聲音，就需要調整對應平台的語音設置。

Windows: 在Windows平台上，Ren’Py使用微軟語音API。在控制面板“語音識別”中“文本到語音轉換”標籤可以修改語音合成的設置。
Mac OS X: 在Mac OS X平台，Ren’Py使用 say 命令。在“Dictation & Speech”控制面板的“Text to Speech”標籤可以修改語音合成設置。
Linux: 在Linux平台上，Ren’Py使用 espeak 命令。在自動語音模式運行之前，需要先使用package管理器安裝espeak。
Android, iOS, Chrome OS: 在安卓、iOS和Chrome OS上不支持自動語音模式。

默認聲音可以在對應平台的基本設置中選擇，使用 config.tts_voice 配置項。舉例：

init python:

    if renpy.windows:
        config.tts_voice = "Mark"
    elif renpy.macintosh:
        config.tts_voice = "Alex"
    elif renpy.linux:
        config.tts_voice = "english_rp"

可用的聲音與平台有關。

創作者關注點 link

Ren’Py的自動語音會從可視組件中剝離文本並向閱讀給用戶。Ren’Py從兩個地方剝離文本。

Text displayables: Ren’Py會從文本組件剝離文本，並讓文本可以向用戶閱讀。

Alternative text

轉換文本由可視組件的 alt 樣式特性提供。還可以通過按鈕(button)上的行為 Action 和條(bar) BarValue 的值來獲取。顯示提供的轉換文本優先於行為和值的文本，從文本組件中的自帶文本優先度最低。

轉換文本會使用Ren’Py的字串多語言支持機制進行翻譯。轉換文本的優先度高於從可視組件及其子組件剝離出的文本，不過從文本組件剝離出的問題可以使用“[text]”型字串替換。其他文本都不允許使用字串替換。

例如：
screen information(message, planet, badness):
    text message:
        color color_from_badness(badness)
        alt "Information for you : [text]. Badness is " + str(badness)

    text "ORIGIN_OF_MESSAGE_{color=#f00}[planet!u]{/color}":
        alt "Origin of message is " + planet
在上例中，變數 badness 和 planet 都不能直接使用“[badness]”替換。把所有變數連成一個字串，是個解決方法。

傳入Character對象的 who_alt 和 what_alt 參數將alt樣式特性分別設置為角色的名字文本和身體文本。舉個例子，我們定義了一個角色使用斜體表示其內心想法，但通過自動語音顯示表現其想法：
define thought = Character(None, what_italic=True, what_alt="I think, [text]")
界面中的可視組件可能會帶有 group_alt 特性。帶有該特性匹配前綴的可視組件首次獲得焦點時，將播放設置的文本轉語音。但相同前綴的組件獲得焦點後不會重複播放，直到不同前綴的組件獲得焦點。

可視組件可能還會帶有 extra_alt 特性。當該可視組件獲得焦點且按下鍵盤問號鍵時，將播放額外的語音資訊。

Descriptive Text

描述文本是啟用自動語音功能後，通過旁白顯示(或表述)的文本內容。如果禁用自動語音則文本不顯示。自動語音文本使用變數 alt ，與角色的定義過程類似。

alt = ... link: 一個類角色的對象，啟動自動語音的情況下會唸出旁白的文本。

舉例：

e "Hang on, this is gonna be a bumpy ride!"

alt "And then the sun exploded..."

# 一個複雜而且亦可賽艇的特寫場景。
show event sun_exploding
pause 10

有一個配置項變數控制描述文本：

define config.descriptive_text_character = None link: 若不是None，該項應該是一個用於顯示描述文本角色對象，且不是旁白。

使用快捷鍵shift+alt+V可以啟用自動語音的debug模式。debug模式下會顯示界面中會播放語音的文本，用於開發需求。

Python link

自動語音系統中包含下列函數：

renpy.alt(s, translate=True, force=False) link

以語音形式播放序列 s。若 translate 為True，播放語音前會轉換成當前系統語言類型對應的文本。若 force 為True，禁用自動語音情況下依然可以播放語音。

該函數主要用於功能測試，不應用於實際遊戲中。