能力整合¶

本章節為您介紹如何整合 FIRERPA 遠端桌面及其相關能力，您可以將其整合至前端頁面，用於操作、展示等功能。此處不做詳細介紹，您可以前往 APIFOX 文件查看並測試。不過，在此之前需要先向您介紹一些前置設定及其他基本資訊。

提前設定¶

為了方便您進行介面測試，請確保裝置已透過 USB 連接至當前電腦，並確保裝置未開啟登入憑證驗證（HTTPS）。完成這兩步操作後，您還需要在 APIFOX 平台完成相關設定。由於涉及 WS 介面，您需要安裝 APIFOX 電腦用戶端（非網頁版），並將相關專案匯入用戶端。安裝與匯入方法請自行探索。

即時視訊¶

即時視訊透過 WebSocket 進行傳輸，支援兩種格式：MJPEG（Motion JPEG）和 H.264 NALU。其中 MJPEG 使用方式最簡單，其實際傳輸的內容為裝置螢幕的連續截圖，傳輸速度足夠快時便形成動態的即時螢幕。您只需將 WebSocket 收到的每一幀訊息以 JPEG 格式繪製到螢幕上即可。另一種 H.264 格式則對基礎知識要求較高，因為在渲染到畫布前，您還需要進行解碼操作，可自行搜尋或整合現有的 H.264 解碼器完成解碼繪製。

H.264 與 MJPEG 相比，可減少至少一半的流量且速度較快，但並非適用於所有裝置。部分裝置自身的 H.264 編碼效能可能不高，此時應採用 MJPEG 傳輸。當然，MJPEG 也有其缺點：由於每幀都是完整影像，對頻寬要求較高。

即時觸控¶

即時觸控也透過 WebSocket 進行傳輸，並無特別之處。您只需按照特定格式傳送「按下」「移動」「抬起」三種操作即可。您可透過網頁端的 mousedown、mouseup 等事件觸發，傳輸的主體資料為事件類型及座標。這裡唯一需要注意的是，您需要透過 canvas 及實際螢幕大小進行座標轉換，計算出使用者在 canvas 上的操作座標對應的實際螢幕座標。

按鍵操作¶

按鍵操作相對簡單，您只需透過特定格式向相關介面發起 POST 請求即可。按鍵操作支援控制裝置的導航鍵以及進行普通的英文輸入。

命令終端¶

命令終端透過 WebSocket 通訊，您需要使用 xterm.js 等相關技術進行對接。只需根據 API 文件將輸入輸出格式化為特定格式並傳送，或請求 xterm 輸出即可。

即時指令¶

即時指令介面用於向裝置傳送自動化或控制類指令，具體請求格式與 WebSocket/HTTP 路徑請參閱 APIFOX 專案文件。整合時建議與「即時視訊」「即時觸控」配合使用，以保證畫面與操作的時序一致。