Tareas por lotes de longarm

Volver a la documentación de longarm

Las tareas por lotes permiten guardar flujos reutilizables de varios pasos y ejecutarlos después desde la app, REST API o MCP.

Comportamiento clave

solo una ejecución por lotes puede estar activa a la vez
las solicitudes de ejecución devuelven inmediatamente un runId
el progreso se consulta mediante estado e historial
las capturas tomadas por pasos screenshot se guardan en el historial
la retención predeterminada es de 30 ejecuciones

Forma de una tarea

{
  "id": "bt_...",
  "name": "Open Settings and capture",
  "steps": [],
  "repeat": 1,
  "variables": {}
}

Forma de un paso

{
  "id": "step_1",
  "type": "tap",
  "params": { "x": 540, "y": 1200, "duration": 80 },
  "repeat": 1,
  "delayAfterMs": 0,
  "continueOnError": false,
  "children": []
}

Tipos de paso

Gratis:

tap
long_press
screenshot
open_app
open_intent
overlay_show
overlay_hide
delay
set
ui_action
set_text
ui_scroll
wait_for_ui
loop

Plus:

swipe
pinch
two_finger_swipe
rotate

Variables

Usa sustitución {{name}} dentro de parámetros string:

{
  "variables": {
    "packageName": "com.android.settings"
  },
  "steps": [
    {
      "type": "open_app",
      "params": { "packageName": "{{packageName}}" }
    }
  ]
}

Ejecuta tareas guardadas desde la pestaña Batch, REST API o MCP, y revisa mensajes y capturas en Batch History.