使用连接文件 - NICE DCV
创建连接文件支持的参数运行连接文件
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

使用连接文件

利用 Windows、Linux 或 macOS 本机客户端，您可以创建一个连接文件，可使用该文件立即连接到NICE DCV 会话。

创建连接文件

连接文件是文件扩展名为 .dcv 的基于文本的文件。的格式.dcv文件类似于.ini文件。文件中包含[groups]后面是参数及其值。组和参数采用以下格式：


[group_name]
parameter_name=parameter_value

例如：


[options]
fullscreen=true

对于 Windows 客户端，您可以直接从客户端为特定 NICE DCV 会话创建连接文件。或者，您也可以使用文本编辑器从头开始创建连接文件。对于 Linux 和 macOS 客户端，您只能使用文本编辑器从头开始创建连接文件。

注意

对于 Windows、Linux 和 macOS 客户端，使用文本编辑器从头开始创建连接文件的过程是相同的。

从 Windows 客户端创建连接文件

  1. 打开 Windows 客户端并连接到要从中创建文件的服务器和会话。

  2. 在右上角选择 NICE DCV 服务器的主机名，选择连接为.

  3. 在另存为窗口中，输入文件名和目标文件夹，然后选择保存。

默认情况下，当您使用 Windows 客户端创建连接文件时，该文件包括 format、host、port、user 和 proxytype 参数。在连接到从中创建文件的会话时，需要使用这些参数。可以随时通过使用文本编辑器编辑文件来手动自定义或添加参数。

使用文本编辑器从头开始创建连接文件

  1. 使用以下文件名格式创建 .dcv 文件：file_name.dcv

  2. 使用首选文本编辑器打开 .dcv 文件。

  3. 添加[version]组中)format文件顶部的参数：

    [version]
format=1.0
    重要

    如果.dcv文件不包括[version]组中)format参数，解析失败。

  4. 使用以下格式添加所需的参数组：

    [group_name]

    有关参数组的更多信息，请参阅支持的参数。

  5. 使用以下格式在组的后面添加参数和参数值：

    parameter_name=parameter_value
    注意

    • 参数名称区分大小写。

    • 不要用引号将字符串参数值括起来。

    有关参数和参数值的更多信息，请参阅支持的参数。

  6. 保存更改并关闭 .dcv 文件。

您也可以使用此过程随时向现有连接文件添加其他参数。

支持的参数

目前，.dcv文件支持三个参数组中的参数 —[version]、[connect], 和[options]. 下表列出了各个组及其可用参数。

[version] 参数

重要

这是必需的组。如果您的.dcv文件不包含此组，解析将失败。

下表列出了可在 [version] 组中指定的参数。

参数 类型 默认值 描述
format 字符串
重要

这是必需的参数。参数值必须为 1.0。

如果您的.dcvfile 不包含此参数，则解析将失败。

[connect] 参数

下表列出了可在 [connect] 组中指定的参数。

参数 类型 默认值 描述
host 字符串 托管会话的 NICE DCV 服务器的主机名。
port 整数 8443 连接到 NICE DCV 服务器时使用的端口。
weburlpath 字符串 NICE DCV 服务器上用于连接的自定义路径。例如，如果指定 customPath，则客户端将尝试连接到 host:port/customPath。
sessionid 字符串 要连接的 NICE DCV 会话的 ID。
authtoken 字符串 要用于连接的身份验证令牌。如果您指定 authtoken，则还必须指定 sessionid。在使用 authtoken 时，可以省略 user 和 password 参数。
user 字符串 连接到 NICE DCV 服务器时使用的用户名。
password 字符串 连接到 NICE DCV 服务器时使用的密码。密码未加密。
proxytype 字符串 SYSTEM 要使用的代理类型。有效值包括HTTPS、HTTP、SOCKS5|SOCKS、SYSTEM，或者NONE|DIRECT. 如果指定 SYSTEM，则使用计算机的代理设置。
proxyhost 字符串 在通过代理服务器进行连接时要使用的代理服务器的地址。
proxyport 整数 在通过代理服务器进行连接时要使用的端口。
proxyuser 字符串 要用于代理身份验证的用户名。
proxypassword 字符串 要用于代理身份验证的密码。密码未加密。
transport 字符串 websocket 用于数据传输的协议。指定websocket要使用的 WebSocket(TCP) 协议进行数据传输，或指定quic使用 QUIC (UDP) 协议进行数据传输。如果启用 QUIC，QUIC 协议将用于数据传输和 WebSocket用于身份验证流量。如果您启启用 WebSocket， WebSocket 协议用于数据传输和身份验证通信。
webport 整数 8443 要使用的端口 WebSocket (TCP) 流量。
quicport 整数 8443 用于 QUIC (UDP) 流量的端口。
证书验证策略 字符串 询问用户 用于验证不受信任证书的策略。值包括 strict、accept-untrusted 和 ask-user。

[options] 参数

下表列出了可在 [options] 组中指定的参数。

参数 类型 默认值 描述
fullscreen 布尔值 false 指示客户端是否在全屏模式下启动。
useallmonitors 布尔值 false 指示客户端是否使用所有显示器。
promptreconnect 布尔值 true 指示客户端是否在会话连接断开后提示您重新连接。如果参数设置为true，则在断开连接时将重定向到登录屏幕。如果此参数设置为 false，则在断开连接时客户端将关闭。
启用 yuv444 解码 布尔值 false 指示是否启用色彩精度高 (YUV 4:4:4)对动态视频内容进行编码时。

运行连接文件

运行.dcv连接文件，导航到该文件并双击该文件。

或者，将文件路径指定为 dcvviewer 命令的参数。

  • Windows 客户端

    C:\> dcvviewer.exe path\connection_file_name.dcv

  • Linux 和 macOS 客户端

    $ dcvviewer path/connection_file_name.dcv