---
title: teclado
slug: develop/es/teclado
docTags: 
createdAt: 2025-03-11T07:07:19.526Z
---

El objeto *teclado* le permite configurar la entrada de un teclado USB conectado al reproductor.

**IDL de keyboard**

```text
interface keypress {
    attribute String type;
    attribute Number keyCode;
    attribute String key;
};

callback KeyboardEventCallback = void (keypress event);

interface Keyboard {
    Promise<bool> isAttached();
    Promise<void> setLayout(String layoutName);
    Promise<void> setNumLock(bool on_off);
    
    void addEventListener(String type, KeyboardEventCallback callback);
    void removeEventListener(String type, KeyboardEventCallback callback);
};
```

## Creación de objetos

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

```javascript
var keyboardClass = require("@brightsign/keyboard");
var keyboard = new keyboardClass();
```

## Keypress

Esta interfaz contiene los siguientes parámetros:

- `tipo` <font color="#704ae0">String</font>: El tipo siempre es “keypress”
- `keyCode` <font color="#704ae0">Number</font>: El keycode ASCII como número
- `clave` <font color="#704ae0">String</font>: El carácter ASCII para el evento del teclado

## Keyboard

Esta interfaz permite la detección y configuración de un teclado USB.

### isAttached()

```javascript
Promise<bool> isAttached()
```

Devuelve `verdadero` si hay un teclado USB conectado al reproductor. Este método cuenta un dispositivo conectado como teclado si informa que tiene las siguientes teclas: "A", "Z", "0", "9", "." y Enter.

### setLayout()

```javascript
Promise<void> setLayout(String layoutName)
```

Especifica la distribución localizada para el teclado USB conectado. Esta configuración entra en vigor inmediatamente y persiste en el registro después de un reinicio. Consulte [esta tabla](docId\:sLKjJf-hQgXhG7D0rGpJc) para ver parámetros de keymap válidos (los reproductores están configurados como "us" de forma predeterminada).

### setNumLock()

```javascript
Promise<void> setNumLock(bool on_off)
```

Establece el estado de numlock para el teclado USB conectado si se pasa `verdadero`. Restablece el estado si se pasa `falso`.

## Ejemplo

```javascript
var KeyboardClass = require("@brightsign/keyboard");
var keyboard = new KeyboardClass();
keyboard.isAttached().then(
        function(data) {
            console.log("***Is Attached***");
            console.log(JSON.stringify(data));
        })
    .catch(
        function(data) {
            console.log(JSON.stringify(data));
        });
keyboard.setLayout("gb").then(
        function(data) {
            console.log("***Layout set***");
        })
    .catch(
        function(data) {
            console.log(JSON.stringify(data));
        }); 
```