As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Classe de conexão
<a name="connection-class"></a>

A Classe de conexão obtida chamando o [método `connect`](dcv-module.md#connect) do modulo `dcv`. Para ver um exemplo de como usá-lo, consulte a seção [Introdução](establish-connection.md#auth-conn).

**Topics**
+ [Métodos](#methods)

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

**Topics**
+ [attachDisplay (win, displayConf) → \$1Promise. <number>\$1Promessa. < \$1código: [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), mensagem: string\$1 >\$1](#attachDisplay)
+ [captureClipboardEvents(ativado, win, displayID) → \$1void\$1](#captureClipboardEvents)
+ [detachDisplay(displayId) → \$1void\$1](#detachDisplay)
+ [disconnect() → \$1void\$1](#disconnect)
+ [disconnectCollaborator(connectionId) → \$1void\$1](#disconnectCollaborator)
+ [enableDisplayQualityAtualizações (ativar) → \$1void\$1](#enableDisplayQualityUpdates)
+ [enableHighPixelDensidade (ativar) → \$1vazio\$1](#enableHighPixelDensity)
+ [enableTimezoneRedirection(habilitar) → \$1Promise\$1Promessa. < \$1código: [TimezoneRedirectionErrorCode](dcv-module.md#TimezoneRedirectionErrorCode), mensagem: string\$1 >\$1](#enableTimezoneRedirection)
+ [enterRelativeMouseModo () → \$1void\$1](#enterRelativeMouseMode)
+ [getConnectedDevices() → \$1Promessa. <Matriz. < MediaDeviceInfo >>\$1Promessa. < \$1message: string\$1 >\$1](#getConnectedDevices)
+ [getFileExplorer() → \$1Promessa. < armazenamento de [arquivos >\$1Promessa](dcv-module.md#filestorage). < \$1código: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), mensagem: string\$1 >\$1](#getFileExplorer)
+ [getServerInfo() → \$1Informações do [servidor](dcv-module.md#serverInfo)\$1](#getServerInfo)
+ [getScreenshot () → \$1Promise\$1Promessa. < \$1código: [ScreenshotErrorCode](dcv-module.md#ScreenshotErrorCode), mensagem: string\$1 >\$1](#getScreenshot)
+ [getStats() → \$1[stats](dcv-module.md#stats)\$1](#getStats)
+ [latchModifierKey(chave, localização, isDown) → \$1boolean\$1](#latchModifierKey)
+ [OpenChannel (nome, authToken, retornos de chamada, namespace) → \$1Promise\$1Promise. < \$1código: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), mensagem: string\$1 >\$1](#openChannel)
+ [queryFeature(featureName) → \$1Promise.<\$1enabled: boolean, remote?: string, autoCopy?: boolean, autoPaste?: boolean, serviceStatus?: string, available?: boolean\$1>\$1Promise.<\$1message: string\$1>\$1](#queryFeature)
+ [registerKeyboardShortcuts(atalhos) → \$1void\$1](#registerKeyboardShortcuts)
+ [requestDisplayConfig(highColorAccuracy) → \$1Promessa\$1Promessa. < \$1código: [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), mensagem: string\$1 >\$1](#requestDisplayConfig)
+ [requestDisplayLayout(layout) → \$1Promise\$1Promessa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensagem: string\$1 >\$1](#requestDisplayLayout)
+ [Solicitar resolução (largura, altura) → \$1Promise\$1Promise. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensagem: string\$1 >\$1](#requestResolution)
+ [sendKeyboardEvent(evento) → \$1boolean\$1](#sendKeyboardEvent)
+ [sendKeyboardShortcut(atalho) → \$1void\$1](#sendKeyboardShortcut)
+ [setDisplayQuality(min, maxopt) → \$1vazio\$1](#setDisplayQuality)
+ [setDisplayScale(ScaleRatio, DisplayID) → \$1Promise\$1Promise. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensagem: string\$1 >\$1 (OBSOLETO)](#setDisplayScale)
+ [setKeyboardQuirks(peculiaridades) → \$1vazio\$1](#setKeyboardQuirks)
+ [setMaxDisplayResolução (maxWidth, maxHeight) → \$1void\$1](#setMaxDisplayResolution)
+ [SetMicrophone (enable) → \$1Promise\$1Promise. < \$1código: [AudioErrorCode](dcv-module.md#AudioErrorCode), mensagem: string\$1 >\$1](#setMicrophone)
+ [setMinDisplayResolução (minWidth, minHeight) → \$1void\$1](#setMinDisplayResolution)
+ [setUploadBandwidth(valor) → \$1número\$1](#setUploadBandwidth)
+ [setVolume(volume) → \$1void\$1](#setVolume)
+ [setMicrophone (habilitar, ID do dispositivo) → \$1Promise\$1Promise. < \$1código: [AudioErrorCode](dcv-module.md#AudioErrorCode), mensagem: string\$1 >\$1](#setMicrophone)
+ [setWebcam (habilitar, ID do dispositivo) → \$1Promise\$1Promise. < \$1código: [WebcamErrorCode](dcv-module.md#WebcamErrorCode), mensagem: string\$1 >\$1](#setWebcam)
+ [syncClipboards() → \$1boolean\$1](#syncClipboards)

### attachDisplay (win, displayConf) → \$1Promise. <number>\$1Promessa. < \$1código: [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), mensagem: string\$1 >\$1
<a name="attachDisplay"></a>

 Anexa uma tela específica em uma janela. Você não pode anexar a tela principal. Se bem-sucedida, a função retornará `displayId`. 

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


|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Nome  |  Tipo  |  Atributos  |  Description  | 
| --- | --- | --- | --- | 
|  win  |  Objeto  |  A janela à qual a exibição deve ser anexada.  | 
|  displayConf  |  Objeto  |  A configuração da exibição. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/dcv/latest/websdkguide/connection-class.html)  | 
|  displayId  |  número  |  <opcional>  |  O ID da exibição.  | 
|  displayDivName  |   |   |  O nome do título da div. da exibição.  | 

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

 Promise. Se rejeitada, a promessa retornará um objeto de erro. 

 Tipo   
 Promessa. <number>\$1 Promessa. < \$1código: [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), mensagem: string\$1 > 

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

 Inicia ou para de ouvir eventos de copiar e colar. No caso de pranchetas interativas (sempre no caso de colar), precisamos começar a ouvir os copy/paste eventos. Pode ser útil iniciar e parar de ouvir somente quando necessário, por exemplo, quando um modal é exibido. 

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


|  Nome  |  Tipo  |  Atributos  |  Description  | 
| --- | --- | --- | --- | 
|  enabled  |  boolean  |   |  Para começar a ouvir eventos, especifique true. Para parar de ouvir eventos, especifique false.  | 
|  win  |  Objeto  |  <opcional>  |  A janela na qual se deve ouvir os eventos. Se omitido, a janela padrão será usada.  | 
|  displayId  |  número  |  <opcional>  |  O ID do monitor que deve ouvir os eventos. Se omitido, o monitor padrão da janela será usada.  | 

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

 Tipo   
 nulo 

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

 Desconecta um monitor específico. O monitor principal não pode ser desconectado. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  displayId  |  número  |  O ID da tela a ser desconectado.  | 

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

 Tipo   
 nulo 

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

 Desconecta-se do servidor Amazon DCV e fecha a conexão. 

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

 Tipo   
 nulo 

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

 Solicita a desconexão do colaborador conectado com o ID de conexão fornecido (desde o SDK do Cliente Web do Amazon DCV versão 1.1.0). 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  connectionId  |  boolean  |  O ID da conexão que será desconectada.  | 

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

 Tipo   
 nulo 

### enableDisplayQualityAtualizações (ativar) → \$1void\$1
<a name="enableDisplayQualityUpdates"></a>

 Ativa ou desativa as atualizações de qualidade de exibição para áreas de streaming que não recebem atualizações. Desativar as atualizações da qualidade de exibição reduz o uso da largura de banda, mas também diminui a qualidade da tela. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  enable  |  boolean  |  Para ativar as atualizações da qualidade de exibição, especifique true. Para desativar as atualizações da qualidade de exibição, especifique false.  | 

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

 Tipo   
 nulo 

### enableHighPixelDensidade (ativar) → \$1vazio\$1
<a name="enableHighPixelDensity"></a>

 Ativa ou desativa a alta densidade de pixels no cliente. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  enable  |  booliano  |  Se a alta densidade de pixels deve ou não ser ativada.  | 

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

 Tipo   
 nulo 

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

 Ativa ou desativa o redirecionamento de fuso horário. Depois de ativado, o cliente solicita que o servidor faça com que o fuso horário da área de trabalho do servidor corresponda ao fuso horário do cliente. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  enable  |  boolean  |  Para ativar o redirecionamento de fuso horário, especifique true. Para desativar o redirecionamento de fuso horário, especifique false.  | 

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

 Promise. Se rejeitada, a promessa retornará um objeto de erro. 

 Tipo   
 Promessa. <number>\$1 Promessa. < \$1código: [TimezoneRedirectionErrorCode](dcv-module.md#TimezoneRedirectionErrorCode), mensagem: string\$1 > 

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

 Ativa o modo relativo do mouse. 

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

 Tipo   
 nulo 

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

 Solicita uma lista dos dispositivos de mídia conectados ao computador cliente. 

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

 Se for bem-sucedido, ele retornará uma promessa que é resolvida em uma matriz de MediaDeviceInfo objetos. Para obter mais informações, consulte https://developer.mozilla. org/en-US/docs/Web/API/MediaDeviceInfo. Se rejeitada, a promessa retornará um objeto de erro. 

 Tipo   
 Promessa. <Matriz. < MediaDeviceInfo >> \$1 Promessa. < \$1message: string\$1 > 

### getFileExplorer() → \$1Promessa. < armazenamento de [arquivos >\$1Promessa](dcv-module.md#filestorage). < \$1código: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), mensagem: string\$1 >\$1
<a name="getFileExplorer"></a>

 Obtém um objeto para gerenciar o armazenamento de arquivos do servidor Amazon DCV. 

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

 Promise. Resolve para o objeto explorador de arquivos, se preenchido, ou para um objeto de erro, se rejeitado. 

 Tipo   
 Promessa. < [filestorage](dcv-module.md#filestorage) > \$1 Promessa. < \$1código: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), mensagem: string\$1 > 

### getServerInfo() → \$1Informações do [servidor](dcv-module.md#serverInfo)\$1
<a name="getServerInfo"></a>

 Obtém informações sobre o servidor Amazon DCV. 

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

 Informações sobre o software do servidor. 

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

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

 Recupera a captura de tela da área de trabalho remota no formato PNG. A captura de tela será retornada no observador [screenshotCallback](dcv-module.md#screenshotCallback). Em vez disso, `null` será retornado em caso de falhas. 

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

 Promessa que será resolvida se a solicitação for processada. Se rejeitado, recebemos um objeto de erro. 

 Tipo   
 Promessa \$1 Promessa. < \$1código: [ScreenshotErrorCode](dcv-module.md#ScreenshotErrorCode), mensagem: string\$1 > 

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

 Obtém estatísticas sobre o servidor Amazon DCV. 

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

 Informações sobre as estatísticas de streaming. 

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

### latchModifierKey(chave, localização, isDown) → \$1boolean\$1
<a name="latchModifierKey"></a>

 Envia um único evento `keydown` ou `keyup` do teclado para um modificador permitido. 

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


|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  key  |  Controle \$1 Alt \$1 AltGraph \$1 Meta \$1 OS \$1 Shift  |  A tecla para enviar.  | 
|  location  |  KeyboardEvent.localização  |  O local da tecla. Para obter mais informações, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 
|  isDown  |  booleano  |  Se o evento chave a ser injetado for um keydown (true) ou um keyup (false).  | 

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

 Se a combinação solicitada for válida, a função retornará `true`, caso contrário, retornará `false`. 

 Tipo   
 boolean 

### OpenChannel (nome, authToken, retornos de chamada, namespace) → \$1Promise\$1Promise. < \$1código: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), mensagem: string\$1 >\$1
<a name="openChannel"></a>

 Abre um canal de dados personalizado na conexão se ela tiver sido criada no Servidor Amazon DCV. 

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


|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  name  |  string  |  O nome do canal.  | 
|  authToken  |  string  |  O token de autenticação a ser usado ao se conectar ao servidor.  | 
|  callbacks  |  Objeto  |  Os retornos de chamada onMessage e onClose funcionam para chamar.  | 
|  namespace  |  string  |  O namespace do modelo. Disponível desde o SDK do cliente web do Amazon DCV 1.2.0 e o Servidor Amazon DCV 2022.1.  | 

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

 Promise. Se rejeitado, recebemos um objeto de erro. 

 Tipo   
 Promessa \$1 Promessa. < \$1código: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), mensagem: string\$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 o status de um recurso específico do servidor Amazon DCV. 

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


|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  featureName  |  [feature](dcv-module.md#feature)  |  O nome do atributo a ser consultado.  | 

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

 Promise. Se resolvida, a função retorna um objeto `status` que sempre contém uma propriedade `enabled` e, possivelmente, também outras propriedades. Se rejeitada, a função retornará um objeto `error`. 

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

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

 Registra os atalhos de teclado. 

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


|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  shortcuts  |  Array.<Object>  |  A matriz de chaves e mapeamentos a serem registrados. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/dcv/latest/websdkguide/connection-class.html)  | 
|  sequence  |  Array.<Object>  |  O atalho do teclado para se registrar. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/dcv/latest/websdkguide/connection-class.html)  | 
|  output  |  Array.<Object>  |  A ação que deve ser executada pelo atalho. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/dcv/latest/websdkguide/connection-class.html)  | 
|  key  |  KeyboardEvent.chave  |  O valor da tecla pressionada pelo usuário. Para obter mais informações, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.localização  |  A matriz de chaves a serem enviadas. A localização da tecla no teclado. Para obter mais informações, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 
|  key  |  KeyboardEvent.chave  |  O valor da tecla pressionada pelo usuário. Para obter mais informações, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.localização  |  A matriz de chaves a serem enviadas. A localização da tecla no teclado. Para obter mais informações, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 

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

 Tipo   
 nulo 

### requestDisplayConfig(highColorAccuracy) → \$1Promessa\$1Promessa. < \$1código: [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), mensagem: string\$1 >\$1
<a name="requestDisplayConfig"></a>

 Solicita uma configuração de exibição atualizada do servidor Amazon DCV. Disponível desde o SDK do cliente web do Amazon DCV 1.1.0 e o Servidor Amazon DCV 2022.0. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  highColorAccuracy  |  boolean  |  Se a alta precisão de cores deve ou não ser solicitada.  | 

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

 Promise. Se rejeitada, a promessa retornará um objeto de erro. 

 Tipo   
 Promessa \$1 Promessa. < \$1código: [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), mensagem: string\$1 > 

### requestDisplayLayout(layout) → \$1Promise\$1Promessa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensagem: string\$1 >\$1
<a name="requestDisplayLayout"></a>

 Solicita um layout de exibição atualizado para a conexão. 

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


|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  layout  |  Array.<[Monitor](dcv-module.md#Monitor)>  |  O solicitado é exibido no layout.  | 

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

 Promise. Se rejeitado, recebemos um objeto de erro. 

 Tipo   
 Promessa \$1 Promessa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensagem: string\$1 > 

### Solicitar resolução (largura, altura) → \$1Promise\$1Promise. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensagem: string\$1 >\$1
<a name="requestResolution"></a>

 Solicita uma resolução de exibição atualizada do servidor Amazon DCV. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  width  |  número  |  A largura a ser solicitada em pixels. O valor mínimo permitido é 0.  | 
|  height  |  número  |  A altura a ser solicitada em pixels. O valor mínimo permitido é 0.  | 

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

 Promise. Se rejeitada, a promessa retornará um objeto de erro. 

 Tipo   
 Promessa \$1 Promessa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensagem: string\$1 > 

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

 Envia um evento de atalho de teclado. Para obter mais informações sobre eventos de teclado, consulte [https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent). Os eventos de teclado válidos incluem: `keydown`, `keypress` e `keyup`. Para obter mais informações sobre esses 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>


|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  event  |  KeyboardEvent  |  O evento de teclado a ser enviado.  | 

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

 Se o evento não for válido, a função retornará `false`. Se o evento for válido, a função retornará `true`. 

 Tipo   
 boolean 

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

 Envia um atalho de teclado. Use essa função para enviar uma sequência completa de `keydown` ou `keyup`. Por exemplo, enviar Ctrl \$1 Alt \$1 Del envia os eventos `keydown` para todas as teclas seguidas pelos eventos `keyup`. Use essa função mesmo se quiser enviar uma única chave. 

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


|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  shortcut  |  Array.<Object>  |  A matriz de chaves a serem enviadas. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/dcv/latest/websdkguide/connection-class.html)  | 
|  key  |  KeyboardEvent.chave  |  O valor da tecla pressionada pelo usuário. Para obter mais informações, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.localização  |  A matriz de chaves a serem enviadas. A localização da tecla no teclado. Para obter mais informações, consulte https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 

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

 Tipo   
 nulo 

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

 Define a qualidade da imagem a ser usada para a conexão. O intervalo válido é `0` a `100`, sendo `1` a menor qualidade de imagem e `100` a mais alta qualidade de imagem. Especifique `0` para reter o valor atual. 

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


|  Nome  |  Tipo  |  Atributos  |  Description  | 
| --- | --- | --- | --- | 
|  min  |  número  |   |  A qualidade mínima da imagem.  | 
|  max  |  número  |  <opcional>  |  A qualidade máxima da imagem.  | 

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

 Tipo   
 nulo 

### setDisplayScale(ScaleRatio, DisplayID) → \$1Promise\$1Promise. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensagem: string\$1 >\$1 (OBSOLETO)
<a name="setDisplayScale"></a>

 Obsoleto desde a versão 1.3.0. Não há mais necessidade de definir a escala de exibição. As coordenadas do mouse serão gerenciadas internamente de forma automática. 

 Notifica o Amazon DCV de que a tela está escalada no lado do cliente. Use isso para notificar o servidor de que ele precisa escalar os eventos do mouse para corresponder à proporção de exibição do cliente. 

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


|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  scaleRatio  |  flutuação  |  A taxa de escala a ser usada. Deve ser um número estritamente positivo.  | 
|  displayId  |  número  |  O ID da tela a ser escalada.  | 

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

 Promise. Se rejeitada, a promessa retornará um objeto de erro. 

 Tipo   
 Promessa \$1 Promessa. < \$1código: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), mensagem: string\$1 > 

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

 Define peculiaridades do teclado para o computador cliente. 

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


|  Nome  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  quirks  |  Objeto  |  As peculiaridades do teclado a serem ativadas ou desativadas. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/dcv/latest/websdkguide/connection-class.html)  | 
|  macOptionToAlt  |  boolean  |  Para mapear a tecla Option como Alt no macOS, especifique true. Caso contrário, especifique false.  | 
|  macCommandToControl  |  boolean  |  Para mapear a tecla Command como Ctrl no macOS, especifique true. Caso contrário, especifique false.  | 

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

 Tipo   
 nulo 

### setMaxDisplayResolução (maxWidth, maxHeight) → \$1void\$1
<a name="setMaxDisplayResolution"></a>

 Define a resolução máxima da tela a ser usada para a conexão. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  maxWidth  |  número  |  A largura máxima da tela em pixels. O valor mínimo permitido é 0.  | 
|  maxHeight  |  número  |  A altura máxima da tela em pixels. O valor mínimo permitido é 0.  | 

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

 Tipo   
 nulo 

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

 Ativa ou desativa o microfone. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  enable  |  boolean  |  Para ativar o microfone, especifique true. Para desativar o microfone, especifique false.  | 

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

 Promise. Se rejeitada, a promessa retornará um objeto de erro. 

 Tipo   
 Promessa \$1 Promessa. < \$1código: [AudioErrorCode](dcv-module.md#AudioErrorCode), mensagem: string\$1 > 

### setMinDisplayResolução (minWidth, minHeight) → \$1void\$1
<a name="setMinDisplayResolution"></a>

 Define a resolução mínima da tela a ser usada para a conexão. Alguns aplicativos podem exigir uma resolução mínima da tela. Se a resolução mínima exigida for maior que a resolução máxima compatível com o cliente, será usada uma estratégia de redimensionamento. Use essa função com cuidado. A estratégia de redimensionamento pode fazer com que o sistema de entrada do mouse e do teclado fique menos preciso. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  minWidth  |  número  |  A largura mínima da tela em pixels. O valor mínimo permitido é 0.  | 
|  minHeight  |  número  |  A largura mínima da tela em pixels. O valor mínimo permitido é 0.  | 

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

 Tipo   
 nulo 

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

 Define a largura de banda máxima a ser usada para carregar arquivos no servidor Amazon DCV. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  value  |  número  |  O limite máxima da largura de banda em Kbps. O intervalo válido é de 1.024 kbps a 102.400 kbps.  | 

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

 - O limite de largura de banda definido. `null` se o atributo de armazenamento de arquivos estiver desativado no servidor. 

 Tipo   
 número 

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

 Define o nível de volume a ser usado para áudio. O intervalo válido é de 0 a 100, sendo 0 o volume mais baixo e 100 sendo o volume mais alto. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  volume  |  número  |  O nível de volume a ser usado.  | 

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

 Tipo   
 nulo 

### setMicrophone (habilitar, ID do dispositivo) → \$1Promise\$1Promise. < \$1código: [AudioErrorCode](dcv-module.md#AudioErrorCode), mensagem: string\$1 >\$1
<a name="setMicrophone"></a>

 [Experimental - pode mudar no futuro] Ativa ou desativa o microfone. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  enable  |  boolean  |  Para ativar o microfone, especifique true. Para desativar o microfone, especifique false.  | 
|  deviceId  |  string  |  O ID do dispositivo do microfone. Se nenhum deviceId for fornecido, o deviceId default será usado.  | 

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

 Promise. Se rejeitada, a promessa retornará um objeto de erro. 

 Tipo   
 Promessa \$1 Promessa. < \$1código: [AudioErrorCode](dcv-module.md#AudioErrorCode), mensagem: string\$1 > 

### setWebcam (habilitar, ID do dispositivo) → \$1Promise\$1Promise. < \$1código: [WebcamErrorCode](dcv-module.md#WebcamErrorCode), mensagem: string\$1 >\$1
<a name="setWebcam"></a>

 Ativa ou desativa a webcam. 

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


|  Nome  |  Tipo  |  Descrição  | 
| --- | --- | --- | 
|  enable  |  boolean  |  Para ativar a webcam, especifique true. Para desativar a webcam, especifique false.  | 
|  deviceId  |  string  |  O ID do dispositivo da webcam.  | 

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

 Prometa que, se for bem-sucedida, será resolvida para o ID do dispositivo da attached/detached webcam. Se rejeitada, a promessa retornará um objeto de erro. 

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

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

 Sincroniza a área de transferência do cliente local com a área de transferência remota do servidor Amazon DCV. A cópia automática deve ser compatível com o navegador. 

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

 Se as áreas de transferência tiverem sido sincronizadas, a função retornará `true`. Se as áreas de transferência não tiverem sido sincronizadas ou se o navegador não for compatível com a cópia automática, a função retornará `false`. 

 Tipo   
 boolean