本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 步驟 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. 在 **Save As (另存新檔)** 視窗中，輸入檔案名稱和目的地資料夾，然後選擇 **Save (儲存)**。

根據預設，當您建立連線檔案時，檔案會包含 `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` 檔案支援三個參數群組中的參數：`[connect]`、 `[version]`和 `[options]`。下表列出群組及其可用參數。

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

### `[version]` 參數
<a name="param-version"></a>

**重要**  
此為必要群組。如果您的`.dcv`檔案不包含此群組，剖析會失敗。

下表列出可在 `[version]` 群組中指定的參數。


| 參數 | Type | 預設值 | Description | 
| --- | --- | --- | --- | 
| 格式 | string |  |   此為必要參數。參數值必須是 `1.0`。 如果您的`.dcv`檔案不包含此參數，剖析會失敗。   | 

### `[connect]` 參數
<a name="param-connect"></a>

下表列出可在 `[connect]` 群組中指定的參數。


| 參數 | Type | 預設值 | Description | 
| --- | --- | --- | --- | 
| 託管 | String |  | 託管工作階段的 Amazon DCV 伺服器的主機名稱。 | 
| port | Integer | 8443 | 連線至 Amazon DCV 伺服器時要使用的連接埠。 | 
| weburlpath | String |  | Amazon DCV 伺服器上用於連線的自訂路徑。例如，如果您指定 customPath，用戶端會嘗試連線至 host:port/customPath。 | 
| sessionid | String |  | 要連線的 Amazon DCV 工作階段 ID。 | 
| authtoken | String |  | 用於連線的身分驗證字符。如果您指定 authtoken，則還必須指定 sessionid。使用 authtoken 時，您可以省略 user 和 password 參數。 | 
| user | String |  | 連線至 Amazon DCV 伺服器時要使用的使用者名稱。 | 
| password | String |  | 連線至 Amazon DCV 伺服器時要使用的密碼。密碼未加密。 | 
| proxytype | String | SYSTEM | 要使用的代理類型。有效值包括 HTTPS、HTTP、SYSTEM、 SOCKS5\$1SOCKS或 NONE\$1DIRECT。如果您指定 SYSTEM，則會使用電腦的代理設定。 | 
| proxyhost | String |  | 透過代理伺服器連線時使用的代理伺服器位址。 | 
| proxyport | Integer |  | 透過代理伺服器連線時使用的連接埠。 | 
| proxyuser | String |  | 用於代理身分驗證的使用者名稱。 | 
| proxypassword | String |  | 用於代理身分驗證的密碼。密碼未加密。 | 
| transport | String | auto | 用於資料傳輸的通訊協定。`auto` 用戶端會先嘗試使用 QUIC (UDP) 通訊協定進行連線。如果 QUIC 連線失敗，傳輸會自動回復為 `websocket`。 指定 `websocket` 使用 WebSocket (TCP) 通訊協定進行資料傳輸，或指定 `quic`使用 QUIC (UDP) 通訊協定進行資料傳輸。如果您啟用 QUIC，QUIC 通訊協定會用於資料傳輸，而 WebSocket 會用於身分驗證流量。如果您啟用 WebSocket，WebSocket 通訊協定會同時用於資料傳輸和身分驗證流量。  | 
| Webport | Integer | 8443 | 用於 WebSocket (TCP) 流量的連接埠。 | 
| quicport | Integer | 8443 | 用於 QUIC (UDP) 流量的連接埠。 | 
| certificatevalidationpolicy | String | ask-user | 驗證不受信任憑證的政策。值包含 strict、accept-untrusted 和 ask-user。 | 

### `[options]` 參數
<a name="param-option"></a>

下表列出可在 `[options]` 群組中指定的參數。


| 參數 | Type | 預設值 | Description | 
| --- | --- | --- | --- | 
| fullscreen | Boolean | false | 指出用戶端是否以全螢幕模式啟動。 | 
| useallmonitors | Boolean | false | 指出用戶端是否在啟動全螢幕模式時使用所有監視器。 | 
| promptreconnect | Boolean | true | 指出用戶端是否在您中斷與工作階段的連線後提示您重新連線。如果 參數設定為 true，則會在您中斷連線時重新導向至登入畫面。如果參數設定為 false，當您中斷連線時，用戶端會關閉。 | 
| enableyuv444解碼 | Boolean | false | 指出在編碼動態影片內容時是否啟用[高色彩準確度 (YUV 4：4：4)](using-high-color-accuracy.md)。 | 

### `[debug]` 參數
<a name="param-debug"></a>

下表列出可在 `[debug]` 群組中指定的參數。


| 參數 | Type | 預設值 | Description | 
| --- | --- | --- | --- | 
| loglevel | String | 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
  ```