Aller au contenu

x-callback-url

Qu’est-ce que x-callback-url?

Picsew implémente le protocole x-callback-url, un protocole générique de schéma URL. Il permet de communiquer entre différentes apps. Workflow, Launch Center Pro et d’autres apps prennent en charge x-callback-url; Picsew peut donc aussi fonctionner avec elles.

Le format x-callback-url de Picsew est:

picsew://x-callback-url/[action]?[action parameters]&[x-callback parameters]

Action

/scroll

Utilise les images spécifiées pour l’assemblage de capture défilante.

/vert

Utilise les images spécifiées pour l’assemblage vertical.

/hori

Utilise les images spécifiées pour l’assemblage horizontal.

Paramètres d’action

  • in (obligatoire) Indique comment obtenir l’image d’entrée. Les valeurs autorisées sont paste, latest et recent. Avec paste, les images sont récupérées depuis le presse-papiers. Avec latest, les N images les plus récentes de l’album photo sont récupérées, N étant déterminé par le paramètre count. Avec recent, les captures d’écran les plus récentes sont détectées automatiquement.

  • count Lorsque in=latest, ce paramètre est obligatoire et indique le nombre d’images à obtenir.

  • out (obligatoire) Indique comment sortir le résultat de l’assemblage. Les valeurs autorisées sont copy, save et save_copy. Avec copy, le résultat est copié dans le presse-papiers. Avec save, le résultat est enregistré dans l’album photo. Avec save_copy, le résultat est enregistré et copié.

  • watermark (facultatif) Indique s’il faut ajouter un filigrane. Les valeurs autorisées sont single et repeat. Par défaut, aucun filigrane n’est ajouté. Le texte et l’emplacement du filigrane utilisent le réglage de filigrane par défaut dans l’app. Si le réglage par défaut n’est pas configuré correctement, le résultat final n’aura pas de filigrane. Avec single, un filigrane unique est ajouté à la position par défaut de l’image finale. Avec repeat, un filigrane est ajouté à la position par défaut de chaque image.

  • border (facultatif) Indique s’il faut ajouter des bordures. Les valeurs autorisées sont inside, outside et all. Par défaut, aucune bordure n’est ajoutée. Avec inside, des bordures sont ajoutées à l’intérieur de l’image finale. Avec outside, des bordures sont ajoutées à l’extérieur de l’image finale. Avec all, des bordures sont ajoutées à l’intérieur et à l’extérieur de l’image finale. Pour indiquer la largeur, ajoutez _<0~100> à la fin, par exemple inside_60.

  • mockup Indisponible, remplacé par mockup2.

  • mockup2 (facultatif) Indique s’il faut ajouter une maquette. Pour les valeurs autorisées, consultez la documentation "Mockup Parameters".

  • clean_status (facultatif) Indique si la barre d’état doit être effacée. Avec yes, la barre d’état est effacée automatiquement. Par défaut, elle ne l’est pas.

  • remove_scrollbar (facultatif) Indique si les barres de défilement doivent être supprimées. Avec yes, les barres de défilement sont supprimées automatiquement. Par défaut, elles ne sont pas supprimées.

  • delete_source (facultatif) Indique si les images originales doivent être supprimées. Avec yes, les images originales seront supprimées. Par défaut, elles ne le sont pas.

Exemples

  • Utiliser les captures d’écran les plus récentes pour l’assemblage de capture défilante, effacer automatiquement la barre d’état, ajouter une maquette iPhone 14 Blue, enregistrer le résultat dans l’album photo, puis supprimer les images originales.
picsew://x-callback-url/scroll?in=recent&out=save&clean_status=yes&mockup2=iphone-14-blue&delete_source=yes
  • Assemblage vertical avec les 3 images les plus récentes de l’album photo, ajout d’un filigrane par défaut à chaque image, puis copie du résultat dans le presse-papiers.
picsew://x-callback-url/vert?in=latest&count=3&out=copy&watermark=repeat