Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

连接类

通过调用connect方法的dcv模块。有关展示如何使用它的示例，请参阅入门部分。

方法

附上显示（赢，DisplayConf）→ {承诺。 <number>| 承诺。 < {代码: MultiMonitorErrorCode，消息：字符串} >}

将特定的显示器附加到窗口。你不能连接主显示器。如果成功，该函数会返回displayId.

参数：

返回值:

承诺。如果拒绝，承诺会返回错误对象。

captureClipboardEvents（已启用、赢、DisplayId）→ {void}

开始或停止监听复制粘贴事件。对于交互式剪贴板（总是在粘贴的情况下），我们需要开始监听复制/粘贴事件。只有在需要时（例如，在显示模式时）才开始和停止监听可能会有用。

参数：

返回值:

分离显示 (DisplayID) → {void}

分离特定的显示器。无法分离主显示器。

参数：

返回值:

断开 () → {void}

断开与 NICE DCV 服务器的连接并关闭连接。

返回值:

断开协作者（ConnecconnectionId）→ {void}

请求断开与提供的连接 ID 连接的协作者的连接（自 NICE DCV Web 客户端 SDK 版本 1.1.0 起）。

参数：

返回值:

enableDisplayQuality更新（启用）→ {void}

为未接收更新的直播区域启用或禁用显示质量更新。禁用显示质量更新可减少带宽使用量，但也会降低显示质量。

参数：

返回值:

enterRelativeMouse模式 () → {void}

启用相对鼠标模式。

返回值:

getConnectedDevices() → {承诺。 < 阵列。 <MediaDevice信息 >>| 承诺。 < {message: string} >}

请求连接到客户端计算机的媒体设备的列表。

返回值:

如果成功，它将返回一个解析为数组的 PromiseMediaDevice信息对象。有关更多信息，请参阅 https://developer.mozilla.org/en-US/docs/Web/API/。MediaDevice信息。如果拒绝，承诺会返回错误对象。

getFileExplorer() → {承诺。 <文件存储>| 承诺。 < {代码: ChannelError代码，消息：字符串} >}

获取用于管理 NICE DCV 服务器的文件存储的对象。

返回值:

承诺。如果已完成，则解析文件资源管理器对象；如果拒绝，则解析错误对象。

getServerInfo() → {ServerInfo}

获取有关 NICE DCV 服务器的信息。

返回值:

有关服务器软件的信息。

getStats () → {统计数据}

获取有关 NICE DCV 服务器的统计信息。

返回值:

有关流统计数据的信息。

latchModifierKey（键、位置、iSDOWN）→ {布尔值}

发送单个键盘keydown要么keyup允许的修饰符的事件。

参数：

返回值:

如果请求的组合有效，该函数返回。true，否则它会返回false.

OpenChannel（姓名、AuthToken、回调）→ {Promise| 承诺。 < {代码: ChannelError代码，消息：字符串} >}

如果在 NICE DCV 服务器上创建了自定义数据通道，则在连接上打开该数据通道。

参数：

返回值:

承诺。如果被拒绝，我们会收到错误对象。

查询功能（功能重命名）→ {Promise。 < {启用：布尔值，远程？ : 字符串，自动复制？ ：布尔值，自动粘贴？ ：布尔值，ServiceStatus？ ：字符串，可用？ : 布尔值} >| 承诺。 < {message: string} >}

查询特定 NICE DCV 服务器功能的状态。

参数：

返回值:

承诺。如果解决，该函数会返回status始终包含enabled财产，可能还有其他财产。如果拒绝，该函数会返回error对象。

registerKeyboardShortcuts（快捷键）→ {void}

注册键盘快捷键。

参数：

返回值:

requestDisplayConfig(highColorAccuracy) → {Promise| 承诺。 < {代码: DisplayConfigErrorCode，消息：字符串} >}

从 NICE DCV 服务器请求更新的显示配置。自 NICE DCV Web 客户端 SDK 1.1.0 和 NICE DCV 服务器 2022.0 以来可用。

参数：

返回值:

承诺。如果拒绝，承诺会返回错误对象。

requestDisplayLayout（布局）→ {Promise| 承诺。 < {代码: ResolutionError代码，消息：字符串} >}

请求连接的更新显示布局。

参数：

返回值:

承诺。如果被拒绝，我们会收到错误对象。

请求解决方案 (宽度、高度) → {Promise | Promise。 < {代码: ResolutionError代码，消息：字符串} >}

从 NICE DCV 服务器请求更新的显示分辨率。

参数：

返回值:

承诺。如果拒绝，承诺会返回错误对象。

sendKeyboardEvent(事件) → {布尔值}

发送键盘快捷方式事件。有关键盘事件的更多信息，请参阅。https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent. 有效的键盘事件包括：keydown、keypress, 和keyup. 有关这些事件的更多信息，请参阅。https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent#events.

参数：

返回值:

如果事件无效，函数返回false. 如果事件有效，该函数返回。true.

sendKeyboardShortcut（快捷方式）→ {void}

发送键盘快捷键。使用此函数发送完整keydown要么keyup序列。例如，发送 Ctrl + Alt + Del 会发送keydown所有钥匙的事件，然后是keyup事件. 即使你想发送单个密钥，也可以使用此功能。

参数：

返回值:

setDisplayQuality（min，maxopt）→ {void}

设置用于连接的图像质量。有效范围为0到100，与1是最低的图像质量100是最高的图像质量。指定0保留当前值。

参数：

返回值:

setDisplayScale（缩放比率，DisplayId）→ {Promise| 承诺。 < {代码: ResolutionError代码，消息：字符串} >}

通知 NICE DCV 显示屏在客户端缩放。使用此功能可以通知服务器它需要缩放鼠标事件以匹配客户端的显示比率。

参数：

返回值:

承诺。如果拒绝，承诺会返回错误对象。

setKeyboardQuirks（怪癖）→ {void}

为客户端计算机设置键盘怪癖。

参数：

返回值:

setMaxDisplay分辨率（maxWidth，maxHigh）→ {void}

设置用于连接的最大显示分辨率。

参数：

返回值:

Set 麦克风（启用）→ {Promise| 承诺。 < {代码: AudioError代码，消息：字符串} >}

启用或禁用麦克风。

参数：

返回值:

承诺。如果拒绝，承诺会返回错误对象。

setMinDisplay分辨率（minWidth、minHeight）→ {void}

设置用于连接的最小显示分辨率。某些应用程序可能需要最低显示分辨率。如果所需的最低分辨率大于客户端支持的最大分辨率，则使用调整大小策略。小心使用此功能。调整大小策略可能会导致鼠标和触摸输入系统的精确度较低。

参数：

返回值:

setUploadBandwidth（值）→ {数字}

设置用于将文件上传到 NICE DCV 服务器的最大带宽。

参数：

返回值:

-设定的带宽限制。null是否在服务器上禁用了文件存储功能。

setVolume（卷）→ {void}

设置用于音频的音量。有效范围为 0 到 100，其中 0 是最低音量，100 是最高音量。

参数：

返回值:

setWebcam（启用，设备 ID）→ {Promise| 承诺。 < {代码: WebcamError代码，消息：字符串} >}

启用或禁用网络摄像头。

参数：

返回值:

承诺，如果成功，将解析为已连接/分离的网络摄像头设备 Id。如果拒绝，承诺会返回错误对象。

syncClipBoards () → {布尔值}

将本地客户端剪贴板与远程 NICE DCV 服务器剪贴板同步。浏览器必须支持自动复制。

返回值:

如果剪贴板已同步，则函数返回true. 如果剪贴板尚未被 sycnhronized，或者如果浏览器不支持自动复制，则该函数将返回false.