record_marker

macOS

Propósito

Suelta un marcador con nombre en la línea de tiempo de la grabación activa. t_ms ha transcurrido ms desde el inicio de la grabación. Proporcione límites (`bounds`) (puntos globales, arriba a la izquierda) para acercar un elemento u omitirlos para fotograma completo. La nota (`note`) se convierte en una fuente de subtítulos. Devuelve no_active_session si no se está grabando nada.

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 no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

• 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"
    },
    "name": {
      "description": "Marker name, e.g. open_tray, act2_calendar_create.",
      "type": "string"
    },
    "note": {
      "description": "Free text → caption source.",
      "type": "string"
    },
    "session_id": {
      "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.

{
  "name": "Planning meeting"
}