跳到內容

Deeplinks

VoiceHotkey 支援 URL Scheme,便於 Raycast、Keyboard Maestro、快捷指令等呼叫。

  • 主: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 啟動語音命令;後者預設關閉,只限制外部連結,不影響鍵盤快速鍵。見 語音命令。

與 tab/… 等價,適合啟動器:

URL 打開
voicehotkey://settings 一般
voicehotkey://history 歷史
voicehotkey://word-replacements 詞替換

路徑寫法:voicehotkey:///start?mode=dictation。

若 App 尚未就緒,Deeplink 會排隊,在管線啟動後執行。等待隊列最多保留 16 項;超出的連結會丟棄並在狀態浮層提示。無效連結也會顯示原因。