Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Classe de connexion
<a name="connection-class"></a>

Classe de connexion obtenue en appelant la [`connect`méthode](dcv-module.md#connect) du `dcv` module. Pour un exemple montrant comment l'utiliser, consultez la section [Mise en route](establish-connection.md#auth-conn).

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

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

**Topics**
+ [AttachDisplay (win, DisplayConf) → {Promesse. <number>\|Promesse. < {code : [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), message : chaîne} >}](#attachDisplay)
+ [captureClipboardEvents(activé, win, DisplayID) → {void}](#captureClipboardEvents)
+ [DetachDisplay (DisplayId) → {void}](#detachDisplay)
+ [déconnecter () → {void}](#disconnect)
+ [DisconnectCollaborator (ConnectionId) → {void}](#disconnectCollaborator)
+ [enableDisplayQualityMises à jour (activer) → {void}](#enableDisplayQualityUpdates)
+ [enableHighPixelDensité (activer) → {void}](#enableHighPixelDensity)
+ [enableTimezoneRedirection(activer) → {Promise\|Promesse. < {code : [TimezoneRedirectionErrorCode](dcv-module.md#TimezoneRedirectionErrorCode), message : chaîne} >}](#enableTimezoneRedirection)
+ [enterRelativeMouseMode () → {void}](#enterRelativeMouseMode)
+ [getConnectedDevices() → {Promesse. <Tableau. < MediaDeviceInfo >>\|Promesse. < {message : string} >}](#getConnectedDevices)
+ [getFileExplorer() → {Promesse. < [stockage de fichiers >> Promise](dcv-module.md#filestorage). < {code : [ChannelErrorCode](dcv-module.md#ChannelErrorCode), message : chaîne} >}](#getFileExplorer)
+ [getMaxAllowedMonitorDimensions() {[MaxDimensionLimits](dcv-module.md#MaxDimensionLimits)}](#getMaxAllowedMonitorDimensions)
+ [getServerInfo() → {[Informations sur le serveur](dcv-module.md#serverInfo)}](#getServerInfo)
+ [getScreenshot () → {Promise\|Promesse. < {code : [ScreenshotErrorCode](dcv-module.md#ScreenshotErrorCode), message : chaîne} >}](#getScreenshot)
+ [getStats () → {[statistiques](dcv-module.md#stats)}](#getStats)
+ [latchModifierKey(clé, emplacement, IsDown) → {boolean}](#latchModifierKey)
+ [OpenChannel (nom, AuthToken, rappels, espace de noms) → {Promise\|Promise. < {code : [ChannelErrorCode](dcv-module.md#ChannelErrorCode), message : chaîne} >}](#openChannel)
+ [QueryFeature (FeatureName) → {Promesse. < {activé : booléen, distant ? : chaîne, AutoCopy ? : booléen, AutoPaste ? : booléen, serviceStatus ? : chaîne, disponible ? : boolean} >\|Promesse. < {message : string} >}](#queryFeature)
+ [registerKeyboardShortcuts(raccourcis) → {void}](#registerKeyboardShortcuts)
+ [requestDisplayConfig(highColorAccuracy) → {Promise\|Promesse. < {code : [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), message : chaîne} >}](#requestDisplayConfig)
+ [requestDisplayLayout(mise en page) → {Promise\|Promesse. < {code : [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), message : chaîne} >}](#requestDisplayLayout)
+ [RequestResolution (largeur, hauteur) → {Promise\|Promise. < {code : [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), message : chaîne} >}](#requestResolution)
+ [sendKeyboardEvent(événement) → {boolean}](#sendKeyboardEvent)
+ [sendKeyboardShortcut(raccourci) → {void}](#sendKeyboardShortcut)
+ [setDisplayQuality(min, maxopt) → {void}](#setDisplayQuality)
+ [setDisplayScale(ScaleRatio, DisplayID) → {Promise\|Promesse. < {code : [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), message : string} >} (OBSOLÈTE)](#setDisplayScale)
+ [setKeyboardQuirks(bizarreries) → {void}](#setKeyboardQuirks)
+ [setMaxDisplayRésolution (maxWidth, maxHeight) → {void}](#setMaxDisplayResolution)
+ [Régler le microphone (activer) → {Promise\|Promise. < {code : [AudioErrorCode](dcv-module.md#AudioErrorCode), message : chaîne} >}](#setMicrophone)
+ [setMinDisplayRésolution (minWidth, minHeight) → {void}](#setMinDisplayResolution)
+ [setUploadBandwidth(valeur) → {nombre}](#setUploadBandwidth)
+ [SetVolume (volume) → {void}](#setVolume)
+ [Régler le microphone (activer, DeviceID) → {Promise\|Promise. < {code : [AudioErrorCode](dcv-module.md#AudioErrorCode), message : chaîne} >}](#setMicrophone)
+ [SetWebcam (activer, DeviceId) → {Promise\|Promise. < {code : [WebcamErrorCode](dcv-module.md#WebcamErrorCode), message : chaîne} >}](#setWebcam)
+ [SyncClipboards () → {boolean}](#syncClipboards)

### AttachDisplay (win, DisplayConf) → {Promesse. <number>\|Promesse. < {code : [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), message : chaîne} >}
<a name="attachDisplay"></a>

 Attache un écran spécifique à une fenêtre. Vous ne pouvez pas connecter l'écran principal. En cas de succès, la fonction renvoie le`displayId`. 

#### Paramètres :
<a name="parameters-1"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  Nom  |  Type  |  Attributes  |  Description  | 
| --- | --- | --- | --- | 
|  win  |  Objet  |  Fenêtre à laquelle l'écran doit être attaché.  | 
|  displayConf  |  Objet  |  Configuration de l'écran. [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/dcv/latest/websdkguide/connection-class.html)  | 
|  displayId  |  nombre  |  <optional>  |  ID de l'écran.  | 
|  displayDivName  |   |   |  Le nom de la division d'affichage.  | 

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

 Promesse. En cas de rejet, la promesse renvoie un objet d'erreur. 

 Type   
 Promesse. <number>\| Promesse. < {code : [MultiMonitorErrorCode](dcv-module.md#MultiMonitorErrorCode), message : chaîne} > 

### captureClipboardEvents(activé, win, DisplayID) → {void}
<a name="captureClipboardEvents"></a>

 Démarre ou arrête l'écoute des événements copier-coller. Dans le cas des blocs-notes interactifs (toujours dans le cas du collage), nous devons commencer à écouter les copy/paste événements. Il peut être utile de démarrer et d'arrêter l'écoute uniquement lorsque cela est nécessaire, par exemple lorsqu'un modal est affiché. 

#### Paramètres :
<a name="parameters-2"></a>


|  Nom  |  Type  |  Attributes  |  Description  | 
| --- | --- | --- | --- | 
|  enabled  |  booléen  |   |  Pour commencer à écouter les événements, spécifieztrue. Pour arrêter d'écouter les événements, spécifiezfalse.  | 
|  win  |  Objet  |  <optional>  |  La fenêtre dans laquelle vous pouvez écouter les événements. En cas d'omission, la fenêtre par défaut est utilisée.  | 
|  displayId  |  number  |  <optional>  |  ID de l'écran qui doit écouter les événements. En cas d'omission, l'affichage par défaut de la fenêtre est utilisé.  | 

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

 Type   
 void 

### DetachDisplay (DisplayId) → {void}
<a name="detachDisplay"></a>

 Permet de détacher un écran spécifique. L'écran principal ne peut pas être détaché. 

#### Paramètres :
<a name="parameters-3"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  displayId  |  nombre  |  ID de l'écran à détacher.  | 

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

 Type   
 void 

### déconnecter () → {void}
<a name="disconnect"></a>

 Se déconnecte du serveur Amazon DCV et ferme la connexion. 

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

 Type   
 void 

### DisconnectCollaborator (ConnectionId) → {void}
<a name="disconnectCollaborator"></a>

 Demande la déconnexion du collaborateur connecté avec l'identifiant de connexion fourni (depuis la version 1.1.0 du SDK Amazon DCV Web Client). 

#### Paramètres :
<a name="parameters-4"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  connectionId  |  booléen  |  L'identifiant de la connexion qui sera déconnectée.  | 

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

 Type   
 void 

### enableDisplayQualityMises à jour (activer) → {void}
<a name="enableDisplayQualityUpdates"></a>

 Active ou désactive les mises à jour de qualité d'affichage pour les zones de diffusion qui ne reçoivent pas de mises à jour. La désactivation des mises à jour de la qualité d'affichage réduit l'utilisation de la bande passante, mais elle diminue également la qualité d'affichage. 

#### Paramètres :
<a name="parameters-5"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  enable  |  booléen  |  Pour activer les mises à jour de la qualité d'affichage, spécifieztrue. Pour désactiver les mises à jour de la qualité d'affichage, spécifiezfalse.  | 

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

 Type   
 void 

### enableHighPixelDensité (activer) → {void}
<a name="enableHighPixelDensity"></a>

 Active ou désactive la haute densité de pixels sur le client. 

#### Paramètres :
<a name="parameters-5"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  enable  |  booléen  |  Indique si la haute densité de pixels doit être activée ou non.  | 

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

 Type   
 void 

### enableTimezoneRedirection(activer) → {Promise\|Promesse. < {code : [TimezoneRedirectionErrorCode](dcv-module.md#TimezoneRedirectionErrorCode), message : chaîne} >}
<a name="enableTimezoneRedirection"></a>

 Active ou désactive la redirection du fuseau horaire. Une fois activé, le client demande au serveur de faire en sorte que le fuseau horaire du bureau du serveur corresponde au fuseau horaire du client. 

#### Paramètres :
<a name="parameters-5"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  enable  |  booléen  |  Pour activer la redirection du fuseau horaire, spécifieztrue. Pour désactiver la redirection du fuseau horaire, spécifiezfalse.  | 

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

 Promesse. En cas de rejet, la promesse renvoie un objet d'erreur. 

 Type   
 Promesse. <number>\| Promesse. < {code : [TimezoneRedirectionErrorCode](dcv-module.md#TimezoneRedirectionErrorCode), message : chaîne} > 

### enterRelativeMouseMode () → {void}
<a name="enterRelativeMouseMode"></a>

 Active le mode souris relatif. 

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

 Type   
 void 

### getConnectedDevices() → {Promesse. <Tableau. < MediaDeviceInfo >>\|Promesse. < {message : string} >}
<a name="getConnectedDevices"></a>

 Demande une liste des périphériques multimédia connectés à l'ordinateur client. 

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

 En cas de succès, il renvoie une promesse qui se résout en un tableau d' MediaDeviceInfo objets. Pour plus d'informations, consultez https://developer.mozilla. org/en-US/docs/Web/API/MediaDeviceInfo. En cas de rejet, la promesse renvoie un objet d'erreur. 

 Type   
 Promesse. <Tableau. < MediaDeviceInfo >> \| Promesse. < {message : string} > 

### getFileExplorer() → {Promesse. < [stockage de fichiers >> Promise](dcv-module.md#filestorage). < {code : [ChannelErrorCode](dcv-module.md#ChannelErrorCode), message : chaîne} >}
<a name="getFileExplorer"></a>

 Obtient un objet pour gérer le stockage de fichiers du serveur Amazon DCV. 

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

 Promesse. Résout à l'objet explorateur de fichiers s'il est rempli, ou à un objet d'erreur s'il est rejeté. 

 Type   
 Promesse. < [stockage de fichiers](dcv-module.md#filestorage) > \| Promis. < {code : [ChannelErrorCode](dcv-module.md#ChannelErrorCode), message : chaîne} > 

### getMaxAllowedMonitorDimensions() {[MaxDimensionLimits](dcv-module.md#MaxDimensionLimits)}
<a name="getMaxAllowedMonitorDimensions"></a>

 Demande les limites de dimension d'affichage prises en charge par le serveur Amazon DCV. 

#### Renvoie:
<a name="returns-35"></a>

 L'objet contenant maxLargestDimension et maxSmallestDimension pris en charge sur le client Web par le serveur. 

 Type   
 [MaxDimensionLimits](dcv-module.md#MaxDimensionLimits) 

### getServerInfo() → {[Informations sur le serveur](dcv-module.md#serverInfo)}
<a name="getServerInfo"></a>

 Permet d'obtenir des informations sur le serveur Amazon DCV. 

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

 Informations sur le logiciel du serveur. 

 Type   
 [Informations sur le serveur](dcv-module.md#serverInfo) 

### getScreenshot () → {Promise\|Promesse. < {code : [ScreenshotErrorCode](dcv-module.md#ScreenshotErrorCode), message : chaîne} >}
<a name="getScreenshot"></a>

 Récupère la capture d'écran du poste de travail distant au format PNG. La capture d'écran sera renvoyée dans l'observateur [ScreenshotCallback](dcv-module.md#screenshotCallback). `null`sera retourné à la place en cas de panne. 

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

 Promesse résolue si la demande est traitée. En cas de rejet, nous recevons un objet d'erreur. 

 Type   
 Promesse \| Promesse. < {code : [ScreenshotErrorCode](dcv-module.md#ScreenshotErrorCode), message : chaîne} > 

### getStats () → {[statistiques](dcv-module.md#stats)}
<a name="getStats"></a>

 Permet d'obtenir des statistiques sur le serveur Amazon DCV. 

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

 Informations sur les statistiques de streaming. 

 Type   
 [statistiques](dcv-module.md#stats) 

### latchModifierKey(clé, emplacement, IsDown) → {boolean}
<a name="latchModifierKey"></a>

 Envoie un clavier `keydown` ou un `keyup` événement unique pour un modificateur autorisé. 

#### Paramètres :
<a name="parameters-6"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  key  |  Contrôle \| Alt \| AltGraph \| Méta \| Système d'exploitation \| Shift  |  La clé à envoyer.  | 
|  location  |  KeyboardEvent.localisation  |  L'emplacement de la clé. Pour plus d'informations, consultez https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 
|  isDown  |  boolean  |  Si l'événement clé à injecter est un keydown (true) ou un keyup (false).  | 

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

 Si la combinaison demandée est valide, la fonction revient`true`, sinon elle le fait`false`. 

 Type   
 boolean 

### OpenChannel (nom, AuthToken, rappels, espace de noms) → {Promise\|Promise. < {code : [ChannelErrorCode](dcv-module.md#ChannelErrorCode), message : chaîne} >}
<a name="openChannel"></a>

 Ouvre un canal de données personnalisé sur la connexion s'il a été créé sur le serveur Amazon DCV. 

#### Paramètres :
<a name="parameters-7"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  name  |  chaîne  |  Nom du canal.  | 
|  authToken  |  chaîne  |  Le jeton d'authentification à utiliser pour se connecter au canal.  | 
|  callbacks  |  Objet  |  Les fonctions de rappel OnMessage et OnClose à appeler.  | 
|  namespace  |  chaîne  |  L'espace de noms du canal. Disponible depuis Amazon DCV Web Client SDK 1.2.0 et Amazon DCV Server 2022.1.  | 

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

 Promesse. En cas de rejet, nous recevons un objet d'erreur. 

 Type   
 Promesse \| Promesse. < {code : [ChannelErrorCode](dcv-module.md#ChannelErrorCode), message : chaîne} > 

### QueryFeature (FeatureName) → {Promesse. < {activé : booléen, distant ? : chaîne, AutoCopy ? : booléen, AutoPaste ? : booléen, serviceStatus ? : chaîne, disponible ? : boolean} >\|Promesse. < {message : string} >}
<a name="queryFeature"></a>

 Demande l'état d'une fonctionnalité spécifique du serveur Amazon DCV. 

#### Paramètres :
<a name="parameters-8"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  featureName  |  [fonctionnalité](dcv-module.md#feature)  |  Nom de la fonctionnalité à interroger.  | 

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

 Promesse. Si elle est résolue, la fonction renvoie un `status` objet qui contient toujours une `enabled` propriété, et éventuellement d'autres propriétés. En cas de rejet, la fonction renvoie un `error` objet. 

 Type   
 {Promesse. < {activé : booléen, distant ? : chaîne, AutoCopy ? : booléen, AutoPaste ? : booléen, serviceStatus ? : chaîne, disponible ? : boolean} > \| Promesse. < {message : string} > 

### registerKeyboardShortcuts(raccourcis) → {void}
<a name="registerKeyboardShortcuts"></a>

 Enregistre les raccourcis clavier. 

#### Paramètres :
<a name="parameters-9"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  shortcuts  |  Matrice. <Object>  |  Le tableau de clés et de mappages à enregistrer. [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/dcv/latest/websdkguide/connection-class.html)  | 
|  sequence  |  Matrice. <Object>  |  Raccourci clavier pour s'enregistrer. [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/dcv/latest/websdkguide/connection-class.html)  | 
|  output  |  Matrice. <Object>  |  Action prévue à exécuter par le raccourci. [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/dcv/latest/websdkguide/connection-class.html)  | 
|  key  |  KeyboardEvent.clé  |  La valeur de la touche pressée par l'utilisateur. Pour plus d'informations, consultez https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.localisation  |  Le tableau de clés à envoyer. Emplacement de la touche sur le clavier. Pour plus d'informations, consultez https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 
|  key  |  KeyboardEvent.clé  |  La valeur de la touche pressée par l'utilisateur. Pour plus d'informations, consultez https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.localisation  |  Le tableau de clés à envoyer. Emplacement de la touche sur le clavier. Pour plus d'informations, consultez https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 

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

 Type   
 void 

### requestDisplayConfig(highColorAccuracy) → {Promise\|Promesse. < {code : [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), message : chaîne} >}
<a name="requestDisplayConfig"></a>

 Demande une configuration d'affichage mise à jour au serveur Amazon DCV. Disponible depuis Amazon DCV Web Client SDK 1.1.0 et Amazon DCV Server 2022.0. 

#### Paramètres :
<a name="parameters-10"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  highColorAccuracy  |  booléen  |  Si une haute précision des couleurs doit être demandée ou non.  | 

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

 Promesse. En cas de rejet, la promesse renvoie un objet d'erreur. 

 Type   
 Promesse \| Promesse. < {code : [DisplayConfigErrorCode](dcv-module.md#DisplayConfigErrorCode), message : chaîne} > 

### requestDisplayLayout(mise en page) → {Promise\|Promesse. < {code : [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), message : chaîne} >}
<a name="requestDisplayLayout"></a>

 Demande une mise à jour de la mise en page de la connexion. 

#### Paramètres :
<a name="parameters-11"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  layout  |  Matrice. < [Moniteur](dcv-module.md#Monitor) >  |  La demande s'affiche dans la mise en page.  | 

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

 Promesse. En cas de rejet, nous recevons un objet d'erreur. 

 Type   
 Promesse \| Promesse. < {code : [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), message : chaîne} > 

### RequestResolution (largeur, hauteur) → {Promise\|Promise. < {code : [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), message : chaîne} >}
<a name="requestResolution"></a>

 Demande une résolution d'affichage mise à jour au serveur Amazon DCV. 

#### Paramètres :
<a name="parameters-12"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  width  |  nombre  |  Largeur à demander en pixels. La valeur minimale autorisée est de0.  | 
|  height  |  number  |  Hauteur à demander en pixels. La valeur minimale autorisée est de0.  | 

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

 Promesse. En cas de rejet, la promesse renvoie un objet d'erreur. 

 Type   
 Promesse \| Promesse. < {code : [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), message : chaîne} > 

### sendKeyboardEvent(événement) → {boolean}
<a name="sendKeyboardEvent"></a>

 Envoie un événement de raccourci clavier. Pour plus d'informations sur les événements liés au clavier, consultez [https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent). Les événements de clavier valides incluent : `keydown``keypress`, et`keyup`. Pour plus d'informations sur ces événements, consultez [https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent#events)\#events. 

#### Paramètres :
<a name="parameters-13"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  event  |  KeyboardEvent  |  L'événement clavier à envoyer.  | 

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

 Si l'événement n'est pas valide, la fonction revient`false`. Si l'événement est valide, la fonction revient`true`. 

 Type   
 boolean 

### sendKeyboardShortcut(raccourci) → {void}
<a name="sendKeyboardShortcut"></a>

 Envoie un raccourci clavier. Utilisez cette fonction pour envoyer un fichier complet `keydown` ou une `keyup` séquence. Par exemple, l'envoi de Ctrl \+ Alt \+ Del envoie les `keydown` événements pour toutes les touches, suivis des `keyup` événements. Utilisez cette fonction même si vous souhaitez envoyer une seule clé. 

#### Paramètres :
<a name="parameters-14"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  shortcut  |  Matrice. <Object>  |  Le tableau de clés à envoyer. [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/dcv/latest/websdkguide/connection-class.html)  | 
|  key  |  KeyboardEvent.clé  |  La valeur de la touche pressée par l'utilisateur. Pour plus d'informations, consultez https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/key.  | 
|  location  |  KeyboardEvent.localisation  |  Le tableau de clés à envoyer. Emplacement de la touche sur le clavier. Pour plus d'informations, consultez https://developer.mozilla. org/en-US/docs/Web/API/KeyboardEvent/location.  | 

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

 Type   
 void 

### setDisplayQuality(min, maxopt) → {void}
<a name="setDisplayQuality"></a>

 Définit la qualité d'image à utiliser pour la connexion. La plage valide est `0` de`100`, avec la qualité `1` d'image la plus faible et `100` la meilleure qualité d'image. Spécifiez `0` pour conserver la valeur actuelle. 

#### Paramètres :
<a name="parameters-15"></a>


|  Nom  |  Type  |  Attributes  |  Description  | 
| --- | --- | --- | --- | 
|  min  |  nombre  |   |  La qualité d'image minimale.  | 
|  max  |  number  |  <optional>  |  La qualité d'image maximale.  | 

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

 Type   
 void 

### setDisplayScale(ScaleRatio, DisplayID) → {Promise\|Promesse. < {code : [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), message : string} >} (OBSOLÈTE)
<a name="setDisplayScale"></a>

 Obsolète depuis la version 1.3.0. Il n'est plus nécessaire de régler l'échelle d'affichage. Les coordonnées de la souris seront gérées automatiquement en interne. 

 Indique à l'Amazon DCV que l'affichage est redimensionné côté client. Utilisez-le pour indiquer au serveur qu'il doit adapter les événements de la souris au ratio d'affichage du client. 

#### Paramètres :
<a name="parameters-16"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  scaleRatio  |  float  |  Le ratio de mise à l'échelle à utiliser. Il doit s'agir d'un nombre strictement positif.  | 
|  displayId  |  number  |  ID de l'écran à redimensionner.  | 

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

 Promesse. En cas de rejet, la promesse renvoie un objet d'erreur. 

 Type   
 Promesse \| Promesse. < {code : [ResolutionErrorCode](dcv-module.md#ResolutionErrorCode), message : chaîne} > 

### setKeyboardQuirks(bizarreries) → {void}
<a name="setKeyboardQuirks"></a>

 Définit les anomalies du clavier de l'ordinateur client. 

#### Paramètres :
<a name="parameters-17"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  quirks  |  Objet  |  Le clavier vacille pour activer ou désactiver. [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/dcv/latest/websdkguide/connection-class.html)  | 
|  macOptionToAlt  |  booléen  |  Pour associer la touche Option à Alt pour macOS, spécifieztrue. Sinon, spécifiez false.  | 
|  macCommandToControl  |  boolean  |  Pour associer la touche Commande à la touche Ctrl pour macOS, spécifiez. true Sinon, spécifiez false.  | 

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

 Type   
 void 

### setMaxDisplayRésolution (maxWidth, maxHeight) → {void}
<a name="setMaxDisplayResolution"></a>

 Définit la résolution d'affichage maximale à utiliser pour la connexion. 

#### Paramètres :
<a name="parameters-18"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  maxWidth  |  nombre  |  Largeur d'affichage maximale en pixels. La valeur minimale autorisée est de0.  | 
|  maxHeight  |  number  |  Hauteur d'affichage maximale en pixels. La valeur minimale autorisée est de0.  | 

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

 Type   
 void 

### Régler le microphone (activer) → {Promise\|Promise. < {code : [AudioErrorCode](dcv-module.md#AudioErrorCode), message : chaîne} >}
<a name="setMicrophone"></a>

 Active ou désactive le microphone. 

#### Paramètres :
<a name="parameters-19"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  enable  |  booléen  |  Pour activer le microphone, spécifieztrue. Pour désactiver le microphone, spécifiezfalse.  | 

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

 Promesse. En cas de rejet, la promesse renvoie un objet d'erreur. 

 Type   
 Promesse \| Promesse. < {code : [AudioErrorCode](dcv-module.md#AudioErrorCode), message : chaîne} > 

### setMinDisplayRésolution (minWidth, minHeight) → {void}
<a name="setMinDisplayResolution"></a>

 Définit la résolution d'affichage minimale à utiliser pour la connexion. Certaines applications peuvent nécessiter une résolution d'affichage minimale. Si la résolution minimale requise est supérieure à la résolution maximale prise en charge par le client, une stratégie de redimensionnement est utilisée. Utilisez cette fonction avec précaution. La stratégie de redimensionnement peut entraîner une diminution de la précision de la souris et du système de saisie tactile. 

#### Paramètres :
<a name="parameters-20"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  minWidth  |  nombre  |  Largeur d'affichage minimale en pixels. La valeur minimale autorisée est de0.  | 
|  minHeight  |  number  |  Hauteur d'affichage minimale en pixels. La valeur minimale autorisée est de0.  | 

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

 Type   
 void 

### setUploadBandwidth(valeur) → {nombre}
<a name="setUploadBandwidth"></a>

 Définit la bande passante maximale à utiliser pour le téléchargement de fichiers vers le serveur Amazon DCV. 

#### Paramètres :
<a name="parameters-21"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  value  |  nombre  |  Limite de bande passante maximale en Kbits/s. La plage valide est comprise entre 1024 kbits/s et 1024 kbit/s.  | 

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

 - La limite de bande passante définie. `null`si la fonctionnalité de stockage de fichiers est désactivée sur le serveur. 

 Type   
 number 

### SetVolume (volume) → {void}
<a name="setVolume"></a>

 Définit le niveau de volume à utiliser pour le son. La plage valide est comprise entre 0 et 100, 0 étant le volume le plus faible et 100 le volume le plus élevé. 

#### Paramètres :
<a name="parameters-22"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  volume  |  nombre  |  Le niveau de volume à utiliser.  | 

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

 Type   
 void 

### Régler le microphone (activer, DeviceID) → {Promise\|Promise. < {code : [AudioErrorCode](dcv-module.md#AudioErrorCode), message : chaîne} >}
<a name="setMicrophone"></a>

 [Expérimental - pourrait changer dans le futur] Active ou désactive le microphone. 

#### Paramètres :
<a name="parameters-23"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  enable  |  booléen  |  Pour activer le microphone, spécifieztrue. Pour désactiver le microphone, spécifiezfalse.  | 
|  deviceId  |  chaîne  |  L'identifiant de l'appareil du microphone. Si aucun DeviceID n'est fourni, le default DeviceID est utilisé.  | 

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

 Promesse. En cas de rejet, la promesse renvoie un objet d'erreur. 

 Type   
 Promesse \| Promesse. < {code : [AudioErrorCode](dcv-module.md#AudioErrorCode), message : chaîne} > 

### SetWebcam (activer, DeviceId) → {Promise\|Promise. < {code : [WebcamErrorCode](dcv-module.md#WebcamErrorCode), message : chaîne} >}
<a name="setWebcam"></a>

 Active ou désactive la webcam. 

#### Paramètres :
<a name="parameters-23"></a>


|  Nom  |  Type  |  Description  | 
| --- | --- | --- | 
|  enable  |  booléen  |  Pour activer la webcam, spécifieztrue. Pour désactiver la webcam, spécifiezfalse.  | 
|  deviceId  |  chaîne  |  L'identifiant de l'appareil de la webcam.  | 

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

 Promettez que, en cas de succès, il sera résolu par le DeviceID de la attached/detached webcam. En cas de rejet, la promesse renvoie un objet d'erreur. 

 Type   
 Promesse. <string>\| Promesse. < {code : [WebcamErrorCode](dcv-module.md#WebcamErrorCode), message : chaîne} > 

### SyncClipboards () → {boolean}
<a name="syncClipboards"></a>

 Synchronise le presse-papiers du client local avec le presse-papiers du serveur Amazon DCV distant. La copie automatique doit être prise en charge par le navigateur. 

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

 Si les presse-papiers ont été synchronisés, la fonction revient. `true` Si les presse-papiers n'ont pas été synchronisés ou si le navigateur ne prend pas en charge la copie automatique, la fonction revient. `false` 

 Type   
 boolean