[閒聊] NVDA 2025.1 版本發布 - 討論區

2025.1
此版本推出了「NVDA 遠端存取」功能，讓您可以透過一台執行 NVDA 的裝置，控制另一台同樣執行 NVDA 的遠端電腦。
語音方面有許多改善，特別是提升了 SAPI 4、SAPI 5 及 OneCore 語音的回應速度。 SAPI 5 現在支援加快語速與自動語言切換。 SAPI 4 語音現在支援自動音量調整、去除開頭靜音，以及保持音訊裝置喚醒。
附加元件商店的自動更新系統已獲改善，讓您可以選取自動更新通道，並在背景中執行自動更新。
新增了手動更新 OCR 結果，以及切換是否定期更新 OCR 結果的指令。
Chrome 和 Edge 現在支援原生選取。
對 Microsoft Office 和 LibreOffice 的支援已改善，尤其是會讀出更多快捷鍵。
現在可以根據 NVDA 的語言來設定預設的輸入和輸出點字表。新增對 Dot Inc. 的 Dot Pad 觸覺圖形裝置的原生支援，可作為多行點字顯示器使用。點字顯示器方面亦有其他小修正，尤其是在連線能力上。
LibLouis 點字轉譯表、eSpeak-NG 及 Unicode CLDR 均已更新。新增了科普特文、精簡楔形文字，以及葡萄牙文六點電腦點字的點字表。
重要聲明
• 此版本會破壞與現有附加元件的相容性。
安全性修正
請依照 NVDA 的安全性政策，負責任地揭露安全問題。
• 防止在系統鎖定時，於點字顯示器上顯示潛在敏感資訊。 (GHSA-8f8q-2jc3-6rf4)
• 防止安裝程式從其目錄載入非預期的 DLL。 (GHSA-qf5h-qw92-rx2f)
新功能
• 附加元件商店：
◦ 自動更新 (#3208)：
▪ 現在可以修改附加元件的自動更新通道。
▪ 已安裝附加元件的自動更新通道，可透過「更新通道」子功能表來選取。
▪ 預設的自動更新通道，可在 NVDA 設定的附加元件商店中設定。
▪ 自動更新現在可以在背景中進行。
▪ 此功能可在 NVDA 設定的「附加元件商店」中，將「自動更新」選項變更為「自動更新」來啟用。
▪ 自動更新現在能將不相容的附加元件，更新為另一個較新的不相容版本。
▪ 此功能可在 NVDA 設定的附加元件商店中啟用。
◦ 新增了取消附加元件安裝的操作。 (#15578, @hwf1324)
◦ 新增當附加元件下載/安裝失敗時重新嘗試的操作。 (#17090, @hwf1324)
◦ 附加元件清單可以依欄位排序，包括「發布日期」欄位，並支援遞增與遞減順序。(#15277, #16681, @nvdaes)
• 語音：
◦ 使用 Microsoft Speech API version 5 (SAPI5) 及 Microsoft Speech Platform 語音時，現在支援自動語言切換。(#17146, @gexgd0419)
◦ 使用 Microsoft Speech API version 5 (SAPI5) 及 Microsoft Speech Platform 語音時，現在支援加快語速，最高可達 6 倍速度。(#17606, @gexgd0419)
• 網頁瀏覽器：
◦ NVDA 瀏覽模式的原生選取模式 (NVDA+shift+f10) 現在可在 Google Chrome、Edge 以及其他基於 Chromium 134 或更新版本的應用程式中使用。(#17838)
◦ 在 Mozilla Firefox 中，當造訪包含文字片段的網址時，NVDA 會報讀醒目提示的文字。(#16910, @jcsteh)
◦ NVDA 現在可以報讀連結目標是否指向目前頁面。(#141, @LeonarddeR, @nvdaes)
• Microsoft Office：
◦ 在 PowerPoint 文字方塊中編輯時，現在可以使用 alt+向上鍵/alt+向下鍵 逐句移動。(#17015, @LeonarddeR)
◦ 在 Word 中，當使用 Word 指令 (f8 或 shift+f8) 擴大或縮小選取範圍時，現在會報讀更新的選取範圍。(#3293, @CyrilleB79)
◦ 在 Word 16.0.18226 及更新版本中，或使用 Word 物件模型時，NVDA 現在會透過語音和點字報讀標題是否已摺疊。(#17499)
◦ 在 Word 中搭配 UIA 使用時，當使用原生的擴充表格導覽指令 (alt+home、alt+end、alt+pageUp 和 alt+pageDown) 時，NVDA 現在會報讀插入點的移動。(#17867, @CyrilleB79)
◦ 在 Word 中，當使用讀出焦點指令時，如果文件版面配置資訊可用，並且讀出物件說明已啟用，NVDA 將會報讀文件版面配置。(#15088, @nvdaes)
◦ 在 Word 和 Outlook 中，現在會讀出更多快速鍵的執行結果：
▪ 字型格式快速鍵 (#10271, @CyrilleB79)
▪ 摺疊和展開標題 (#17545, @CyrilleB79)
• LibreOffice：
◦ 在 Writer 中使用對應的鍵盤快速鍵增大或縮小字型大小時，NVDA 會讀出新的字型大小。(#6915, @michaelweghorn)
◦ 在 Writer 25.2 或更新版本中，使用對應的鍵盤快速鍵套用「內文」或標題段落樣式時，NVDA 會讀出新的段落樣式。(#6915, @michaelweghorn)
◦ 在 Writer 中使用對應的鍵盤快速鍵切換雙底線時，NVDA 會讀出新的狀態(「雙底線 開」/「雙底線 關」)。(#6915, @michaelweghorn)
◦ NVDA 現在可以在 LibreOffice 25.8 及更新版本中讀出首行縮排。(#13052, @michaelweghorn)
• OCR：
◦ 在辨識結果中，可按 NVDA+f5 手動更新已辨識的內容。(#17715, @CyrilleB79)
◦ 新增了一個未指派手勢，用於切換定期更新 Windows OCR 結果。(#16897)
• 以「NVDA Remote」附加元件為基礎的遠端存取功能，現已整合至 NVDA。(#4390, @ctoth, @tspivey, @daiverd, NVDA Remote 貢獻者和贊助者)
• 現在可以指定鏡像網址，供 NVDA 更新和附加元件商店使用。(#14974, #17151, #17310, @christopherpross)
• 已新增對 PDF 中數學內容的支援。(#9288, @NSoiffer)
◦ 此功能適用於帶有相關 MathML 的公式，例如某些由較新版本 TeX/LaTeX 產生的檔案。
◦ 目前此功能僅支援 Foxit Reader 及 Foxit Editor。
• NVDA 現在可以設定，在透過點字顯示器導覽控制鍵導覽時，讀出目前的行或段落。(#17053, @nvdaes)
• NVDA 現在能夠讀初因按下 alt+向上鍵 或 alt+向下鍵 手勢所造成的插入點變更，例如在 Visual Studio Code 中。(#17652, @LeonarddeR)
• 新增了將檢閱游標移到目前選取文字的第一個字元與最後一個字元的指令，並分別指派給 NVDA+alt+home 和 NVDA+alt+end。(#17299, @nvdaes)
• 新增了一項一般設定，可在讀出全部或使用點字閱讀時，避免螢幕顯示關閉。此選項預設為啟用，但可能導致耗電量增加。(#17649, @LeonarddeR)
• NVDA 現已被翻譯為波士尼亞文。(#17953)
• 在 Adobe Acrobat 中，NVDA 現在可以報讀並與 PDF 文件中的數學方程式互動，這些文件是由 Microsoft Word 的較新版本所產生的。(#18056)
變更
• 元件更新：
◦ 將 LibLouis 點字轉譯表更新為 3.33.0。 (#17469, @LeonarddeR，@codeofdusk)
▪ 新增了科普特文、精簡楔形文字，以及葡萄牙文六點電腦點字的點字表。
◦ CLDR 已更新至 46.0 版本。(#17484, @OzancanKaratas)
◦ 已將 eSpeak NG 更新到 1.52.0。 (#17056)
• NVDA 介面變更：
◦ NVDA 安裝程式啟動時不再播放提示音。 (#14068)
◦ 「讀出連結目標」、「字元格式資訊」及「讀出選取內容」等對話框，現在加入了「關閉」和「複製」按鈕，以方便使用者操作。(#17018, @XLTechie)
◦ 結束對話框現在允許您同時停用附加元件並啟用偵錯記錄來重新啟動 NVDA。(#11538, @CyrilleB79)
◦ 已移除停用 WASAPI 進行音訊輸出的選項。(#16080)
◦ 瀏覽模式設定「自動將系統焦點設至可設定焦點的元素」已被移除，此行為現已停用。(#17598)
◦ NVDA 現在只會在更新至一個其附加元件 API 與目前版本不相容的新版本時，才會針對附加元件不相容的問題發出警告。(#17071, #17506)
◦ 「貢獻者」檔案已從 NVDA 選單中移除。(#16922)
◦ NVDA 授權合約現在以 HTML 格式呈現，以提升可讀性。(#17600)
◦ 新增了最常用命令列選項的縮寫版本：-d 代表 --disable-addons，-n 代表 --lang。命令列參數的前置詞比對(例如使用 --di 代表 --disable-addons)現已不再支援。(#11644, @CyrilleB79)
◦ COM 註冊修復工具的改進： (#12355, @XLTechie)
▪ 啟動時會提供更易於使用者理解的目的解說，取代了先前的警告。(#12351)
▪ 初始視窗現在可以使用 escape 或 alt+f4 鍵關閉。(#10799)
▪ 在嘗試重新註冊 COM 時，若發生罕見的 Windows 錯誤，現在會向使用者顯示一則包含錯誤訊息的提示。
• 語音：
◦ Microsoft Speech API version 5 和 Microsoft Speech Platform 語音現在使用 WASAPI 進行音訊輸出，這可能會提升這些語音的回應速度。(#13284, @gexgd0419)
◦ 使用 OneCore 語音、SAPI5 語音及某些第三方語音附加元件時，現在會移除語音開頭的靜音，以提升其回應速度。(#17614, @gexgd0419)
◦ Microsoft Speech API version 4 語音現在使用 WASAPI 進行音訊輸出，使其能夠支援音量調整、移除開頭靜音，以及保持音訊裝置喚醒等功能。如果此功能不適用於您的 SAPI 4 語音，您可以到進階設定中關閉 使用 WASAPI 作為 SAPI 4 的音訊輸出。(#17718, #17801, @gexgd0419)
◦ Unicode 正規化現在預設啟用，用於語音輸出。(#17017, @LeonarddeR).。
▪ 您仍然可以在 NVDA 設定對話框的「語音」類別中停用此功能。
• 「讀出輸入字元」與「讀出輸入單字」這兩項鍵盤設定，現在提供三個選項：關、僅限於編輯區，以及總是。(#17505, @Cary-rowen)
◦ 預設情況下，「讀出輸入字元」現在設定為「僅限於編輯區」。
• 現在可根據 NVDA 的語言來設定預設的輸入和輸出點字表。(#17306, #16390, #290, @nvdaes)
錯誤修正
• 語音：
◦ 修正了使用某些 SAPI5 語音合成器時，連續閱讀 (讀出全部) 功能會在第一句結尾停止的問題。(#16691, @gexgd0419)
◦ 透過循環切換設定在 SAPI5 和 SAPI4 語音合成器間切換語音時，語音參數(如語速和音量不會再重設回預設值。(#17693, #2320, @gexgd0419)
◦ 修正了某些 SAPI4 語音 (例如 IBM TTS 中文) 無法載入的問題。(#17726, @gexgd0419)
• 點字：
◦ 原生支援 Dot Inc. 的 Dot Pad 觸覺圖形裝置，可作為多行點字顯示器使用。(#17007)
◦ 使用 Seika Notetaker 時，輸入手勢對話框中，現在能正確顯示空格鍵及空格鍵與點字組合的手勢。(#17047, @school510587)
◦ 在未連接點字顯示器時，若使用顯示語音輸出點字模式，NVDA 現在應該不會再播放錯誤音效或在記錄檔中產生大量訊息。(#17092, @Emil-18)
◦ 當「標準 HID 點字顯示器」驅動程式被明確選為點字顯示器驅動程式，並且開啟點字顯示器清單時，NVDA 現在會正確識別 HID 驅動程式為已選取的驅動程式，而非顯示未選取任何驅動程式。(#17537, @LeonarddeR)
◦ Humanware Brailliant 驅動程式現在能更可靠地選取正確的連線端點，從而提升連線穩定性並減少錯誤。(#17537, @LeonarddeR)
◦ 在停用附加元件的情況下執行時，開發者 scratchpad 中的自訂點字表現在會被正確忽略。(#17565, @LeonarddeR)
◦ 修正了某些 USB 點顯器無法被 NVDA 正確偵測的問題。(#18114, @christiancomaschi)
• Microsoft Office：
◦ 在 Word、Outlook、Excel 及 PowerPoint 中使用舊版物件模型時，「報讀連結的目標網址」指令現在能如預期般運作。(#17292, #17362, #17435, @CyrilleB79)
◦ 在 Excel 中，元素清單對話框 (NVDA+f7) 現在不再會於某些非英文系統上，無法列出註解或公式。(#11366, @CyrilleB79)
◦ PowerPoint 的改進：
▪ 當文字包含寬字元 (例如表情符號) 時，插入點報讀不再發生錯誤。(#17006 , @LeonarddeR)
▪ 讀出字元位置現在更為準確 (例如按下 NVDA+delete 時)。(#9941, @LeonarddeR)
▪ 當開始投影片放映，且瀏覽模式設定頁面載入時自動讀出全部內容為停用時，NVDA 不再啟動全文朗讀。(#17488, @LeonarddeR)
• LibreOffice：
◦ 使用微軟拼音輸入法並開啟舊版相容模式時，Writer 等應用程式中 IME 快顯視窗顯示的狀態下輸入不再出現錯誤。 (#17198, @michaelweghorn)
◦ 對話框中核取方塊的目前狀態(勾選/沒勾選)，現在也會透過點字顯示，而不僅限於語音。(#17218, @michaelweghorn)
• 數學：
◦ 已修正部分網頁元素上數學內容的閱讀問題。具體來說，是指位於 span 元素以及其他具有屬性 role="math" 的元素內部的 MathML。(#15058)
◦ 僅由圖片和替代文字呈現，且沒有可用於互動導覽的 MathML 的數學方程式，現在會被視為一般圖片處理，而非沒有內容的數學內容，這讓使用者能透過 g 鍵跳至這些方程式，並能逐字元閱讀其替代文字。(#16007)
• 整合開發環境 (IDE)：
◦ 在 Android Studio 或 IntelliJ Idea 的某些原始碼檔案中選取所有文字時，NVDA 不再當機。(#17418, @thgcode)
◦ 在 Visual Studio Code 中，NVDA 不再將 alt+向上鍵 和 alt+向下鍵 手勢用於逐句導覽。(#17082, @LeonarddeR)
◦ 在 Visual Studio Code 中，某些區段元素現在能被正確識別為可編輯控制項。(#17573, @Cary-rowen)
◦ 在記事本及其他 UIA 文件，以及 Windows 11 上的 Notepad++ 文件中，若最後一行是空白行，則「點字下一行指令」會將游標移至最後一行。在任何文件中，若游標位於最後一行，使用此指令時，游標會被移至行尾。(#17251, #17430, @nvdaes)
• 組態設定檔：
◦ 當透過相關的組態設定檔啟動「讀出全部」時，點字功能不再發生異常。(#17163, @LeonarddeR)
◦ 修正了即使某些設定的值與一般組態中的值相同，仍會將其明確儲存至作用中組態設定檔的問題。(#17157, @leonarddeR)
• 拼讀時，Unicode 正規化現在運作得更為恰當：
◦ 讀出正規化字元後，NVDA 不再錯誤地將後續字元也讀為正規化。(#17286, @LeonarddeR)
◦ 組合字元 (例如 é) 能被正確讀出。(#17295, @LeonarddeR)
• NVDA 現在能夠讀取 Thunderbird 搜尋結果頁面上的快顯子功能表項目。(#4708, @thgcode)
• COM 註冊修復工具在失敗時，不會再誤報為成功。(#12355, @XLTechie)
• 當 Windows 11 剪貼簿歷程記錄視窗中有項目存在，並關閉該視窗時，NVDA 不再讀出這些項目。(#17308, @josephsl)
• 如果在瀏覽模式訊息開啟的狀態下重新載入附加元件，NVDA 不再無法讀出後續的焦點移動。(#17323, @CyrilleB79)
• 當使用 Skype、Discord、Signal 及手機連結等應用程式進行語音通訊時，NVDA 的語音和音效音量不再降低。(#17349, @jcsteh)
• 若在擷取快照變數時發生錯誤，開啟 NVDA Python 主控台不再失敗。(#17391, @CyrilleB79)
• 在網頁瀏覽器中，可編輯文字控制項內的文字選取變更，現在不再偶爾發生無法讀出的情況。(#17501, @jcsteh)
• 當頁面內跳轉的連結指向與虛擬游標所在位置相同的物件時，NVDA 不再無法捲動至連結目標。(#17669, @nvdaes)
• 重新啟動檔案總管後，NVDA 焦點醒目提示視窗的圖示不會固定在工作列上。(#17696, @hwf1324)
開發者需要了解的變化
請參閱 開發者指南 以了解 NVDA 的 API 廢除與移除過程。
• 請注意：此版本與先前的附加元件 API 不相容。附加元件需要重新測試，並更新其資訊清單。
• 元件更新：
◦ 已將 Ruff 更新到 0.8.1。 (#17102, #17260, #17473)
◦ 已將 Comtypes 更新到 1.4.6。 (#17061, @LeonarddeR)
◦ 已將 wxPython 更新到 4.2.2。 (#17181, @dpy013)
◦ 已將 SCons 更新到 4.8.1。 (#17254)
◦ 已將 sphinx 更新到 8.1.2，sphinx-rtd-theme 更新到 3.0.1。 (#17284, @josephsl)
◦ 已將 Robot Framework 更新到 7.1.1。 (#17329, @josephsl)
◦ 已將 configobj 更新到 5.1.0 commit 8be5462。 (#17328)
◦ 已將 pre-commit 更新到 4.0.1. (#17260)
◦ 已將 typing-extensions 更新到 4.12.2。 (#17438, @josephsl)
◦ 已將 licensecheck 更新到 2024.3。 (#17440, @josephsl)
◦ Markdown 已更新至 3.7 版本。(#17459, @dpy013)
◦ 已將 nh3 更新到 0.2.19。 (#17465, @josephsl)
◦ 已將 nuitka 更新到 2.5.4。 (#17458, @josephsl)
◦ 已將 schedule 更新到 1.2.2。 (#17455, @josephsl)
◦ 已將 requests 更新到 2.32.3。 (#17456, @josephsl)
• ui.browseableMessage 現在可以帶有選項呼叫，以呈現一個複製到剪貼簿的按鈕，及/或一個關閉視窗的按鈕。(#17018, @XLTechie)
• 新增了數個識別連結類型的方法 (#16994, @LeonarddeR, @nvdaes)
◦ 一個新的 utils.urlUtils 模組，包含多個用於判斷連結類型的函式
◦ controlTypes.states.State 中新增了 INTERNAL_LINK 狀態
◦ NVDAObject 上新增了 linkType 屬性。預設情況下，若有 treeInterceptor，它會查詢該 treeInterceptor。
◦ BrowseModeTreeInterceptor 物件新增了 documentUrl 屬性
◦ BrowseModeTreeInterceptor 物件新增了 getLinkTypeInDocument 方法，此方法接受一個 URL 以檢查物件的連結類型
◦ globalCommands 中新增了 toggleBooleanValue 輔助函式。此函式可用於腳本，當 config.conf 內的布林值狀態改變時，用以讀出其結果
• 為了和現代的自動程式碼風格檢查工具保持相容，NVDA 編碼標準已不再要求函式參數清單必須縮排兩個 tabs。(#17126, @XLTechie)
• 已將 NVDA 的 VS Code 工作區組態 作為 Git 子模組加入。(#17003)
• 新增了函式 gui.guiHelper.wxCallOnMain，它允許從非 GUI 執行緒安全且同步地呼叫 wx 函式，並取得其回傳值。(#17304)
• gui.message 中新增了一個新的訊息對話框 API。(#13007)
◦ 新增的類別有：ReturnCode, EscapeCode, DialogType, Button, DefaultButton, DefaultButtonSet, MessageDialog。
• brailleTables 模組中新增了 getDefaultTableForCurrentLang 函式。(#17222, @nvdaes)
• 新增了 updateCheck.UpdateInfo 資料類別，此類別封裝了關於 NVDA 更新的後設資料。(#17310, @christopherpross)
• 擷取 labeledBy 屬性適用於以下情況：
◦ 實作 labelled-by IAccessible2 關聯的應用程式中的物件。(#17436, @michaelweghorn)
◦ 支援對應 LabeledBy UIA 屬性的 UIA 元素。(#17442, @michaelweghorn)
• 新增了使用 gui.guiHelper.associateElements 將 wx.ComboBox 與標籤 wx.StaticText 建立關聯的功能。(#17476)
• 新增了以下擴充點(#17428, @ctoth)：
◦ inputCore.decide_handleRawKey：每次按鍵時呼叫
◦ speech.extensions.post_speechPaused：當語音暫停或取消暫停時呼叫
• bdDetect.DriverRegistrar 中點顯器自動偵測註冊的變更：(#17521, @LeonarddeR)
◦ 新增了 addUsbDevice 方法，用於一次註冊一個 USB 裝置。
◦ addUsbDevices 中新增了 matchFunc 參數，此參數也可用於 addUsbDevice。
▪ 這樣，在某些情況下，例如當一個 VID/PID 組合被不同驅動程式下的多個裝置共用，或是一個 HID 裝置提供多個端點時，就能更精確地篩選裝置偵測的範圍。
▪ 如需更多資訊，請參閱該方法的說明文件以及 albatross 和 brailliantB 驅動程式中的範例。
• utils.mmdevice.getOutputDevices 模組中新增了 getOutputDevices 函式，用於列舉音訊輸出裝置。(#17678)
• synthDriverHandler 中新增了擴充點 pre_synthSpeak，它會在語音管理員執行語音合成器的 speak 方法之前被調用。(#17648)
• NVDA 支援 text-indent IAccessible2 物件屬性。(#13052, @michaelweghorn)
• 當使用包含 numLock 作為修飾鍵的手勢觸發使用 gesture.send 的腳本時，Num Lock 不再被關閉。(#10827, @CyrilleB79)
API 重大變更
這些是會破壞 API 相容性的變更。如果您的附加元件在更新至新 API 時發生問題，請開啟一個 GitHub issue。
• addonStore.network.BASE_URL 常數已被移除。由於附加元件商店的基礎網址現在可直接在 NVDA 內部設定，因此沒有計畫提供替代方案。(#17099)
• updateCheck.CHECK_URL 常數已被移除。由於 NVDA 更新檢查網址現在可直接在 NVDA 內部設定，因此沒有計畫提供替代方案。(#17151)
• NVDAObjects.UIA.winConsoleUIA.WinTerminalUIA 已被移除，且無公開的替代方案。(#14047, #16820, @codeofdusk)
• NVDAObjects.IAccessible.ia2TextMozilla.FakeEmbeddingTextInfo 已被移除。(#16768, @jcsteh)
• appModules.soffice 中的以下符號已重新命名(#6915, @michaelweghorn)：
◦ SymphonyDocument.announceToolbarButtonToggle 重新命名為 SymphonyDocument.announceFormattingGestureChange
◦ SymphonyDocument.script_toggleTextAttribute 重新命名為 SymphonyDocument.script_changeTextFormatting
• brailleDisplayDrivers.seikantk.InputGesture 的 space 關鍵字參數現在預期傳入 int 而非 bool。(#17047, @school510587)
• [upgrade] 組態區段，包含 [upgrade][newLaptopKeyboardLayout]，已被移除。(#17191)
• updateCheck.checkForUpdate 回傳 UpdateInfo 物件，而非字典。(#17310, @christopherpross)
• updateCheck.UpdateResultDialog 和 updateCheck.UpdateDownloader 的建構函式已更新，會傳入 UpdateInfo 物件，而非包含後設資料的字典。(#17310, @christopherpross)
• 由於 NVDA 已停止支援 winmm (#17496, #17532, #17678)：
◦ nvwave 中的以下符號已被移除，且無替代方案：CALLBACK_EVENT, CALLBACK_FUNCTION, CALLBACK_NULL, HWAVEOUT, LPHWAVEOUT, LPWAVEFORMATEX, LPWAVEHDR, MAXPNAMELEN, MMSYSERR_NOERROR, usingWasapiWavePlayer, WAVEHDR, WAVEOUTCAPS, waveOutProc, WAVE_MAPPER, WHDR_DONE, WinmmWavePlayer, and winmm。
◦ nvwave 中的以下符號已被移除：getOutputDeviceNames, outputDeviceIDToName, outputDeviceNameToID。請改用 utils.mmdevice.getOutputDevices。
◦ nvwave.WasapiWavePlayer 已重新命名為 nvwave.WasapiWavePlayer``WavePlayer。此外，其 init 方法的簽名已變更如下：
▪ outputDevice 參數現在應只傳入字串引數。
▪ 已棄用的 closeWhenIdle 和 buffered 參數已被移除。
◦ gui.settingsDialogs.AdvancedPanelControls.wasapiComboBox 已被移除。
◦ 設定定義中 audio 區段的 WASAPI 金鑰已被移除。
◦ 組態金鑰 config.conf["speech"]["outputDevice"] 已被移除。它已被 config.conf["audio"]["outputDevice"] 取代，此金鑰儲存的是 Windows 核心音訊端點裝置 ID。(#17547)
• 在 NVDAObjects.window.scintilla.ScintillaTextInfo 中，若未選取任何文字，且 end 參數設定為 True 時，collapse 方法已被覆寫為擴展至行。(#17431, @nvdaes)
• 以下符號已被移除，且無替代方案：languageHandler.getLanguageCliArgs, main.quitGroup and main.installGroup 。 (#17486, @CyrilleB79)
• 命令列參數的前置詞匹配功能(例如以 --di 來表示 --disable-addons)已不再支援。(#11644, @CyrilleB79)
• bdDetect.DriverRegistrar 的 useAsFallBack 關鍵字參數已重新命名為 useAsFallback。(#17521, @LeonarddeR)
• [addonStore][showWarning] 組態設定已被移除。請改用 addonStore.dataManager.addonDataManager.storeSettings.showWarning。(#17597)
• ui.browseableMessage 接受 sanitizeHtmlFunc 參數。此參數預設會呼叫 nh3.clean，並使用其預設引數。這表示任何透過 isHtml=True 傳入 ui.browseableMessage 的 HTML，現在預設會被淨化。若要變更淨化規則，例如將標籤或屬性加入白名單，請建立一個使用所需參數呼叫 nh3.clean 的函式。(#16985)
• 按下更新或延後按鈕時，updateCheck.UpdateAskInstallDialog 不再自動執行動作。取而代之的是，新增了 callback 屬性，此屬性會回傳函式，當以對話框的回傳值呼叫該函式時，它會執行適當的動作。(#17582)
• 透過 gui.runScriptModalDialog 開啟的對話框，會被 NVDA 識別為強制回應。(#17582)
• 與「自動將系統焦點設至可設定焦點的元素」設定相關的以下 API 符號已被移除，且無替代方案：(#17598)
◦ globalCommands.GlobalCommands.scripttoggleAutoFocusFocusableElements
◦ config.conf["virtualBuffers"]["autoFocusFocusableElements"]
◦ gui.settingsDialogs.BrowseModePanel.autoFocusFocusableElementsCheckBox
• 由於 SAPI5 語音現在使用 nvwave.WavePlayer 輸出音訊：(#17592, @gexgd0419)
◦ synthDrivers.sapi5.SPAudioState 已被移除。
◦ synthDrivers.sapi5.SynthDriver.ttsAudioStream 已被移除。
• autoSettingsUtils.driverSetting.DriverSetting 中，其 id 以底線 () 開頭的實例，不再顯示於 NVDA 的設定中。(#17599)
• 已將鍵盤輸入回音的組態從布林值變更為整數值。(#17505, @Cary-rowen)
◦ config.conf["keyboard"]["speakTypedCharacters"] 和 config.conf["keyboard"]["speakTypedWords"] 現在使用整數值。
◦ 在 config.configFlags 中新增了 TypingEcho 列舉，用以表示這些模式：0=關，1=僅限於編輯區，2=總是。
◦ gui.settingsDialogs.KeyboardSettingsPanel.wordsCheckBox 和 gui.settingsDialogs.KeyboardSettingsPanel.charsCheckBox 已被移除。
• winUser.paint 已從 painStruct 重新命名為 paintStruct，修正了傳入 PAINTSTRUCT 會引發例外狀況的錯誤。(#17744)
• documentationUtils.getDocFilePath 和 installer.getDocFilePath 不再會於語系說明文件資料夾中尋找.txt 檔案。(#17911, @CyrilleB79)
• config.conf["documentFormatting"]["reportFontAttributes"] 已被移除，請改用 config.conf["documentFormatting"]["fontAttributeReporting"]。(#18066)
• config.conf["speech"]["includeCLDR"] 已被移除，請改為透過 config.conf["speech"]["symbolDictionaries"] 是否包含 "cldr" 來檢查或修改此設定。(#18066)
棄用
• braille.filter_displaySize 擴充點已被棄用。請改用 braille.filter_displayDimensions。(#17011)
• 函數 gui.message.messageBox、gui.runScriptModalDialog 以及類 gui.nvdaControls.MessageDialog 已棄用。請改用 gui.message.MessageDialog。(#17582)
• 以下符號已棄用 (#17486, @CyrilleB79)：
◦ main 中的 NoConsoleOptionParser、stringToBool、stringToLang 已棄用；請改用 argsParsing 中的同名符號。
◦ main.parser 已棄用；請改用 argsParsing.getParser()。
• bdDetect.DeviceType 已被棄用，建議改用 bdDetect.ProtocolType 和 bdDetect.CommunicationType，以考量到 HID 和 Serial 通訊協定皆可透過 USB 和藍牙運作的情況。(#17537 , @LeonarddeR)
※最後更新時間：2025-06-16 12:25:02 From：118.168.200.84 By：小愛/張可揚