record_marker

macOS

Propósito

Coloca un marcador con nombre en la línea de tiempo de la grabación activa. t_ms son los ms transcurridos desde el inicio de la grabación. Indica bounds (puntos globales, origen arriba a la izquierda) para hacer zoom hacia un elemento, u omítelo para el encuadre completo. note pasa a ser una fuente de subtítulo. Devuelve no_active_session si no se está grabando nada. La primera llamada muestra una vista previa; confirm: true coloca el marcador, con la marca de tiempo de esa llamada.

Entradas obligatorias

• name

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

• Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

{
  "properties": {
    "bounds": {
      "description": "Optional {x,y,w,h} global points to zoom toward.",
      "type": "object"
    },
    "confirm": {
      "description": "Must be true to drop the marker; it is stamped at that call. Without it the call returns a preview and adds nothing.",
      "type": "boolean"
    },
    "name": {
      "description": "Marker name, e.g. open_tray, act2_calendar_create.",
      "type": "string"
    },
    "note": {
      "description": "Free text → caption source.",
      "type": "string"
    },
    "session_id": {
      "description": "Accepted and IGNORED: v1 records one session at a time, so a marker always lands on the active recording. It is here so echoing back the session_id from screen_record_start is not an error.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para record_marker. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "name": "Planning meeting"
}