Deeplinks
VoiceHotkey 支援 URL Scheme,便於 Raycast、Keyboard Maestro、快捷指令等呼叫。
Scheme
Section titled “Scheme”- 主:
voicehotkey:// - 短:
vh://(等價)
| 作用 | URL |
|---|---|
| 開始語音輸入 | voicehotkey://start 或 …/start?mode=dictation |
| 開始翻譯 | voicehotkey://start?mode=translation |
| 開始命令 | voicehotkey://start?mode=command |
| 結束並處理;相容別名 | voicehotkey://stop、voicehotkey://finish |
| 僅結束錄音;處理期間無操作 | voicehotkey://finish-recording |
| 切換錄音 | voicehotkey://toggle(可帶 mode=) |
| 取消 | voicehotkey://cancel |
查詢參數別名:mode / mode_id / voice_mode 均可。語音輸入模式可用 dictation / typing / type / voice / input / d。
錄音動作別名(host):start≈record≈listen,stop≈end≈finish,cancel≈escape≈abort。finish-recording 僅結束錄音。
省略 mode 時預設為語音輸入。明確指定不支援的模式或設定頁面時,VoiceHotkey 會在狀態浮層提示錯誤,不會改用預設模式或頁面。
| 頁面 | URL |
|---|---|
| 一般設定 | voicehotkey://tab/settings 或 …/general |
| 快捷鍵 | voicehotkey://tab/hotkey |
| 輸入模型 | voicehotkey://tab/models |
| 文字處理 | voicehotkey://tab/post-process |
| 語音命令 | voicehotkey://tab/commands |
| 檔案轉寫 | voicehotkey://tab/transcribe |
| 歷史 | voicehotkey://tab/history |
| 授權 | voicehotkey://tab/license |
| 關於 | voicehotkey://tab/about |
| 詞替換 | voicehotkey://word-replacements |
若已在錄音,或辨識 / 潤色 / 執行尚未結束,再發 start 會被忽略,並在狀態浮層提示忙碌。錄音時 stop 會結束並處理;處理期間 stop 和舊別名 finish 會取消目前工作。finish-recording 只結束錄音,其他狀態下不操作;cancel 明確取消目前工作。toggle 按目前會話狀態切換。
命令模式必須同時開啟 啟用語音命令 與 允許 DeepLink 啟動語音命令;後者預設關閉,只限制外部連結,不影響鍵盤快速鍵。見 語音命令。
快捷 host
Section titled “快捷 host”與 tab/… 等價,適合啟動器:
| URL | 打開 |
|---|---|
voicehotkey://settings |
一般 |
voicehotkey://history |
歷史 |
voicehotkey://word-replacements |
詞替換 |
路徑寫法:voicehotkey:///start?mode=dictation。
若 App 尚未就緒,Deeplink 會排隊,在管線啟動後執行。等待隊列最多保留 16 項;超出的連結會丟棄並在狀態浮層提示。無效連結也會顯示原因。