內容優先朗讀NVDA插件

讓純文本內容在控件信息之前朗讀，以享受更好的操作體驗。

下載

• 你可以 點擊這裡下載最新版本 的NVDA插件。
• 你還可以前往我的github倉庫頁面 點我前往內容優先朗讀的github倉庫頁面

相容性

NVDA2024.1以上版本測試正常

🚀 功能特色

• 智能語音重排：自動將文本內容排在控件類型信息之前
• 多語言支援：純API實現，支援所有NVDA支援的語言
• 實時切換：一鍵開啟/關閉功能
• 調試模式：開發者友好的詳細日誌輸出
• 診斷工具：內建多種診斷和測試功能

⌨️ 快捷鍵

預設快捷鍵

• NVDA+Ctrl+Shift+Y：切換內容優先朗讀功能開關

可自定義快捷鍵的功能

以下功能可透過 NVDA 的「輸入手勢」對話框自定義快捷鍵：

• 切換調試模式：查看詳細的語音序列處理信息
• 測試重排功能：演示語音重排效果
• 顯示插件狀態：查看當前設定和最後處理的序列

🔧 使用方法

基本使用

1. 按 NVDA+Ctrl+Shift+Y 開啟功能
2. 在網頁或應用程式中正常瀏覽
3. 注意聽取語音順序的變化：內容會優先於控件類型被朗讀

範例效果

開啟前：「按鈕 確定」
開啟後：「確定 按鈕」

開啟前：「連結 首頁」
開啟後：「首頁 連結」

你還可以打開這個測試頁面，啟動內容優先朗讀來測試效果 點我打開測試頁面

🛠️ 故障排除

當發現沒有按照預期改變順序時

如果你發現某些情況下插件沒有正常工作，可以按照以下步驟收集診斷信息：

1. 開啟調試模式

1. 開啟NVDA功能表 → 偏好 → 設定 → 事件紀錄等級下拉框中選擇偵錯， 之後tab找確定enter
2. 開啟NVDA功能表 → 偏好設定 → 輸入手勢
3. 在「內容優先朗讀」分類下找到「切換調試模式」
4. 為其設定一個快捷鍵（例如：NVDA+Ctrl+Shift+D）
5. 按下設定的快捷鍵開啟調試模式
6. 確認聽到「調試模式已開啟」的提示

2. 重現問題操作

1. 按照平常的方式瀏覽網頁或使用軟體
2. 嘗試在有問題的頁面或控件上重現語音順序問題
3. 多測試幾個不同的控件類型（按鈕、連結、文字框等）

3. 複製日誌資訊

1. 開啟NVDA功能表 → 工具 → 檢視事件記錄
2. 在日誌視窗中按 Ctrl+A 全選所有內容
3. 按 Ctrl+C 複製日誌內容
4. 將複製的日誌內容貼到文字檔或電子郵件中發給我，電子郵件→ c469591@mail.batol.net

4. 關閉調試模式並連繫開發者

完成問題重現後，記得按同樣的快捷鍵關閉調試模式，避免產生過多日誌資訊。

更新日誌

V0.3

1. 使用官方 filter_speechSequence API 重構，提升與其他插件的相容性
2. 使用 PropertyTextCommand 精確標記控件類型和狀態，徹底解決純文字誤判問題
3. 擴展重排範圍：不僅控件類型（連結、按鈕等），狀態（選中、按下等）也會移到最後朗讀
4. 新增配置保存功能，重啟 NVDA 後自動記憶開關狀態
5. 新增多語言支持：繁體中文、簡體中文、英文
6. 尊重用戶設定：不會朗讀用戶設定中已關閉的屬性

V0.21

1. 使用精確匹配控件避免錯誤排序
2. 新增了一個測試用的html檔案

v0.2

• 修復跟其他需要捕獲朗讀內容的插件衝突的問題