---
title: captura de pantalla
slug: develop/es/captura-de-pantalla
docTags: 
createdAt: 2025-03-26T14:48:41.185Z
---

El objeto *captura de pantalla *le permite capturar una captura de pantalla de las capas compuestas de video y gráficos.

**IDL de screenshot**

```javascript
interface Screenshot {                                                                                                                                                                                                                                                  
    void syncCapture(ScreenshotParams params);                                                                                                                                                                                                                          
    Promise<void> asyncCapture(ScreenshotParams params);                                                                                                                                                                                                                
};                                                                                                                                                                                                                                                                      
                                                                                                                                                                                                                                                                        
interface ScreenshotParams {                                                                                                                                                                                                                                            
    [optional] attribute String destinationFileName;                                                                                                                                                                                                                    
    [optional] attribute String fileName;                                                                                                                                                                                                                               
    [optional, Default=JPEG] attribute String fileType;                                                                                                                                                                                                                 
    [optional, Default=""] attribute String description;                                                                                                                                                                                                                
    [optional, Default=640] attribute int width;                                                                                                                                                                                                                        
    [optional, Default=480] attribute int height;                                                                                                                                                                                                                       
    [optional, Default=50] attribute int quality;                                                                                                                                                                                                                       
    [optional, Default=0] attribute int rotation;                                                                                                                                                                                                                       
};  
```

## Creación de objetos

Para crear un objeto *captura de pantalla*, primero cargue el módulo `brightsign/captura de pantalla` usando el método `require()` . Luego cree una instancia de la clase *captura de pantalla*.

```javascript
var ScreenshotClass = require("@brightsign/screenshot");
var screenshot = new ScreenshotClass();
```

## Screenshot

Use esta interfaz para tomar capturas de pantalla.

**syncCapture()**

```javascript
void syncCapture(ScreenshotParams params) 
```

Toma una captura de pantalla casi en el momento exacto en que se llama. Debido a que este método podría interrumpir las operaciones en pantalla, es más apropiado para aplicaciones de depuración.

**asyncCapture()**

```javascript
Promise<void> asyncCapture(ScreenshotParams params)
```

Toma una captura de pantalla sin interrumpir otras operaciones. Este método es apropiado para entornos de producción, donde el momento de la captura es menos importante que una operación fluida.

## ScreenshotParams

Esta interfaz contiene la configuración de captura de pantalla.

- `destinationFileName` <font color="#6554c0">string</font>: La ruta nativa y el nombre de archivo que se guardarán (por ejemplo, *storage/sd/myscreenshots/screen.jpg*). Si el directorio especificado no existe, la captura de pantalla fallará.
- `fileName` <font color="#6554c0">string</font>:  El nombre y la ruta del archivo de imagen que se guardará (p. ej., "SD:/myscreenshots/screen.jpg"). Si el directorio especificado no existe, la captura de pantalla fallará. Esto está obsoleto en favor de `destinationFileName`, pero todavía es compatible. 
- `fileType` <font color="#6554c0">string</font>: El tipo de archivo de la imagen ("JPEG" o "BMP"). El tipo de archivo predeterminado es "JPEG". Tenga en cuenta que la extensión del archivo (".jpg" o ".bmp") no se agrega al nombre del archivo de forma predeterminada y, si es necesario, debe incluirse en la cadena `fileName` .
- `descripción` <font color="#6554c0">string </font><font color="#01a0af">opcional</font>: Una descripción opcional.
- `ancho` <font color="#6554c0">int</font>: El ancho del archivo de imagen. El valor predeterminado es 640.
- `altura` <font color="#6554c0">int</font>: La altura del archivo de imagen. El valor predeterminado es 480.
- `calidad`<font color="#6554c0"> int</font>: La calidad de imagen de la captura de pantalla (entre 0 y 100). El valor predeterminado es 50.
- `rotación` <font color="#6554c0">int</font>: La rotación de la imagen de la captura de pantalla (en grados). El valor predeterminado es 0. Los valores aceptados son 0, 90, 180 y 270.

## Ejemplo

Este script toma una captura de pantalla de forma asíncrona cada cinco minutos y la guarda en la raíz de la tarjeta SD. Tenga en cuenta que la imagen anterior se borra con cada nueva captura de pantalla.

```javascript
var ScreenshotClass = require("@brightsign/screenshot");
var screenshot = new ScreenshotClass();

function takeAsyncScreenshot(args) {
    screenshot.asyncCapture(args).then().catch();
};

screenshotParams = {};
screenshotParams.fileName = "SD:/screen.jpg";
screenshotParams.quality = 75;

setInterval(takeAsyncScreenshot(screenshotParams), 10000);
```