

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Classe di connessione
<a name="connection-class"></a>

La classe di connessione ottenuta chiamando il [`connect`metodo](dcv-module.md#connect) del `dcv` modulo. Per un esempio che mostra come usarlo, consulta la sezione [Guida introduttiva](establish-connection.md#auth-conn).

**Topics**
+ [

## Metodi
](#methods)

## Metodi
<a name="methods"></a>

**Topics**
+ [

### attachDisplay (win, displayConf) → \$1Promessa. <number>\$1Promessa. < \$1codice: [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), messaggio: stringa\$1 >\$1
](#attachDisplay)
+ [

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

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

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

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

### enableDisplayQualityAggiornamenti (abilita) → \$1void\$1
](#enableDisplayQualityUpdates)
+ [

### enableHighPixelDensità (abilita) → \$1void\$1
](#enableHighPixelDensity)
+ [

### enableTimezoneRedirection(abilita) → \$1Promise\$1Promessa. < \$1codice: [TimezoneRedirectionErrorCode](dcv-module.md#TimezoneRedirectionErrorCode), messaggio: stringa\$1 >\$1
](#enableTimezoneRedirection)
+ [

### enterRelativeMouseModalità () → \$1void\$1
](#enterRelativeMouseMode)
+ [

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

### getFileExplorer() → \$1Promessa. < [filestorage](dcv-module.md#filestorage) >\$1Promessa. < \$1codice: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), messaggio: stringa\$1 >\$1
](#getFileExplorer)
+ [

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

### getScreenshot () → \$1Promise\$1Promessa. < \$1codice: [ScreenshotErrorCode](dcv-module.md#ScreenshotErrorCode), messaggio: stringa\$1 >\$1
](#getScreenshot)
+ [

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

### latchModifierKey(chiave, posizione, isDown) → \$1boolean\$1
](#latchModifierKey)
+ [

### openChannel (name, authToken, callback, namespace) → \$1Promise\$1Promise. < \$1codice:, messaggio: stringa\$1 >\$1 [ChannelErrorCode](dcv-module.md#ChannelErrorCode)
](#openChannel)
+ [

### queryFeature (featureName) → \$1Promessa. < \$1abilitato: booleano, remoto? : stringa, copia automatica? : booleano, autoPaste? : booleano, ServiceStatus? : stringa, disponibile? : boolean\$1 >\$1Promessa. < \$1message: string\$1 >\$1
](#queryFeature)
+ [

### registerKeyboardShortcuts(scorciatoie) → \$1void\$1
](#registerKeyboardShortcuts)
+ [

### requestDisplayConfig(highColorAccuracy) → \$1Promise\$1Promessa. < \$1codice: [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), messaggio: stringa\$1 >\$1
](#requestDisplayConfig)
+ [

### requestDisplayLayout(layout) → \$1Promise\$1Promessa. < \$1codice: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), messaggio: stringa\$1 >\$1
](#requestDisplayLayout)
+ [

### RequestResolution (larghezza, altezza) → \$1Promise\$1Promessa. < \$1codice: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), messaggio: stringa\$1 >\$1
](#requestResolution)
+ [

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

### sendKeyboardShortcut(scorciatoia) → \$1void\$1
](#sendKeyboardShortcut)
+ [

### setDisplayQuality(min, maxopt) → \$1void\$1
](#setDisplayQuality)
+ [

### setDisplayScale(ScaleRatio, displayID) → \$1Promise\$1Promessa. < \$1code: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), message: string\$1 >\$1 (OBSOLETO)
](#setDisplayScale)
+ [

### setKeyboardQuirks(stranezze) → \$1void\$1
](#setKeyboardQuirks)
+ [

### setMaxDisplayRisoluzione (maxWidth, maxHeight) → \$1void\$1
](#setMaxDisplayResolution)
+ [

### setMicrophone (abilita) → \$1Promise\$1Promessa. < \$1codice: [AudioErrorCode](dcv-module.md#AudioErrorCode), messaggio: stringa\$1 >\$1
](#setMicrophone)
+ [

### setMinDisplayRisoluzione (minWidth, minHeight) → \$1void\$1
](#setMinDisplayResolution)
+ [

### setUploadBandwidth(valore) → \$1numero\$1
](#setUploadBandwidth)
+ [

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

### setMicrophone (enable, deviceID) → \$1Promise\$1Promise. < \$1codice: [AudioErrorCode](dcv-module.md#AudioErrorCode), messaggio: stringa\$1 >\$1
](#setMicrophone)
+ [

### setWebcam (abilita, deviceID) → \$1Promise\$1Promessa. < \$1codice: [WebcamErrorCode](dcv-module.md#WebcamErrorCode), messaggio: stringa\$1 >\$1
](#setWebcam)
+ [

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

### attachDisplay (win, displayConf) → \$1Promessa. <number>\$1Promessa. < \$1codice: [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), messaggio: stringa\$1 >\$1
<a name="attachDisplay"></a>

 Collega uno schermo specifico a una finestra. Non è possibile collegare lo schermo principale. In caso di successo, la funzione restituisce il`displayId`. 

#### Parametri:
<a name="parameters-1"></a>


|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Attributes  |  Description  | 
| --- | --- | --- | --- | 
|  win  |  Oggetto  |  La finestra a cui deve essere collegato lo schermo.  | 
|  displayConf  |  Oggetto  |  La configurazione dello schermo. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/dcv/latest/websdkguide/connection-class.html)  | 
|  displayId  |  numero  |  <optional>  |  L'ID del display.  | 
|  displayDivName  |   |   |  Il nome del div di visualizzazione.  | 

#### Valori restituiti:
<a name="returns"></a>

 Promessa. Se rifiutata, la promessa restituisce un oggetto di errore. 

 Tipo   
 Promessa. <number>\$1 Promessa. < \$1codice: [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), messaggio: stringa\$1 > 

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

 Avvia o interrompe l'ascolto degli eventi copia-incolla. Nel caso degli appunti interattivi (sempre nel caso di incolla) dobbiamo iniziare ad ascoltare gli eventi. copy/paste Potrebbe essere utile avviare e interrompere l'ascolto solo quando è necessario, ad esempio quando viene mostrato un modale. 

#### Parametri:
<a name="parameters-2"></a>


|  Name  |  Tipo  |  Attributes  |  Description  | 
| --- | --- | --- | --- | 
|  enabled  |  booleano  |   |  Per iniziare ad ascoltare gli eventi, specificatrue. Per interrompere l'ascolto degli eventi, specificarefalse.  | 
|  win  |  Oggetto  |  <optional>  |  La finestra in cui ascoltare gli eventi. Se omesso, viene utilizzata la finestra predefinita.  | 
|  displayId  |  numero  |  <optional>  |  L'ID del display che dovrebbe ascoltare gli eventi. Se omesso, viene utilizzata la visualizzazione predefinita della finestra.  | 

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

 Tipo   
 void 

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

 Scollega un display specifico. Lo schermo principale non può essere rimosso. 

#### Parametri:
<a name="parameters-3"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  displayId  |  numero  |  L'ID dello schermo da scollegare.  | 

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

 Tipo   
 void 

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

 Si disconnette dal server Amazon DCV e chiude la connessione. 

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

 Tipo   
 void 

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

 Richiede la disconnessione del collaboratore connesso con l'ID di connessione fornito (a partire dalla versione 1.1.0 di Amazon DCV Web Client SDK). 

#### Parametri:
<a name="parameters-4"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  connectionId  |  booleano  |  L'id della connessione che verrà disconnessa.  | 

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

 Tipo   
 void 

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

 Abilita o disabilita gli aggiornamenti della qualità di visualizzazione per le aree di streaming che non ricevono aggiornamenti. La disabilitazione degli aggiornamenti della qualità dello schermo riduce l'utilizzo della larghezza di banda, ma riduce anche la qualità dello schermo. 

#### Parametri:
<a name="parameters-5"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Per abilitare gli aggiornamenti della qualità dello schermo, specificare. true Per disabilitare gli aggiornamenti della qualità dello schermo, specificarefalse.  | 

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

 Tipo   
 void 

### enableHighPixelDensità (abilita) → \$1void\$1
<a name="enableHighPixelDensity"></a>

 Abilita o disabilita l'alta densità di pixel sul client. 

#### Parametri:
<a name="parameters-5"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Se l'alta densità di pixel deve essere abilitata o meno.  | 

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

 Tipo   
 void 

### enableTimezoneRedirection(abilita) → \$1Promise\$1Promessa. < \$1codice: [TimezoneRedirectionErrorCode](dcv-module.md#TimezoneRedirectionErrorCode), messaggio: stringa\$1 >\$1
<a name="enableTimezoneRedirection"></a>

 Abilita o disabilita il reindirizzamento del fuso orario. Una volta abilitato, il client richiede al server di fare in modo che il fuso orario del desktop del server corrisponda al fuso orario del client. 

#### Parametri:
<a name="parameters-5"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Per abilitare il reindirizzamento del fuso orario, specificare. true Per disabilitare il reindirizzamento del fuso orario, specificare. false  | 

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

 Promessa. Se rifiutata, la promessa restituisce un oggetto di errore. 

 Tipo   
 Promessa. <number>\$1 Promessa. < \$1codice: [TimezoneRedirectionErrorCode](dcv-module.md#TimezoneRedirectionErrorCode), messaggio: stringa\$1 > 

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

 Abilita la modalità relativa del mouse. 

#### Valori restituiti:
<a name="returns65"></a>

 Tipo   
 void 

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

 Richiede un elenco dei dispositivi multimediali collegati al computer client. 

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

 In caso di successo, restituisce una Promise che si risolve in una matrice di MediaDeviceInfo oggetti. Per ulteriori informazioni, vedere https://developer.mozilla. org/en-US/docs/Web/API/MediaDeviceInfo. Se rifiutata, la promessa restituisce un oggetto di errore. 

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

### getFileExplorer() → \$1Promessa. < [filestorage](dcv-module.md#filestorage) >\$1Promessa. < \$1codice: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), messaggio: stringa\$1 >\$1
<a name="getFileExplorer"></a>

 Ottiene un oggetto per gestire lo storage di file del server Amazon DCV. 

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

 Promessa. Risolve all'oggetto File Explorer se soddisfatto o a un oggetto di errore se rifiutato. 

 Tipo   
 Promessa. < [filestorage](dcv-module.md#filestorage) > \$1 Promessa. < \$1codice: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), messaggio: stringa\$1 > 

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

 Ottiene informazioni sul server Amazon DCV. 

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

 Informazioni sul software del server. 

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

### getScreenshot () → \$1Promise\$1Promessa. < \$1codice: [ScreenshotErrorCode](dcv-module.md#ScreenshotErrorCode), messaggio: stringa\$1 >\$1
<a name="getScreenshot"></a>

 Recupera lo screenshot del desktop remoto in formato PNG. [Lo screenshot verrà restituito nell'osservatore ScreenshotCallback.](dcv-module.md#screenshotCallback) `null`verrà restituito invece in caso di guasti. 

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

 Promessa che si risolve se la richiesta viene elaborata. Se rifiutato, riceviamo un oggetto di errore. 

 Tipo   
 Promessa \$1 Promessa. < \$1codice: [ScreenshotErrorCode](dcv-module.md#ScreenshotErrorCode), messaggio: stringa\$1 > 

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

 Ottiene statistiche sul server Amazon DCV. 

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

 Informazioni sulle statistiche di streaming. 

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

### latchModifierKey(chiave, posizione, isDown) → \$1boolean\$1
<a name="latchModifierKey"></a>

 Invia una singola tastiera `keydown` o `keyup` evento per un modificatore consentito. 

#### Parametri:
<a name="parameters-6"></a>


|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  key  |  Controllo \$1 Alt \$1 AltGraph \$1 Meta \$1 OS \$1 Shift  |  La chiave per inviare.  | 
|  location  |  KeyboardEvent.posizione  |  La posizione della chiave. Per ulteriori informazioni, consulta https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 
|  isDown  |  booleano  |  Se l'evento chiave da iniettare è un keydown (true) o un keyup (). false  | 

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

 Se la combinazione richiesta è valida, la funzione ritorna`true`, altrimenti ritorna. `false` 

 Tipo   
 booleano 

### openChannel (name, authToken, callback, namespace) → \$1Promise\$1Promise. < \$1codice:, messaggio: stringa\$1 >\$1 [ChannelErrorCode](dcv-module.md#ChannelErrorCode)
<a name="openChannel"></a>

 Apre un canale dati personalizzato sulla connessione se è stata creata su Amazon DCV Server. 

#### Parametri:
<a name="parameters-7"></a>


|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  name  |  stringa  |  Nome del canale.  | 
|  authToken  |  stringa  |  Il token di autenticazione da utilizzare per connettersi al canale.  | 
|  callbacks  |  Oggetto  |  Le funzioni di callback onMessage e onClose da chiamare.  | 
|  namespace  |  stringa  |  Lo spazio dei nomi del canale. Disponibile a partire da Amazon DCV Web Client SDK 1.2.0 e Amazon DCV Server 2022.1.  | 

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

 Promessa. Se rifiutato, riceviamo un oggetto di errore. 

 Tipo   
 Promessa \$1 Promessa. < \$1codice: [ChannelErrorCode](dcv-module.md#ChannelErrorCode), messaggio: stringa\$1 > 

### queryFeature (featureName) → \$1Promessa. < \$1abilitato: booleano, remoto? : stringa, copia automatica? : booleano, autoPaste? : booleano, ServiceStatus? : stringa, disponibile? : boolean\$1 >\$1Promessa. < \$1message: string\$1 >\$1
<a name="queryFeature"></a>

 Richiede lo stato di una funzionalità specifica del server Amazon DCV. 

#### Parametri:
<a name="parameters-8"></a>


|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  featureName  |  [funzionalità](dcv-module.md#feature)  |  Il nome della funzionalità da interrogare.  | 

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

 Promessa. Se risolta, la funzione restituisce un `status` oggetto che contiene sempre una `enabled` proprietà e possibilmente anche altre proprietà. Se rifiutata, la funzione restituisce un `error` oggetto. 

 Tipo   
 \$1Promessa. < \$1enabled: booleano, remoto? : stringa, copia automatica? : booleano, autoPaste? : booleano, ServiceStatus? : stringa, disponibile? : boolean\$1 > \$1 Promessa. < \$1message: string\$1 > 

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

 Registra le scorciatoie da tastiera. 

#### Parametri:
<a name="parameters-9"></a>


|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  shortcuts  |  Array. <Object>  |  L'array di chiavi e mappature da registrare. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/dcv/latest/websdkguide/connection-class.html)  | 
|  sequence  |  Array. <Object>  |  La scorciatoia da tastiera per la registrazione. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/dcv/latest/websdkguide/connection-class.html)  | 
|  output  |  Matrice. <Object>  |  L'azione prevista da eseguire con la scorciatoia. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/dcv/latest/websdkguide/connection-class.html)  | 
|  key  |  KeyboardEvent.key  |  Il valore del tasto premuto dall'utente. Per ulteriori informazioni, vedere https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.posizione  |  L'array di chiavi da inviare. La posizione del tasto sulla tastiera. Per ulteriori informazioni, vedere https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 
|  key  |  KeyboardEvent.chiave  |  Il valore del tasto premuto dall'utente. Per ulteriori informazioni, vedere https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.posizione  |  L'array di chiavi da inviare. La posizione del tasto sulla tastiera. Per ulteriori informazioni, vedere https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 

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

 Tipo   
 void 

### requestDisplayConfig(highColorAccuracy) → \$1Promise\$1Promessa. < \$1codice: [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), messaggio: stringa\$1 >\$1
<a name="requestDisplayConfig"></a>

 Richiede una configurazione di visualizzazione aggiornata da Amazon DCV Server. Disponibile a partire da Amazon DCV Web Client SDK 1.1.0 e Amazon DCV Server 2022.0. 

#### Parametri:
<a name="parameters-10"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  highColorAccuracy  |  booleano  |  Se deve essere richiesta o meno un'elevata precisione del colore.  | 

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

 Promessa. Se rifiutata, la promessa restituisce un oggetto di errore. 

 Tipo   
 Promessa \$1 Promessa. < \$1codice: [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), messaggio: stringa\$1 > 

### requestDisplayLayout(layout) → \$1Promise\$1Promessa. < \$1codice: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), messaggio: stringa\$1 >\$1
<a name="requestDisplayLayout"></a>

 Richiede un layout di visualizzazione aggiornato per la connessione. 

#### Parametri:
<a name="parameters-11"></a>


|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  layout  |  Array. < [Monitoraggio](dcv-module.md#Monitor) >  |  La richiesta viene visualizzata nel layout.  | 

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

 Promessa. Se rifiutato, riceviamo un oggetto di errore. 

 Tipo   
 Promessa \$1 Promessa. < \$1codice: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), messaggio: stringa\$1 > 

### RequestResolution (larghezza, altezza) → \$1Promise\$1Promessa. < \$1codice: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), messaggio: stringa\$1 >\$1
<a name="requestResolution"></a>

 Richiede una risoluzione dello schermo aggiornata dal server Amazon DCV. 

#### Parametri:
<a name="parameters-12"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  width  |  numero  |  La larghezza da richiedere in pixel. Il valore minimo consentito è0.  | 
|  height  |  numero  |  L'altezza da richiedere in pixel. Il valore minimo consentito è0.  | 

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

 Promessa. Se rifiutata, la promessa restituisce un oggetto di errore. 

 Tipo   
 Promessa \$1 Promessa. < \$1codice: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), messaggio: stringa\$1 > 

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

 Invia un evento di scorciatoia da tastiera. Per ulteriori informazioni sugli eventi da tastiera, consultate [https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent). Gli eventi validi della tastiera includono: `keydown``keypress`, e`keyup`. Per ulteriori informazioni su questi eventi, consulta [https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent#events)\$1events. 

#### Parametri:
<a name="parameters-13"></a>


|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  event  |  KeyboardEvent  |  L'evento della tastiera da inviare.  | 

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

 Se l'evento non è valido, la funzione ritorna`false`. Se l'evento è valido, la funzione ritorna`true`. 

 Tipo   
 booleano 

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

 Invia una scorciatoia da tastiera. Utilizzate questa funzione per inviare un intero `keydown` o una `keyup` sequenza. Ad esempio, l'invio di Ctrl \$1 Alt \$1 Del invia gli `keydown` eventi per tutti i tasti seguiti dagli `keyup` eventi. Utilizzate questa funzione anche se desiderate inviare una sola chiave. 

#### Parametri:
<a name="parameters-14"></a>


|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  shortcut  |  Array. <Object>  |  L'array di chiavi da inviare. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/dcv/latest/websdkguide/connection-class.html)  | 
|  key  |  KeyboardEvent.chiave  |  Il valore del tasto premuto dall'utente. Per ulteriori informazioni, vedere https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.posizione  |  L'array di chiavi da inviare. La posizione del tasto sulla tastiera. Per ulteriori informazioni, vedere https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 

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

 Tipo   
 void 

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

 Imposta la qualità dell'immagine da usare per la connessione. L'intervallo valido è `0` quello di `100``1`, tra la qualità dell'immagine più bassa e `100` la qualità dell'immagine più alta. `0`Specificare per mantenere il valore corrente. 

#### Parametri:
<a name="parameters-15"></a>


|  Name  |  Tipo  |  Attributes  |  Description  | 
| --- | --- | --- | --- | 
|  min  |  numero  |   |  La qualità minima dell'immagine.  | 
|  max  |  numero  |  <optional>  |  La massima qualità dell'immagine.  | 

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

 Tipo   
 void 

### setDisplayScale(ScaleRatio, displayID) → \$1Promise\$1Promessa. < \$1code: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), message: string\$1 >\$1 (OBSOLETO)
<a name="setDisplayScale"></a>

 Deprecato dalla versione 1.3.0. Non è più necessario impostare la scala di visualizzazione. Le coordinate del mouse verranno gestite automaticamente internamente. 

 Notifica ad Amazon DCV che lo schermo è ridimensionato sul lato client. Usalo per notificare al server che deve ridimensionare gli eventi del mouse in modo che corrispondano al rapporto di visualizzazione del client. 

#### Parametri:
<a name="parameters-16"></a>


|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  scaleRatio  |  virgola mobile  |  Il rapporto di scala da utilizzare. Deve essere un numero strettamente positivo.  | 
|  displayId  |  numero  |  L'ID del display da scalare.  | 

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

 Promessa. Se rifiutata, la promessa restituisce un oggetto di errore. 

 Tipo   
 Promessa \$1 Promessa. < \$1codice: [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), messaggio: stringa\$1 > 

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

 Imposta le peculiarità della tastiera per il computer client. 

#### Parametri:
<a name="parameters-17"></a>


|  Name  |  Tipo  |  Description  | 
| --- | --- | --- | 
|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  quirks  |  Oggetto  |  La tastiera si attiva o disattiva. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/dcv/latest/websdkguide/connection-class.html)  | 
|  macOptionToAlt  |  booleano  |  Per mappare la chiave Option su Alt per macOS, specificare. true In caso contrario, specificare false.  | 
|  macCommandToControl  |  booleano  |  Per mappare il tasto Comando su Ctrl per macOS, specificare. true In caso contrario, specificare false.  | 

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

 Tipo   
 void 

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

 Imposta la risoluzione massima dello schermo da utilizzare per la connessione. 

#### Parametri:
<a name="parameters-18"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  maxWidth  |  numero  |  La larghezza massima dello schermo in pixel. Il valore minimo consentito è0.  | 
|  maxHeight  |  numero  |  L'altezza massima dello schermo in pixel. Il valore minimo consentito è0.  | 

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

 Tipo   
 void 

### setMicrophone (abilita) → \$1Promise\$1Promessa. < \$1codice: [AudioErrorCode](dcv-module.md#AudioErrorCode), messaggio: stringa\$1 >\$1
<a name="setMicrophone"></a>

 Attiva o disattiva il microfono. 

#### Parametri:
<a name="parameters-19"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Per abilitare il microfono, specificaretrue. Per disattivare il microfono, specificatefalse.  | 

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

 Promessa. Se rifiutata, la promessa restituisce un oggetto di errore. 

 Tipo   
 Promessa \$1 Promessa. < \$1codice: [AudioErrorCode](dcv-module.md#AudioErrorCode), messaggio: stringa\$1 > 

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

 Imposta la risoluzione minima dello schermo da utilizzare per la connessione. Alcune applicazioni potrebbero richiedere una risoluzione minima dello schermo. Se la risoluzione minima richiesta è maggiore della risoluzione massima supportata dal client, viene utilizzata una strategia di ridimensionamento. Utilizzate questa funzione con attenzione. La strategia di ridimensionamento potrebbe causare un sistema di input touch e mouse meno preciso. 

#### Parametri:
<a name="parameters-20"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  minWidth  |  numero  |  La larghezza minima dello schermo in pixel. Il valore minimo consentito è0.  | 
|  minHeight  |  numero  |  L'altezza minima dello schermo in pixel. Il valore minimo consentito è0.  | 

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

 Tipo   
 void 

### setUploadBandwidth(valore) → \$1numero\$1
<a name="setUploadBandwidth"></a>

 Imposta la larghezza di banda massima da utilizzare per caricare file sul server Amazon DCV. 

#### Parametri:
<a name="parameters-21"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  value  |  numero  |  Il limite massimo di larghezza di banda in kbps. L'intervallo valido è compreso tra 1024 kbps e 102400 kbps.  | 

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

 - Il limite di larghezza di banda impostato. `null`se la funzionalità di archiviazione dei file è disabilitata sul server. 

 Tipo   
 numero 

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

 Imposta il livello del volume da usare per l'audio. L'intervallo valido è compreso tra 0 e 100, dove 0 è il volume più basso e 100 è il volume più alto. 

#### Parametri:
<a name="parameters-22"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  volume  |  numero  |  Il livello di volume da utilizzare.  | 

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

 Tipo   
 void 

### setMicrophone (enable, deviceID) → \$1Promise\$1Promise. < \$1codice: [AudioErrorCode](dcv-module.md#AudioErrorCode), messaggio: stringa\$1 >\$1
<a name="setMicrophone"></a>

 [Sperimentale: potrebbe cambiare in futuro] Attiva o disattiva il microfono. 

#### Parametri:
<a name="parameters-23"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Per abilitare il microfono, specificaretrue. Per disattivare il microfono, specificatefalse.  | 
|  deviceId  |  stringa  |  L'ID del dispositivo del microfono. Se non viene fornito alcun DeviceID, viene utilizzato il default DeviceID.  | 

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

 Promessa. Se rifiutata, la promessa restituisce un oggetto di errore. 

 Tipo   
 Promessa \$1 Promessa. < \$1codice: [AudioErrorCode](dcv-module.md#AudioErrorCode), messaggio: stringa\$1 > 

### setWebcam (abilita, deviceID) → \$1Promise\$1Promessa. < \$1codice: [WebcamErrorCode](dcv-module.md#WebcamErrorCode), messaggio: stringa\$1 >\$1
<a name="setWebcam"></a>

 Attiva o disattiva la webcam. 

#### Parametri:
<a name="parameters-23"></a>


|  Name  |  Tipo  |  Descrizione  | 
| --- | --- | --- | 
|  enable  |  booleano  |  Per abilitare la webcam, specificaretrue. Per disattivare la webcam, specificarefalse.  | 
|  deviceId  |  stringa  |  L'ID del dispositivo della webcam.  | 

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

 Prometti che, in caso di successo, si risolva nel DeviceID della attached/detached webcam. Se rifiutata, la promessa restituisce un oggetto di errore. 

 Tipo   
 Promessa. <string>\$1 Promessa. < \$1codice: [WebcamErrorCode](dcv-module.md#WebcamErrorCode), messaggio: stringa\$1 > 

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

 Sincronizza gli appunti del client locale con gli appunti del server Amazon DCV remoto. La copia automatica deve essere supportata dal browser. 

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

 Se gli appunti sono stati sincronizzati, la funzione ritorna. `true` Se gli appunti non sono stati sincronizzati o se il browser non supporta la copia automatica, la funzione viene ripristinata. `false` 

 Tipo   
 booleano 