screen_record_start

Pantalla, ventanas e interfaz · macOS

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Comienza una grabación de pantalla (ScreenCaptureKit) de una pantalla, ventana o región. Sesión activa única en v1: un segundo inicio devuelve already_recording. Devuelve un session_id utilizado por record_marker y screen_record_stop. Requiere permiso de grabación de pantalla; sin él, devuelve un error explícito permission_required, nunca una operación silenciosa.

Entradas obligatorias

target

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.

Esquema técnico canónico en inglés — macOS

{
  "properties": {
    "fps": {
      "description": "Frames per second (default 60).",
      "type": "integer"
    },
    "output_path": {
      "description": "Where to write the .mov (default: temp file, returned by stop). Missing parent folders are created.",
      "type": "string"
    },
    "show_cursor": {
      "description": "Default true.",
      "type": "boolean"
    },
    "target": {
      "description": "What to capture.",
      "properties": {
        "display_id": {
          "description": "Required if kind=display.",
          "type": "string"
        },
        "kind": {
          "enum": [
            "display",
            "window",
            "region"
          ],
          "type": "string"
        },
        "region": {
          "description": "Required if kind=region: {x,y,w,h} global points.",
          "type": "object"
        },
        "window_id": {
          "description": "Required if kind=window.",
          "type": "string"
        }
      },
      "required": [
        "kind"
      ],
      "type": "object"
    }
  },
  "required": [
    "target"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para screen_record_start. 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.

{
  "target": {
    "display_id": "1",
    "kind": "display"
  }
}