API URL scheme

Longshot expose des actions pour que les utilisateurs avancés ou développeurs pilotent l’app via des commandes. Détails ci‑dessous……

Appeler une commande Longshot

• Démarrer la capture : longshot://snip?func=start
• Démarrer l’enregistrement de zone : longshot://record?func=start_area
• Démarrer l’OCR : longshot://ocr?func=start
• Activer la règle à l’écran : longshot://rule?func=start
• Ouvrir les raccourcis : longshot://pref?page=shortcuts

Appeler Longshot avec retour de résultat dans l’app appelante

• Capture d’écran (copie) :

  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

  Explications :

  • SourceApp est le nom de l’app appelante.
  • En cas de succès, Longshot appelle sourceapp://x-callback-url/acceptSnip?x-source=longshot.
  • En cas d’échec, Longshot appelle sourceapp://x-callback-url/snipError?x-source=longshot&errorMessage=message.

• Enregistrement d’écran (zone) :

  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

  Explications :

  • SourceApp est le nom de l’app appelante.
  • En cas de succès, Longshot appelle sourceapp://x-callback-url/acceptRecord?x-source=longshot.
  • En cas d’échec, Longshot appelle sourceapp://x-callback-url/recordError?x-source=longshot&errorMessage=message.

• Reconnaissance 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

  Explications :

  • SourceApp est le nom de l’app appelante.
  • En cas de succès, Longshot appelle sourceapp://x-callback-url/acceptOcr?x-source=longshot.
  • En cas d’échec, Longshot appelle sourceapp://x-callback-url/ocrError?x-source-longshot&errorMessage=message.

Cas d’usage

• uPic - Powerful Image Hosting Tool utilise l’API URL scheme de Longshot pour envoyer les captures sur le cloud et obtenir des liens.
• Picsee - Photo Browse & Manage gère les captures, l’upload vers un hébergeur d’images et la gestion des URL.

Références

1. x-callback-url