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

# 步骤 4：创建连接文件（可选）
<a name="using-connection-file"></a>

通过使用 Windows、Linux 或 macOS 本机客户端，您可以创建可用于立即连接到 Amazon DCV 会话的连接文件。

**Topics**
+ [创建连接文件](#connection-file-create)
+ [支持的参数](#connection-file-params)
+ [运行连接文件](#connection-file-execute)

## 创建连接文件
<a name="connection-file-create"></a>

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

```
[group_name]
parameter_name=parameter_value
```

例如：

```
[options]
fullscreen=true
```

您可以直接从客户端中为特定 Amazon DCV 会话创建连接文件。或者，您也可以使用文本编辑器从头开始创建连接文件。

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

**从客户端中创建连接文件**

1. 打开 客户端。

1. 连接到要在其中创建文件的服务器和会话。

1. 在右上角选择 Amazon DCV 服务器的主机名，然后选择**将连接另存为**。

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

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

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

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

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

1. 按以下格式将 `[version]` 组和 `format` 参数添加到文件顶部：

   ```
   [version]
   format=1.0
   ```
**重要**  
如果 `.dcv` 文件不包含 `[version]` 组和 `format` 参数，解析将失败。

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

   ```
   [group_name]
   ```

   有关参数组的更多信息，请参阅[支持的参数](#connection-file-params)。

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

   ```
   parameter_name=parameter_value
   ```
**注意**  
参数名称区分大小写。
不要用引号将字符串参数值引起来。

   有关参数和参数值的更多信息，请参阅[支持的参数](#connection-file-params)。

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

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

## 支持的参数
<a name="connection-file-params"></a>

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

**Topics**
+ [`[version]` 参数](#param-version)
+ [`[connect]` 参数](#param-connect)
+ [`[options]` 参数](#param-option)
+ [`[debug]` 参数](#param-debug)

### `[version]` 参数
<a name="param-version"></a>

**重要**  
这是必需的组。如果 `.dcv` 文件不包含该组，解析将失败。

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


| 参数 | Type | 默认 值 | 说明 | 
| --- | --- | --- | --- | 
| format | 字符串 |  |   这是必需的参数。参数值必须为 `1.0`。 如果 `.dcv` 文件不包含该参数，解析将失败。   | 

### `[connect]` 参数
<a name="param-connect"></a>

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


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

### `[options]` 参数
<a name="param-option"></a>

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


| 参数 | Type | 默认 值 | 说明 | 
| --- | --- | --- | --- | 
| fullscreen | 布尔值 | false | 指示客户端是否以全屏模式启动。 | 
| useallmonitors | 布尔值 | false | 指示客户端在启动全屏模式时是否使用所有显示器。 | 
| promptreconnect | 布尔值 | true | 指示您从会话断开连接后客户端是否提示您重新连接。如果该参数设置为 true，您在断开连接时将重定向到登录屏幕。如果此参数设置为 false，则在断开连接时客户端将关闭。 | 
| enableyuv444decoding | 布尔值 | false | 指示在对动态视频内容进行编码时是否启用[高色彩精度（YUV 4:4:4）](using-high-color-accuracy.md)。 | 

### `[debug]` 参数
<a name="param-debug"></a>

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


| 参数 | Type | 默认 值 | 说明 | 
| --- | --- | --- | --- | 
| loglevel | 字符串 | INFO | 可将值设置为 Debug。 | 

## 运行连接文件
<a name="connection-file-execute"></a>

要运行 `.dcv` 连接文件，请导航到该文件，然后双击该文件。

或者，将文件路径指定为 `dcvviewer` 命令的参数。
+ Windows 客户端

  ```
  C:\> dcvviewer.exe path\connection_file_name.dcv
  ```
+ Linux 和 macOS 客户端

  ```
  $ dcvviewer path/connection_file_name.dcv
  ```