Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Clase de conexión
<a name="connection-class"></a>

Clase de conexión obtenida al llamar al [método `connect`](dcv-module.md#connect) del módulo `dcv`. Para ver un ejemplo de cómo utilizarlo, consulte la sección [Introducción](establish-connection.md#auth-conn).

**Topics**
+ [

## Métodos
](#methods)

## Métodos
<a name="methods"></a>

**Topics**
+ [

### attachDisplay (win, DisplayConf) → \$1Promesa. <number>\$1Promesa. < \$1código: [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), mensaje: cadena\$1 >\$1
](#attachDisplay)
+ [

### captureClipboardEvents(activado, win, displayID) → \$1void\$1
](#captureClipboardEvents)
+ [

### detachDisplay(displayId) → \$1void\$1
](#detachDisplay)
+ [

### disconnect() → \$1void\$1
](#disconnect)
+ [

### disconnectCollaborator(connectionId) → \$1void\$1
](#disconnectCollaborator)
+ [

### enableDisplayQualityActualizaciones (activar) → \$1void\$1
](#enableDisplayQualityUpdates)
+ [

### enableHighPixelDensidad (activar) → \$1void\$1
](#enableHighPixelDensity)
+ [

### enableTimezoneRedirection(habilitar) → \$1Promise\$1Promesa. < \$1código: [TimezoneRedirectionErrorCode](dcv-module.md#TimezoneRedirectionErrorCode), mensaje: cadena\$1 >\$1
](#enableTimezoneRedirection)
+ [

### enterRelativeMouseModo () → \$1vacío\$1
](#enterRelativeMouseMode)
+ [

### getConnectedDevices() → \$1Promesa. <Matriz. < MediaDeviceInfo >>\$1Promesa. < \$1message: string\$1 >\$1
](#getConnectedDevices)
+ [

### getFileExplorer() → \$1Promesa. < almacenamiento de [archivos >\$1Promesa.](dcv-module.md#filestorage) < \$1código: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), mensaje: cadena\$1 >\$1
](#getFileExplorer)
+ [

### getServerInfo() → \$1[ServerInfo](dcv-module.md#serverInfo)\$1
](#getServerInfo)
+ [

### getScreenshot () → \$1Promise\$1Promesa. < \$1código: [ScreenshotErrorCode](dcv-module.md#ScreenshotErrorCode), mensaje: cadena\$1 >\$1
](#getScreenshot)
+ [

### getStats() → \$1[stats](dcv-module.md#stats)\$1
](#getStats)
+ [

### latchModifierKey(clave, ubicación, isDown) → \$1boolean\$1
](#latchModifierKey)
+ [

### openChannel (nombre, token de autenticación, devolución de llamadas, espacio de nombres) → \$1Promise\$1Promise. < \$1código:, mensaje: cadena\$1 >\$1 [ChannelErrorCode](dcv-module.md#ChannelErrorCode)
](#openChannel)
+ [

### queryFeature(featureName) → \$1Promise.<\$1enabled: boolean, remote?: string, autoCopy?: boolean, autoPaste?: boolean, serviceStatus?: string, available?: boolean\$1>\$1Promise.<\$1message: string\$1>\$1
](#queryFeature)
+ [

### registerKeyboardShortcuts(atajos) → \$1vacío\$1
](#registerKeyboardShortcuts)
+ [

### requestDisplayConfig(highColorAccuracy) → \$1Promesión\$1Promesa. < \$1código: [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), mensaje: cadena\$1 >\$1
](#requestDisplayConfig)
+ [

### requestDisplayLayout(diseño) → \$1Promise\$1Promesa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensaje: cadena\$1 >\$1
](#requestDisplayLayout)
+ [

### requestResolution (ancho, alto) → \$1Promise\$1Promesa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensaje: cadena\$1 >\$1
](#requestResolution)
+ [

### sendKeyboardEvent(evento) → \$1boolean\$1
](#sendKeyboardEvent)
+ [

### sendKeyboardShortcut(acceso directo) → \$1vacío\$1
](#sendKeyboardShortcut)
+ [

### setDisplayQuality(min, maxopt) → \$1vacío\$1
](#setDisplayQuality)
+ [

### setDisplayScale(scaleRatio, displayID) → \$1Promise\$1Promesa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensaje: cadena\$1 >\$1 (OBSOLETO)
](#setDisplayScale)
+ [

### setKeyboardQuirks(peculiaridades) → \$1vacío\$1
](#setKeyboardQuirks)
+ [

### setMaxDisplayResolución (maxWidth, maxHeight) → \$1void\$1
](#setMaxDisplayResolution)
+ [

### SetMicrophone (activar) → \$1Promise\$1Promise. < \$1código: [AudioErrorCode](dcv-module.md#AudioErrorCode), mensaje: cadena\$1 >\$1
](#setMicrophone)
+ [

### setMinDisplayResolución (minWidth, minHeight) → \$1void\$1
](#setMinDisplayResolution)
+ [

### setUploadBandwidth(valor) → \$1número\$1
](#setUploadBandwidth)
+ [

### setVolume(volume) → \$1void\$1
](#setVolume)
+ [

### setMicrophone (habilitar, DeviceID) → \$1Promise\$1Promise. < \$1código:, mensaje: [AudioErrorCode](dcv-module.md#AudioErrorCode)cadena\$1 >\$1
](#setMicrophone)
+ [

### setWebcam (habilitar, DeviceID) → \$1Promise\$1Promise. < \$1código:, mensaje: [WebcamErrorCode](dcv-module.md#WebcamErrorCode)cadena\$1 >\$1
](#setWebcam)
+ [

### syncClipboards() → \$1boolean\$1
](#syncClipboards)

### attachDisplay (win, DisplayConf) → \$1Promesa. <number>\$1Promesa. < \$1código: [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), mensaje: cadena\$1 >\$1
<a name="attachDisplay"></a>

 Asocia una pantalla específica a una ventana. No se puede asociar la pantalla principal. Si se realiza correctamente, la función devuelve el `displayId`. 

#### Parámetros:
<a name="parameters-1"></a>


|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Atributos  |  Description (Descripción)  | 
| --- | --- | --- | --- | 
|  win  |  Objeto  |  Ventana a la que se debe asociar la pantalla.  | 
|  displayConf  |  Objeto  |  Configuración de la pantalla. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/dcv/latest/websdkguide/connection-class.html)  | 
|  displayId  |  número  |  <optional>  |  ID de la pantalla.  | 
|  displayDivName  |   |   |  Nombre de div. de pantalla.  | 

#### Devuelve:
<a name="returns"></a>

 Promesa. Si se rechaza, la promesa devuelve un objeto de error. 

 Tipo   
 Promesa. <number>\$1 Promesa. < \$1código: [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), mensaje: cadena\$1 > 

### captureClipboardEvents(activado, win, displayID) → \$1void\$1
<a name="captureClipboardEvents"></a>

 Inicia o detiene la escucha de eventos de copiar y pegar. En el caso de los portapapeles interactivos (siempre en el caso de pegar) tenemos que empezar a escuchar los copy/paste eventos. Podría ser útil iniciar y detener la escucha solo cuando sea necesario, por ejemplo, cuando se muestre un modal. 

#### Parámetros:
<a name="parameters-2"></a>


|  Name  |  Tipo  |  Atributos  |  Description (Descripción)  | 
| --- | --- | --- | --- | 
|  enabled  |  booleano  |   |  Para empezar a escuchar eventos, especifique true. Para empezar a escuchar eventos, especifique false.  | 
|  win  |  Objeto  |  <optional>  |  Ventana en la que se van a escuchar eventos. Si se omite, se utiliza la ventana predeterminada.  | 
|  displayId  |  número  |  <optional>  |  ID de la pantalla que debe escuchar los eventos. Si se omite, se utiliza la pantalla predeterminada de la ventana.  | 

#### Devuelve:
<a name="returns-1"></a>

 Tipo   
 void 

### detachDisplay(displayId) → \$1void\$1
<a name="detachDisplay"></a>

 Desasocia una pantalla específica. La pantalla principal no se puede desasociar. 

#### Parámetros:
<a name="parameters-3"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  displayId  |  número  |  ID de la pantalla que se va a desasociar.  | 

#### Devuelve:
<a name="returns-2"></a>

 Tipo   
 void 

### disconnect() → \$1void\$1
<a name="disconnect"></a>

 Se desconecta del servidor Amazon DCV y cierra la conexión. 

#### Devuelve:
<a name="returns-3"></a>

 Tipo   
 void 

### disconnectCollaborator(connectionId) → \$1void\$1
<a name="disconnectCollaborator"></a>

 Solicita la desconexión del colaborador conectado con el identificador de conexión proporcionado (desde Amazon DCV Web Client SDK versión 1.1.0). 

#### Parámetros:
<a name="parameters-4"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  connectionId  |  booleano  |  Identificador de la conexión que se desconectará.  | 

#### Devuelve:
<a name="returns-4"></a>

 Tipo   
 void 

### enableDisplayQualityActualizaciones (activar) → \$1void\$1
<a name="enableDisplayQualityUpdates"></a>

 Habilita o deshabilita las actualizaciones de calidad de pantalla para las áreas de streaming que no reciben actualizaciones. Al deshabilitar las actualizaciones de calidad de pantalla se reduce el uso de ancho de banda, pero también la calidad de pantalla. 

#### Parámetros:
<a name="parameters-5"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Para habilitar las actualizaciones de la calidad de pantalla, especifique true. Para deshabilitar las actualizaciones de la calidad de pantalla, especifique false.  | 

#### Devuelve:
<a name="returns-5"></a>

 Tipo   
 void 

### enableHighPixelDensidad (activar) → \$1void\$1
<a name="enableHighPixelDensity"></a>

 Habilita o deshabilita la alta densidad de píxeles en el cliente. 

#### Parámetros:
<a name="parameters-5"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Si se debe habilitar o no la alta densidad de píxeles.  | 

#### Devuelve:
<a name="returns-5"></a>

 Tipo   
 void 

### enableTimezoneRedirection(habilitar) → \$1Promise\$1Promesa. < \$1código: [TimezoneRedirectionErrorCode](dcv-module.md#TimezoneRedirectionErrorCode), mensaje: cadena\$1 >\$1
<a name="enableTimezoneRedirection"></a>

 Habilita o deshabilita el redireccionamiento de zona horaria. Si se habilita, el cliente solicita al servidor que ajuste la zona horaria del escritorio del servidor coincida a la zona horaria del cliente. 

#### Parámetros:
<a name="parameters-5"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Para habilitar el redireccionamiento de zona horaria, especifique true. Para deshabilitar el redireccionamiento de zona horaria, especifique false.  | 

#### Devuelve:
<a name="returns-5"></a>

 Promesa. Si se rechaza, la promesa devuelve un objeto de error. 

 Tipo   
 Promesa. <number>\$1 Promesa. < \$1código: [TimezoneRedirectionErrorCode](dcv-module.md#TimezoneRedirectionErrorCode), mensaje: cadena\$1 > 

### enterRelativeMouseModo () → \$1vacío\$1
<a name="enterRelativeMouseMode"></a>

 Habilita el modo de ratón relativo. 

#### Devuelve:
<a name="returns65"></a>

 Tipo   
 void 

### getConnectedDevices() → \$1Promesa. <Matriz. < MediaDeviceInfo >>\$1Promesa. < \$1message: string\$1 >\$1
<a name="getConnectedDevices"></a>

 Solicita una lista de los dispositivos multimedia conectados al ordenador cliente. 

#### Devuelve:
<a name="returns-7"></a>

 Si tiene éxito, devuelve una promesa que se convierte en una matriz de MediaDeviceInfo objetos. Para obtener más información, consulte https://developer.mozilla. org/en-US/docs/Web/API/MediaDeviceInfo. Si se rechaza, la promesa devuelve un objeto de error. 

 Tipo   
 Promesa. <Array. < MediaDeviceInfo >> \$1 Promesa. < \$1message: string\$1 > 

### getFileExplorer() → \$1Promesa. < almacenamiento de [archivos >\$1Promesa.](dcv-module.md#filestorage) < \$1código: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), mensaje: cadena\$1 >\$1
<a name="getFileExplorer"></a>

 Obtiene un objeto para administrar el almacenamiento de archivos del servidor Amazon DCV. 

#### Devuelve:
<a name="returns-8"></a>

 Promesa. Se resuelve en el objeto del explorador de archivos si se cumple o en un objeto de error si se rechaza. 

 Tipo   
 Promesa. < [filestorage](dcv-module.md#filestorage) > \$1 Promesa. < \$1código: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), mensaje: cadena\$1 > 

### getServerInfo() → \$1[ServerInfo](dcv-module.md#serverInfo)\$1
<a name="getServerInfo"></a>

 Obtiene información acerca del servidor Amazon DCV. 

#### Devuelve:
<a name="returns-9"></a>

 Información sobre el software del servidor. 

 Tipo   
 [serverInfo](dcv-module.md#serverInfo) 

### getScreenshot () → \$1Promise\$1Promesa. < \$1código: [ScreenshotErrorCode](dcv-module.md#ScreenshotErrorCode), mensaje: cadena\$1 >\$1
<a name="getScreenshot"></a>

 Recupera la captura de pantalla del escritorio remoto en formato PNG. La captura de pantalla se devolverá en el observador [screenshotCallback](dcv-module.md#screenshotCallback). `null` se devolverá en su lugar en caso de error. 

#### Devuelve:
<a name="returns-30"></a>

 Promesa que se resuelve si se procesa la solicitud. Si se rechaza, recibimos un objeto de error. 

 Tipo   
 Promesa \$1 Promesa. < \$1código: [ScreenshotErrorCode](dcv-module.md#ScreenshotErrorCode), mensaje: cadena\$1 > 

### getStats() → \$1[stats](dcv-module.md#stats)\$1
<a name="getStats"></a>

 Obtiene estadísticas sobre el servidor Amazon DCV. 

#### Devuelve:
<a name="returns-10"></a>

 Información sobre las estadísticas de streaming. 

 Tipo   
 [stats](dcv-module.md#stats) 

### latchModifierKey(clave, ubicación, isDown) → \$1boolean\$1
<a name="latchModifierKey"></a>

 Envía un solo evento `keydown` o `keyup` de teclado para un modificador permitido. 

#### Parámetros:
<a name="parameters-6"></a>


|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  key  |  Control \$1 Alt \$1 \$1 Meta AltGraph \$1 OS \$1 Shift  |  Tecla que se va a enviar.  | 
|  location  |  KeyboardEvent.ubicación  |  Nombre de la tecla. Para obtener más información, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 
|  isDown  |  booleano  |  Si el evento de tecla que se va a inyectar es keydown (true) o keyup (false).  | 

#### Devuelve:
<a name="returns-11"></a>

 Si la combinación solicitada es válida, la función devuelve `true`; de lo contrario, devuelve `false`. 

 Tipo   
 booleano 

### openChannel (nombre, token de autenticación, devolución de llamadas, espacio de nombres) → \$1Promise\$1Promise. < \$1código:, mensaje: cadena\$1 >\$1 [ChannelErrorCode](dcv-module.md#ChannelErrorCode)
<a name="openChannel"></a>

 Abre un canal de datos personalizado en la conexión si se creó en el servidor Amazon DCV. 

#### Parámetros:
<a name="parameters-7"></a>


|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  name  |  cadena  |  El nombre del canal.  | 
|  authToken  |  cadena  |  Token de autenticación que se utilizará al conectarse al canal.  | 
|  callbacks  |  Objeto  |  Funciones de devolución de llamada onMessage y onClose que se invocan.  | 
|  namespace  |  cadena  |  Espacio de nombres del canal. Disponible desde Amazon DCV Web Client SDK 1.2.0 y Amazon DCV Server 2022.1.  | 

#### Devuelve:
<a name="returns-12"></a>

 Promesa. Si se rechaza, recibimos un objeto de error. 

 Tipo   
 Promesa \$1 Promesa. < \$1código: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), mensaje: cadena\$1 > 

### queryFeature(featureName) → \$1Promise.<\$1enabled: boolean, remote?: string, autoCopy?: boolean, autoPaste?: boolean, serviceStatus?: string, available?: boolean\$1>\$1Promise.<\$1message: string\$1>\$1
<a name="queryFeature"></a>

 Consulta el estado de una característica específica del servidor Amazon DCV. 

#### Parámetros:
<a name="parameters-8"></a>


|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  featureName  |  [feature](dcv-module.md#feature)  |  Nombre de la característica que se va a consultar.  | 

#### Devuelve:
<a name="returns-13"></a>

 Promesa. Si se resuelve, la función devuelve un objeto `status` que siempre contiene una propiedad `enabled` y, posiblemente, también otras propiedades. Si se rechaza, la función devuelve un objeto `error`. 

 Tipo   
 \$1Promise.<\$1enabled: boolean, remote?: string, autoCopy?: boolean, autoPaste?: boolean, serviceStatus?: string, available?: boolean\$1> \$1 Promise.<\$1message: string\$1> 

### registerKeyboardShortcuts(atajos) → \$1vacío\$1
<a name="registerKeyboardShortcuts"></a>

 Registra los métodos abreviados de teclado. 

#### Parámetros:
<a name="parameters-9"></a>


|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  shortcuts  |  Array.<Object>  |  Matriz de teclas y asignaciones que se van a registrar. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/dcv/latest/websdkguide/connection-class.html)  | 
|  sequence  |  Array.<Object>  |  Método abreviado de teclado que se va a registrar. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/dcv/latest/websdkguide/connection-class.html)  | 
|  output  |  Array.<Object>  |  La acción que se pretende realizar con el acceso directo. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/dcv/latest/websdkguide/connection-class.html)  | 
|  key  |  KeyboardEvent.clave  |  Valor de la tecla presionada por el usuario. Para obtener más información, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.ubicación  |  Matriz de teclas que se van a enviar. Ubicación de la tecla en el teclado. Para obtener más información, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 
|  key  |  KeyboardEvent.key  |  Valor de la tecla presionada por el usuario. Para obtener más información, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.ubicación  |  Matriz de teclas que se van a enviar. Ubicación de la tecla en el teclado. Para obtener más información, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 

#### Devuelve:
<a name="returns-14"></a>

 Tipo   
 void 

### requestDisplayConfig(highColorAccuracy) → \$1Promesión\$1Promesa. < \$1código: [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), mensaje: cadena\$1 >\$1
<a name="requestDisplayConfig"></a>

 Solicita una configuración de pantalla actualizada al servidor Amazon DCV. Disponible desde Amazon DCV Web Client SDK 1.1.0 y Amazon DCV Server 2022.0. 

#### Parámetros:
<a name="parameters-10"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  highColorAccuracy  |  booleano  |  Si se debe solicitar alta precisión de color.  | 

#### Devuelve:
<a name="returns-15"></a>

 Promesa. Si se rechaza, la promesa devuelve un objeto de error. 

 Tipo   
 Promesa \$1 Promesa. < \$1código: [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), mensaje: cadena\$1 > 

### requestDisplayLayout(diseño) → \$1Promise\$1Promesa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensaje: cadena\$1 >\$1
<a name="requestDisplayLayout"></a>

 Solicita un diseño de pantalla actualizado para la conexión. 

#### Parámetros:
<a name="parameters-11"></a>


|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  layout  |  Array.<[Monitor](dcv-module.md#Monitor)>  |  Pantallas solicitadas en el diseño.  | 

#### Devuelve:
<a name="returns-16"></a>

 Promesa. Si se rechaza, recibimos un objeto de error. 

 Tipo   
 Promesa \$1 Promesa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensaje: cadena\$1 > 

### requestResolution (ancho, alto) → \$1Promise\$1Promesa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensaje: cadena\$1 >\$1
<a name="requestResolution"></a>

 Solicita una resolución de pantalla actualizada al servidor Amazon DCV. 

#### Parámetros:
<a name="parameters-12"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  width  |  número  |  Ancho que se va a solicitar en píxeles. El valor mínimo permitido es 0.  | 
|  height  |  número  |  Ancho que se va a solicitar en píxeles. El valor mínimo permitido es 0.  | 

#### Devuelve:
<a name="returns-17"></a>

 Promesa. Si se rechaza, la promesa devuelve un objeto de error. 

 Tipo   
 Promesa \$1 Promesa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensaje: cadena\$1 > 

### sendKeyboardEvent(evento) → \$1boolean\$1
<a name="sendKeyboardEvent"></a>

 Envía un evento de método abreviado de teclado. [Para obtener más información sobre los eventos del teclado, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent). Los eventos de teclado válidos incluyen: `keydown`, `keypress` y `keyup`. Para obtener más información sobre estos eventos, consulte [https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent#events)\$1events. 

#### Parámetros:
<a name="parameters-13"></a>


|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  event  |  KeyboardEvent  |  Evento de teclado que se va a enviar.  | 

#### Devuelve:
<a name="returns-18"></a>

 Si el evento no es válido, la función devuelve `false`. Si el evento es válido, la función devuelve `true`. 

 Tipo   
 booleano 

### sendKeyboardShortcut(acceso directo) → \$1vacío\$1
<a name="sendKeyboardShortcut"></a>

 Envía un método abreviado de teclado. Utilice esta función para enviar una secuencia de `keydown` o `keyup` completa. Por ejemplo, si se envía Ctrl \$1 Alt \$1 Supr, se envían los eventos `keydown` para todas las teclas seguidos de los eventos `keyup`. Utilice esta función incluso si desea enviar una sola tecla. 

#### Parámetros:
<a name="parameters-14"></a>


|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  shortcut  |  Array.<Object>  |  Matriz de teclas que se van a enviar. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/dcv/latest/websdkguide/connection-class.html)  | 
|  key  |  KeyboardEvent.clave  |  Valor de la tecla presionada por el usuario. Para obtener más información, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.ubicación  |  Matriz de teclas que se van a enviar. Ubicación de la tecla en el teclado. Para obtener más información, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 

#### Devuelve:
<a name="returns-19"></a>

 Tipo   
 void 

### setDisplayQuality(min, maxopt) → \$1vacío\$1
<a name="setDisplayQuality"></a>

 Establece la calidad de imagen que se utilizará en la conexión. El intervalo válido es de `0` a `100`, siendo `1` la calidad de imagen más baja y `100` la calidad de imagen más alta. Especifique `0` para retener el valor actual. 

#### Parámetros:
<a name="parameters-15"></a>


|  Name  |  Tipo  |  Atributos  |  Description (Descripción)  | 
| --- | --- | --- | --- | 
|  min  |  número  |   |  Calidad de imagen mínima.  | 
|  max  |  número  |  <optional>  |  Calidad de imagen máxima.  | 

#### Devuelve:
<a name="returns-20"></a>

 Tipo   
 void 

### setDisplayScale(scaleRatio, displayID) → \$1Promise\$1Promesa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensaje: cadena\$1 >\$1 (OBSOLETO)
<a name="setDisplayScale"></a>

 Obsoleto a partir de la versión 1.3.0. Ya no es necesario configurar la escala de pantalla. Las coordenadas del ratón se gestionarán automáticamente de forma interna. 

 Notifica a Amazon DCV que la pantalla está escalada en el lado del cliente. Utilice esta opción para notificar al servidor que necesita escalar los eventos del ratón para que coincidan con la relación de pantalla del cliente. 

#### Parámetros:
<a name="parameters-16"></a>


|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  scaleRatio  |  float  |  Relación de escala que se va a utilizar. Debe ser un número estrictamente positivo.  | 
|  displayId  |  número  |  ID de la pantalla que se va a escalar.  | 

#### Devuelve:
<a name="returns-21"></a>

 Promesa. Si se rechaza, la promesa devuelve un objeto de error. 

 Tipo   
 Promesa \$1 Promesa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensaje: cadena\$1 > 

### setKeyboardQuirks(peculiaridades) → \$1vacío\$1
<a name="setKeyboardQuirks"></a>

 Establece las peculiaridades del teclado del ordenador cliente. 

#### Parámetros:
<a name="parameters-17"></a>


|  Name  |  Tipo  |  Description (Descripción)  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  quirks  |  Objeto  |  Peculiaridades del teclado que se habilitarán o deshabilitarán. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/dcv/latest/websdkguide/connection-class.html)  | 
|  macOptionToAlt  |  booleano  |  Para asignar la tecla Opción a Alt para macOS, especifique true. De lo contrario, especifique false.  | 
|  macCommandToControl  |  booleano  |  Para asignar la tecla Comando a Ctrl para macOS, especifique true. De lo contrario, especifique false.  | 

#### Devuelve:
<a name="returns-22"></a>

 Tipo   
 void 

### setMaxDisplayResolución (maxWidth, maxHeight) → \$1void\$1
<a name="setMaxDisplayResolution"></a>

 Establece la resolución máxima de pantalla que se utilizará en la conexión. 

#### Parámetros:
<a name="parameters-18"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  maxWidth  |  número  |  Ancho máximo de pantalla en píxeles. El valor mínimo permitido es 0.  | 
|  maxHeight  |  número  |  Alto máximo de pantalla en píxeles. El valor mínimo permitido es 0.  | 

#### Devuelve:
<a name="returns-23"></a>

 Tipo   
 void 

### SetMicrophone (activar) → \$1Promise\$1Promise. < \$1código: [AudioErrorCode](dcv-module.md#AudioErrorCode), mensaje: cadena\$1 >\$1
<a name="setMicrophone"></a>

 Habilita o deshabilita el micrófono. 

#### Parámetros:
<a name="parameters-19"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Para habilitar el micrófono, especifique true. Para deshabilitar el micrófono, especifique false.  | 

#### Devuelve:
<a name="returns-24"></a>

 Promesa. Si se rechaza, la promesa devuelve un objeto de error. 

 Tipo   
 Promesa \$1 Promesa. < \$1código: [AudioErrorCode](dcv-module.md#AudioErrorCode), mensaje: cadena\$1 > 

### setMinDisplayResolución (minWidth, minHeight) → \$1void\$1
<a name="setMinDisplayResolution"></a>

 Establece la resolución mínima de pantalla que se utilizará en la conexión. Es posible que algunas aplicaciones requieran una resolución mínima de pantalla. Si la resolución mínima requerida es mayor que la resolución máxima admitida por el cliente, se utiliza una estrategia de cambio de tamaño. Utilice esta función con cuidado. La estrategia de cambio de tamaño podría provocar que el ratón y el sistema de entrada táctil fueran menos precisos. 

#### Parámetros:
<a name="parameters-20"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  minWidth  |  número  |  Ancho mínimo de pantalla en píxeles. El valor mínimo permitido es 0.  | 
|  minHeight  |  número  |  Alto mínimo de pantalla en píxeles. El valor mínimo permitido es 0.  | 

#### Devuelve:
<a name="returns-25"></a>

 Tipo   
 void 

### setUploadBandwidth(valor) → \$1número\$1
<a name="setUploadBandwidth"></a>

 Establece el ancho de banda máximo que se utilizará para cargar archivos en el servidor Amazon DCV. 

#### Parámetros:
<a name="parameters-21"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  value  |  número  |  Ancho de banda de subida máximo en Kbps. El intervalo válido es de 1024 kbps a 102400 kbps.  | 

#### Devuelve:
<a name="returns-26"></a>

 - Límite de ancho de banda establecido. `null` si la característica de almacenamiento de archivos está deshabilitada en el servidor. 

 Tipo   
 número 

### setVolume(volume) → \$1void\$1
<a name="setVolume"></a>

 Establece el nivel de volumen que se utilizará en el audio. El intervalo válido es de 0 a 100, donde 0 es el volumen más bajo y 100 el más alto. 

#### Parámetros:
<a name="parameters-22"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  volume  |  número  |  Nivel de volumen que utilizará.  | 

#### Devuelve:
<a name="returns-27"></a>

 Tipo   
 void 

### setMicrophone (habilitar, DeviceID) → \$1Promise\$1Promise. < \$1código:, mensaje: [AudioErrorCode](dcv-module.md#AudioErrorCode)cadena\$1 >\$1
<a name="setMicrophone"></a>

 [Experimental: podría cambiar en el futuro] Habilita o deshabilita el micrófono. 

#### Parámetros:
<a name="parameters-23"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Para habilitar el micrófono, especifique true. Para deshabilitar el micrófono, especifique false.  | 
|  deviceId  |  cadena  |  El ID de dispositivo del micrófono. Si no se proporciona ningún deviceId, se utiliza el deviceId default.  | 

#### Devuelve:
<a name="returns-28"></a>

 Promesa. Si se rechaza, la promesa devuelve un objeto de error. 

 Tipo   
 Promesa \$1 Promesa. < \$1código: [AudioErrorCode](dcv-module.md#AudioErrorCode), mensaje: cadena\$1 > 

### setWebcam (habilitar, DeviceID) → \$1Promise\$1Promise. < \$1código:, mensaje: [WebcamErrorCode](dcv-module.md#WebcamErrorCode)cadena\$1 >\$1
<a name="setWebcam"></a>

 Habilita o deshabilita la cámara web. 

#### Parámetros:
<a name="parameters-23"></a>


|  Name  |  Tipo  |  Descripción  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Para habilitar la cámara web, especifique true. Para deshabilitar la cámara web, especifique false.  | 
|  deviceId  |  cadena  |  ID de dispositivo de la cámara web.  | 

#### Devuelve:
<a name="returns-28"></a>

 Prométeme que, si tiene éxito, se resolverá en el DeviceID de la attached/detached cámara web. Si se rechaza, la promesa devuelve un objeto de error. 

 Tipo   
 Promesa. <string>\$1 Promesa. < \$1código: [WebcamErrorCode](dcv-module.md#WebcamErrorCode), mensaje: cadena\$1 > 

### syncClipboards() → \$1boolean\$1
<a name="syncClipboards"></a>

 Sincroniza el portapapeles del cliente local con el portapapeles del servidor Amazon DCV remoto. El navegador debe admitir la función de copia automática. 

#### Devuelve:
<a name="returns-29"></a>

 Si los portapapeles se han sincronizado, la función devuelve `true`. Si los portapapeles no se han sincronizado o si el navegador no admite copia automática, la función devuelve `false`. 

 Tipo   
 booleano