serve 命令用來將指定的配置提供給 CTA，以進行驗證體驗。
您可以提供已封裝的觸控調整組合 (使用 pack 命令建立)，或提供一組未封裝的配置。
下表顯示可搭配 serve 命令使用的各種選項。
安全性考量
serve 命令適用於本機開發。它會從開發電腦暫時裝載觸控調整組合，讓串流用戶端可在反覆開發期間載入這些組合。不應將其公開至公用網際網路。
請使用最符合您案例的最窄主機繫結：
- 只有本機電腦需要連線時，請使用
--host localhost。 - 串流用戶端需要透過一個已知的本機網路介面連線時，請使用
--host <specific IP address>。 - 只有在您打算接聽開發電腦上的每個網路介面時，才使用
--host 0.0.0.0。如果防火牆和網路規則允許，同一網路上的其他裝置可能可以連線到側載伺服器。
localhost 以外的位址、使用共用或不受信任的網路，或需要讓伺服器保持可連線的時間超過目前的測試階段時，請強化設定。在這些情況下，建議依照憑證產生指示中所述，使用 --certificate-file 搭配 --certificate-password 來採用 HTTPS。如果您想要限制用戶端存取所提供的組合，請加入 --password。--password 時，請在本機為側載工作階段選擇或產生該值，並在用戶端的開發人員設定中輸入相同的值。此密碼會保護對該本機 HTTPS 側載工作階段的存取；Microsoft 不會替您管理或輪替它。若要輪替密碼，請使用新密碼重新啟動 tak serve，並更新用戶端設定。
範例
使用下列程式碼範例，在主機上提供觸控調整組合。在預設連接埠和主機上提供 layout-path 中的所有配置，並宣告特定的版本/版本名稱
僅透過 localhost 提供指定的觸控調整組合
憑證產生指示
若要裝載經過驗證的安全伺服器來側載觸控組合，需要憑證。您可以使用任何適當的 SSL 憑證，但下列指示也會建立憑證- 從 XBOX Game Streaming Tools GitHub 取得用於產生自我簽署憑證的指令碼 a. 瀏覽至上述連結，選取 ‘raw’，然後將指令碼內容複製並貼到本機電腦上的文件中 b. 或者，在 Powershell 中執行下列命令來下載指令碼
Create-SelfSignedCertificate.ps1 指令碼僅適用於 Windows。其他作業系統上可能有可產生有效自我簽署憑證的工具
- 在 Powershell 中執行下載的指令碼。
- 指令碼會提示您輸入用來保護憑證的密碼。在此輸入密碼以進行設定。此密碼將用作 serve 命令之 -certificate-password 旗標的輸入。
這會產生兩個檔案：
sideload.pfx和sideload.cer。sideload.pfx憑證檔案的路徑要做為 serve 命令之 -certificate-file 旗標的輸入。
在不同的用戶端上信任憑證
將 .cer 檔案載入您的裝置。您可以透過電子郵件、OneDrive、USB、ADB、AirDrop 等方式完成此操作。依照適用於該裝置的一般方式信任憑證。Windows
- 按兩下
sideload.cer檔案 - 選取 [安裝憑證]。這會開啟憑證匯入精靈。
- 選取 [目前使用者] 做為存放位置。
- 在下一個視窗中，選取 [將所有憑證放入以下的存放區]，然後選取 [瀏覽受信任的根憑證授權單位]。
Android
- 在您的 Android 裝置上，瀏覽至 [設定] > [安全性] > [進階] > [加密與憑證] > [從儲存空間安裝]。
-
選取 CA 憑證，然後瀏覽至上一節中下載的
sideload.cer檔案以安裝憑證 安裝後，即可在 [信任的憑證] > [使用者] 下檢視此憑證
iOS
- 瀏覽至 iOS 裝置上的「檔案」應用程式，將 .cer 檔案安裝至您的裝置描述檔
- 系統應會根據 .cer 檔案描述檔名稱產生新的描述檔。這可以在 [設定] > [一般] > [描述檔與裝置管理] 下找到。
- 安裝憑證。憑證簽章應顯示為已驗證。
- 若要測試已安裝的憑證，請瀏覽至 [設定] > [一般] > [關於本機] > [憑證信任設定]。為剛安裝的根憑證啟用完全信任。
範例
使用下列程式碼範例，在主機上安全地提供觸控調整組合。透過 https 在預設主機和連接埠上提供配置路徑中的所有配置
在驗證用戶端後，於預設主機和連接埠上安全地提供配置路徑中的所有配置。