JoyPro2 Discord GitHub
GUI 頁面

HUD

顯示:

HUD 會在您玩遊戲時把您的裝置顯示在螢幕上,就像直播主的控制器覆蓋層:搖桿圖片會跟著您的搖桿傾斜,推桿和軸會以長條移動,按住的按鈕會亮起並顯示名稱,還有一行文字說明按下的按鈕在執行中的遊戲裡做什麼(「Gear Toggle」)。它可以顯示在遊戲上方、OBS 中,或兩者都顯示,各自有自己的小工具。這個頁面就是它的設計工具。

HUD 設計工具和即時預覽HUD 設計工具和即時預覽
HUD 設計工具和即時預覽 (圖片顯示的是英文版應用程式。)
flowchart LR
  D["您的裝置"] --> P["HUD"]
  O["您在遊戲裡<br/>的綁定"] --> P
  P --> S["在我的螢幕上"]
  P --> B["OBS 頁面"]
  P --> W["直播視窗"]
HUD 會讀取您在執行中遊戲裡的裝置和綁定,並同時在最多三個地方顯示它們:在遊戲上方的您的螢幕上、在 OBS 頁面上,以及在直播視窗中。
給新手

#點三下啟動 HUD

  1. 在底部列中開啟 HUD。移動搖桿時,預覽就已經會跟著動了。
  2. 保持勾選 在我的螢幕上(覆蓋在遊戲上方)。
  3. 按 啟動 HUD(在 開始 頁面上也有)。啟動您的遊戲:HUD 會顯示在遊戲上方,而且絕不會搶走遊戲的滑鼠或鍵盤。

停止 HUD(同一個按鈕)會關閉它。您在這裡設定的一切都會保留,重新啟動後也還在。

#螢幕上有什麼

  • 每個裝置一個 小工具:一開始會顯示搖桿、油門和腳舵,面板和鍵盤則是隱藏的(在 小工具 清單中勾選它們)。每個小工具可以顯示裝置的照片、搖桿位置、以長條顯示的軸、按鈕和帽子開關。
  • 飛機小工具:您正在飛的飛機的搖桿和油門,以遊戲畫出的樣子顯示,跟著您的搖桿和油門移動。
  • 遊戲標題:遊戲或 DCS 飛機和它的圖片。
  • 按鈕的功能:最後按下的幾個按鈕,以及它們在執行中遊戲裡的動作。

在預覽中拖曳小工具即可移動它;點一下就能在右側變更它。自動排列 會把它們沿著底部排列:油門和左手裝置在左邊,腳舵在中間,右手搖桿在右邊。

飛機小工具:飛機自己的搖桿和油門飛機小工具:飛機自己的搖桿和油門
飛機小工具:飛機自己的搖桿和油門
在遊戲中: 您在遊戲中看到的內容

HUD 視窗是透明的,會保持在視窗模式和無邊框遊戲的上方。點擊會穿透它傳到遊戲。它不會出現在工作列或 Alt+Tab 中。獨佔全螢幕會把它遮住(這是 Windows 的限制):請把遊戲切換成無邊框模式。按下按鈕的那一行會寫出該遊戲和飛機的動作名稱,例如 F-16C 中的「Weapon Release」和 IL-2 中的「Fire guns」。

進階

#HUD 顯示位置

這三種輸出彼此獨立:

輸出 給誰 方式
在我的螢幕上(覆蓋在遊戲上方) 您 遊戲上方的透明視窗
OBS 頁面(瀏覽器來源,透明) 您的直播(建議) JoyPro 只在這台電腦上提供一個頁面;複製 會把它的網址放到剪貼簿
直播視窗(視窗擷取) 使用視窗擷取直播 一般視窗(可以放在遊戲後面),背景為透明或色鍵

取消勾選 在我的螢幕上,就能在乾淨的畫面上遊玩,而直播仍會顯示 HUD;或是在兩者上顯示不同的小工具:每個小工具都有兩個勾選方塊,一個是螢幕(您的螢幕),一個是 OBS(直播)。預覽:我的螢幕 / 直播 會切換設計工具顯示的內容。每秒最多更新次數(15、30 或 60;30 既流暢又輕量)。

#設定 OBS(瀏覽器來源)

  1. 勾選 OBS 頁面(瀏覽器來源,透明),然後按 啟動 HUD。
  2. 按網址(http://127.0.0.1:8765/hud)旁邊的 複製。
  3. 在 OBS 中:Sources > + > Browser。把網址貼到 URL,Width 設為 1920,Height 設為 1080。其他都不需要:背景是透明的,也不需要自訂 CSS。
  4. 選擇性:勾選 Shutdown source when not visible,讓 OBS 在沒有使用它的場景中停止該頁面。

頁面會在一個縮放到來源大小的 1920 x 1080 畫面上,以和應用程式相同的位置和樣式,畫出勾選給直播的小工具。連接埠被其他程式佔用了?請在 連接埠 下選擇另一個,然後重新複製網址。

OBS 中顯示的直播頁面OBS 中顯示的直播頁面
OBS 中顯示的直播頁面

改用視窗擷取:勾選 直播視窗,選擇背景(透明、綠色、洋紅色、藍色或您的顏色)。在 OBS 中新增 Window Capture,並設定 Capture Method: Windows 10 (1903 and up);如果使用顏色背景,請加上該顏色的 Chroma Key 濾鏡。如果透明背景在您的 OBS 中顯示為黑色,請改用瀏覽器來源或顏色背景。

OBS 瀏覽器來源如何取得 HUD:先傳送一個頁面,之後只傳送變更。

# 誰 會發生什麼
1 OBS 瀏覽器來源開啟 http://127.0.0.1:8765/hud。
2 JoyPro 傳送頁面:版面配置、樣式和圖片。
3 OBS 開啟 /hud/events。它會保持開啟。
4 JoyPro 傳送狀態(軸、按鈕、按鈕的功能),每秒最多 30 次,而且只在有變化時傳送。
5 JoyPro 當小工具、位置或樣式改變時,再次傳送版面配置。

#小工具

小工具 會列出每個裝置,以及標題、綁定跑馬燈和飛機小工具。重新載入裝置 會重新讀取已連接的裝置;顯示全部 會為您的螢幕勾選每個小工具;自動排列 和 重設位置 會把它們擺好位置。

每個小工具(在預覽或清單中點選它):

  • 在我的螢幕上顯示、在直播中顯示、大小、此小工具的樣式(HUD 的樣式或任何其他樣式)。
  • 顯示:名稱、類型(搖桿、油門)、圖片、圖片隨搖桿傾斜、按鈕亮起、以名稱顯示按住的按鈕、軸和操縱桿、軸名稱、軸數值、搖桿位置(萬向架)、帽子開關。標題小工具:它的圖片。
  • 圖片:照片(製造商的圖片,已去背)、配置(您在 配置 頁面上的 JoyPro 配置圖片,按下的按鈕會在所在位置亮起)、自動(有照片時使用照片)。
  • 此底座上的握把:適用於可裝多種握把的底座(VPforce Rhino、Virpil WarBRD);握把決定圖片和按鈕名稱。
  • 搖桿軸:搖桿元素的 X、Y 和扭轉軸從哪裡來。自動 使用裝置自己的軸;如果握把本身是一個沒有軸的獨立裝置,就從它所在的底座取得軸。
選取一個裝置小工具:它顯示的內容、圖片和搖桿軸選取一個裝置小工具:它顯示的內容、圖片和搖桿軸
選取一個裝置小工具:它顯示的內容、圖片和搖桿軸

飛機小工具:搖桿、油門、油門行程條、搖桿位置、控制項亮起、以名稱顯示按住的控制項;飛機(自動:您正在飛的飛機,或這台電腦上設定的任何圖片)和 跟隨(帶動它的搖桿和油門)。它的圖片來自遊戲自己的座艙圖片(座艙 > 根據我的遊戲產生圖片,或圖片包),否則使用 JoyPro 的真實握把線稿。

#40 種樣式

樣式 有 40 種預設:玻璃、霓虹、極簡,簡潔類(霧面淺色、實況主簡潔、實況主醒目、緊湊、大字、粉彩、僅輪廓),座艙顯示器類(軍用綠色 HUD、琥珀色 MFD、客機 PFD、玻璃座艙、夜視、紅色座艙照明、向量線框、復古終端機、復古戰機、全像),遊戲與類型(太空模擬橘、全像青、賽博龐克、合成波、霓虹粉、賽車、戰術沙色、海軍藍與金、匿蹤、幽靈),色彩主題(極地、沙漠、海洋、日落、皇家、碳纖維)以及易讀性(高對比、高對比淺色、單色、單色淺色)。› 會切換到下一種。

40 種樣式中的幾種40 種樣式中的幾種
40 種樣式中的幾種

下方:一鍵套用強調色、強調色、按下 和 不透明度,接著是各元素的設計選項:卡片(背景、邊框、圓角、陰影)、文字(字型、大小、字距、顏色、名稱粗體)、搖桿元素(圓環、方形、十字準線、雷達、圓點;大小、光暈)、橫條和拉桿(形狀、高度、空白部分)以及 按鈕和標籤(形狀)。變更任何選項後,樣式會變成「自訂設計(已變更)」:儲存樣式 會以您取的名稱保存它,復原變更 會回到預設樣式,匯出樣式... / 匯入樣式... 可以用檔案分享它,刪除 會移除您自己的樣式。

#按鈕的功能與 DCS 飛機

按鈕的功能:顯示幾行、停留多久(秒)、字型大小、顯示裝置與按鈕 和 僅在遊戲執行時。點擊穿透 讓滑鼠點擊穿過 HUD 視窗(在 HUD 啟動時套用)。

JoyPro 會依處理程序找出正在執行的遊戲(DCS、IL-2、Star Citizen 以及它支援的所有其他遊戲),並只顯示該遊戲的綁定。DCS 還需要知道飛機:請在 DCS 飛機 下選擇,或按 安裝 DCS 掛鉤,讓 DCS 在每次任務開始時告訴 JoyPro 是哪架飛機(一個小型 Lua 檔案,加上 Export.lua 中一行有防護的程式碼,會先備份;移除 會逐位元組把檔案還原;請先關閉 DCS)。檢查 會告訴您掛鉤是否已安裝。

遊戲上方的 HUD遊戲上方的 HUD
遊戲上方的 HUD
技術細節

#頁面的背後

檢視模型:MainWindowViewModel.Hud.cs(裝置、小工具、版面)、MainWindowViewModel.HudStyles.cs(預設樣式、自訂樣式、匯入/匯出)、MainWindowViewModel.HudStream.cs(輸出、直播頁面、飛機小工具)、MainWindowViewModel.HudAxes.cs(搖桿軸)、MainWindowViewModel.Overlay.cs(啟動/停止、執行中的遊戲、按鈕文字行、DCS 掛鉤)。檢視:Views/HudWindow.axaml、Views/Controls/HudSurface.axaml、HudElements.cs、HudPanel.cs。預設樣式:Models/HudStylePresets.cs。

  • 裝置:engine hud devices 會提供每個已連接裝置的型號、類型、使用的手、產品圖片、軸及其角色、按鈕及其名稱和控制項 ID(Controls,供飛機小工具使用),以及標有按鈕位置的配置圖片。
  • 執行中遊戲的綁定:engine overlay map(--game、--plane、--unit):已綁定的按鈕及其修飾鍵和標題。帶有修飾鍵的綁定會在按住其修飾鍵時顯示;符合的修飾鍵最多的綁定優先。
  • DCS 掛鉤:engine overlay dcs-hook status / install / remove(--path、--dry-run):Scripts\JoyProOverlay.lua,加上 Export.lua 中一行以 pcall 包住的程式碼;DCS 會把單位類型傳送到 127.0.0.1:1992(UDP)。掛鉤會呼叫它所取代的其他指令碼(SRS、Tacview)的匯出函式。
  • 直播伺服器:Services/HudStreamServer.cs、HudStreamHub.cs、Resources/hud-stream.html;只繫結到 127.0.0.1,使用其他主機名稱的要求會被拒絕。GET /hud(頁面)、/hud/events(Server-Sent Events:layout、state)、/hud/img/<id>(PNG 圖片)、/hud/state(JSON)。沒有頁面連線時,它只會監聽。
  • 遊玩時的負擔:Services/HudInputPump.cs 只保留每個裝置最新的報告,並以選定的頻率套用;元素只在變更時重新繪製;每份報告都不會配置記憶體;圖片只裁切一次(飛機握把高 480 px)。由 HUD 長時間穩定性測試依 CPU、配置和記憶體預算進行測量。
  • 設定:%APPDATA%\JoyPro2\hud.json(位置、大小、每個小工具在螢幕和直播的勾選、含所有選項的樣式、自訂樣式、輸出、連接埠、背景、更新頻率)。樣式檔案:*.joypro-hudstyle.json("format": "joypro-hud-style")。

參考:hud。

#參考資料

本頁背後的功能文件,從儲存庫產生:

#本頁上的每個控制項

42 個控制項,從程式的原始碼讀取:42 個已撰寫,0 個附有來自原始碼的資訊(工具提示、程式碼註解、引擎呼叫),0 個尚待補充。

#切換覆蓋層

按鈕已撰寫

「啟動 HUD」/「停止 HUD」:用上方勾選的輸出啟動 HUD:必要時讀取裝置,找到正在執行的遊戲並載入它的綁定。

再按一次會關閉所有輸出。

更多詳情(英文)

#在我的螢幕上(覆蓋在遊戲上方)

核取方塊已撰寫

工具提示 顯示在遊戲上方的透明 HUD。取消勾選可讓您自己的螢幕保持乾淨,而直播中仍會顯示 HUD。

把 HUD 顯示為遊戲上方的透明視窗。

取消勾選,可以讓您自己的螢幕保持乾淨,而直播仍會顯示 HUD。

更多詳情(英文)

#OBS 頁面(瀏覽器來源,透明)

核取方塊已撰寫

工具提示 JoyPro 將 HUD 以網頁提供,僅限此電腦存取。在 OBS 中以此網址新增瀏覽器來源:背景是透明的,不需要自訂 CSS。

HUD 執行期間,JoyPro 會把它當作網頁提供,只限這台電腦上的 OBS 瀏覽器來源使用:透明背景,不需要自訂 CSS。

勾選後,下方會顯示位址、「複製」和「連接埠」。

更多詳情(英文)

#複製

按鈕已撰寫

把 OBS 頁面的位址複製到剪貼簿。

在 OBS 中:「來源 > + > 瀏覽器」,把它貼上作為 URL,寬度 1920,高度 1080。

更多詳情(英文)

#直播視窗(視窗擷取)

核取方塊已撰寫

工具提示 一個獨立視窗,不置頂:它可以位於遊戲後方。在 OBS 中:使用「視窗擷取」,擷取方式選擇 Windows 10(1903 及更新版本);如使用色度鍵顏色,請新增「色度鍵」濾鏡。

HUD 執行期間,為 OBS 的視窗擷取開啟一個獨立的視窗,背景是透明的,或是下方選的色度鍵顏色。

在 OBS 中:擷取方式選 Windows 10,並為顏色加入「色度鍵」濾鏡。

更多詳情(英文)

#在您的螢幕上顯示

核取方塊已撰寫

清單中小工具的螢幕勾選框:在您的螢幕上顯示它。

更多詳情(英文)

#在直播中顯示

核取方塊已撰寫

清單中小工具的 OBS 勾選框:在直播中顯示它。

更多詳情(英文)

#重新載入裝置

按鈕已撰寫

重新讀取已連接的裝置:新裝置會得到一個小工具,圖片和按鈕名稱也會重新整理。

在插上裝置後使用。

更多詳情(英文)

#顯示全部

按鈕已撰寫

勾選您螢幕上的每個小工具。在清單中取消勾選您不要的小工具。

更多詳情(英文)

#自動排列

按鈕已撰寫

工具提示 油門與左手裝置在左,腳舵在中間,右手搖桿在右,沿螢幕底部排列

把螢幕上顯示的裝置小工具沿著底部排列:油門和左手裝置在左邊,腳舵在中間,右手搖桿在右邊;放不下的會往上移一列。

新的位置會被保留。

更多詳情(英文)

#重設位置

按鈕已撰寫

把每個小工具放回它的預設位置和大小;每個小工具顯示的內容不變。

更多詳情(英文)

#›

按鈕已撰寫

工具提示 下一個樣式

把 HUD 切換到「樣式」清單中的下一個項目。

更多詳情(英文)

#強調色

按鈕已撰寫

給樣式這個強調色。HUD 會立刻採用;在您儲存之前,樣式會顯示為「自訂設計」。

更多詳情(英文)

#名稱粗體

核取方塊已撰寫

以粗體顯示小工具的名稱。這是樣式的一部分:在儲存之前會讓樣式變成「自訂設計」。

更多詳情(英文)

#儲存樣式

按鈕已撰寫

用旁邊輸入的名稱,把目前的設計保留為您自己的樣式,並讓它成為 HUD 的樣式。

預設樣式的名稱會被拒絕;您同名的樣式會被取代。

更多詳情(英文)

#匯入樣式...

按鈕已撰寫

讀取樣式檔案,讓它成為您的樣式之一,並成為 HUD 的樣式。

您已經使用過的名稱會加上一個數字。

更多詳情(英文)

#匯出樣式...

按鈕已撰寫

把目前的設計儲存為樣式檔案,可以分享或保留;HUD 不會改變。

更多詳情(英文)

#復原變更

按鈕已撰寫

工具提示 回到上方選擇的樣式

把設計恢復成手動變更之前的樣式:也就是最後選取、儲存或匯入的樣式。

更多詳情(英文)

#刪除

按鈕已撰寫

刪除您選取的自訂樣式。使用它的小工具會回到 HUD 的樣式;HUD 會保持目前的外觀。

更多詳情(英文)

#顯示裝置與按鈕

核取方塊已撰寫

在「按鈕的功能」的每一行下方加上裝置和按鈕。

更多詳情(英文)

#僅在遊戲執行時

核取方塊已撰寫

只在支援的遊戲執行時顯示「按鈕的功能」各行;關閉時,它們也會顯示在桌面上。

更多詳情(英文)

#點擊穿透(啟動時套用)

核取方塊已撰寫

滑鼠點選會穿過 HUD 視窗傳到遊戲。

在 HUD 啟動時套用:變更這項設定後,請停止再啟動它。

更多詳情(英文)

#安裝 DCS 掛鉤

按鈕已撰寫

安裝 DCS 掛鉤:Scripts\JoyProOverlay.lua,以及 Export.lua 中一行受保護的程式碼。

請先關閉 DCS。

更多詳情(英文)

#移除

按鈕已撰寫

再次移除 DCS 掛鉤:Export.lua 會逐位元組恢復成原來的樣子。

請先關閉 DCS。

更多詳情(英文)

#檢查

按鈕已撰寫

檢查 DCS 掛鉤是否已安裝在「設定」中的 DCS 資料夾裡。

不會變更任何東西。

更多詳情(英文)

#我的螢幕

選項已撰寫2 ×

「我的螢幕」/「直播」:設計工具的預覽要顯示什麼,是為您的螢幕勾選的小工具,還是為直播勾選的小工具。

只有預覽會改變;這個選擇會保留到下次啟動。

更多詳情(英文)

#在直播中顯示

核取方塊已撰寫

在直播中顯示選取的小工具:OBS 頁面和直播視窗。

更多詳情(英文)

#名稱

核取方塊已撰寫

在裝置的小工具上顯示裝置的名稱。

#圖片

核取方塊已撰寫

遊戲標題小工具:在遊戲或 DCS 飛機的名稱旁顯示它的圖片。

#圖片隨搖桿傾斜

核取方塊已撰寫

讓裝置圖片跟著搖桿傾斜和扭轉,就像真的搖桿在動一樣。

#按鈕亮起

核取方塊已撰寫2 ×

裝置小工具:按住的按鈕會亮起。飛機小工具:您按下的按鈕所代表的飛機控制項,會在它的搖桿或油門上亮起。

更多詳情(英文)

#按住的按鈕顯示名稱

核取方塊已撰寫2 ×

裝置小工具:按住的按鈕會以標籤顯示,附上來自裝置目錄的名稱。

飛機小工具:在握把下方依名稱顯示飛機被按住的控制項。

更多詳情(英文)

#軸與拉桿

核取方塊已撰寫2 ×

裝置小工具:每個軸和推桿都會以長條移動。

飛機小工具:油門旁的一個長條,顯示您推桿的位置。

更多詳情(英文)

#軸數值

核取方塊已撰寫

在每個軸的長條旁寫上它的數值。

#搖桿位置(萬向)

核取方塊已撰寫2 ×

顯示搖桿元素:一個圓環中的點表示搖桿的位置,並有一個刻度表示扭轉。

更多詳情(英文)

#帽子開關

核取方塊已撰寫

顯示帽子開關;按下的方向會亮起。

#搖桿

核取方塊已撰寫

飛機小工具:顯示飛機自己的搖桿圖片,跟著您的搖桿傾斜。

#油門

核取方塊已撰寫

飛機小工具:顯示飛機自己的油門圖片,跟著您油門的第一根推桿滑動。