URL scheme API

說明 Longshot 的命令，便於其他應用呼叫 Longshot 實現截圖等功能 ……

喚起 Longshot 命令

• 開始截圖: longshot://snip?func=start
• 開始區域錄屏: longshot://record?func=startArea
• 開始 OCR 文字識別: longshot://ocr?func=start
• 開始螢幕測量: longshot://rule?func=start
• 偏好設定-快捷鍵: longshot://pref?page=shortcuts

喚起 Longshot，並在操作後回調至呼叫的應用

• 截圖複製:

  longshot://x-callback-url/snip?func=start&channel=clipboard&type=data&x-source=SourceApp&x-success=sourceapp://x-callback-url/acceptSnip?x-source=longshot&x-error=sourceapp://x-callback-url/snipError?x-source=longshot&errorMessage=message

  其中:

  • SourceApp 為呼叫的應用名稱
  • Longshot 成功後會呼叫 sourceapp://x-callback-url/acceptSnip?x-source=longshot
  • Longshot 失敗後會呼叫 sourceapp://x-callback-url/snipError?x-source=longshot&errorMessage=message

• 區域錄屏:

  longshot://x-callback-url/record?func=startArea&channel=clipboard&type=filepath&x-source=SourceApp&x-success=sourceapp://x-callback-url/acceptRecord?x-source=longshot&x-error=sourceapp://x-callback-url/recordError?x-source=longshot&errorMessage=message

  其中:

  • SourceApp 為呼叫的應用名稱
  • Longshot 成功後會呼叫 sourceapp://x-callback-url/acceptRecord?x-source=longshot
  • Longshot 失敗後會呼叫 sourceapp://x-callback-url/recordError?x-source=longshot&errorMessage=message

• OCR 文字識別:

longshot://x-callback-url/ocr?func=start&channel=clipboard&type=string&x-source=SourceApp&x-success=sourceapp://x-callback-url/acceptOcr?x-source=longshot&x-error=sourceapp://x-callback-url/ocrError?x-source-longshot&errorMessage=message

其中:

• SourceApp 為呼叫的應用名稱
• Longshot 成功後會呼叫 sourceapp://x-callback-url/acceptOcr?x-source=longshot
• Longshot 失敗後會呼叫 sourceapp://x-callback-url/ocrError?x-source-longshot&errorMessage=message

應用案例

• uPic 強大的圖床工具 利用 Longshot 的 URL scheme API 實現截圖上傳雲端生成 URL 使用
• Picsee 看圖 & 圖片管理 實現截圖管理，內建截圖上傳圖床生成 URL，管理圖片及其 URL

參考文獻

1. x-callback-url