Skip to content

README.zh-TW.md

Latest commit

 

History

History
201 lines (143 loc) · 11.1 KB

README.zh-TW.md

File metadata and controls

201 lines (143 loc) · 11.1 KB

Xbox 全螢幕體驗工具

🌐 English | 繁體中文

Xbox 全螢幕體驗工具圖示

Xbox 全螢幕體驗工具展示

最新版本 總下載量 技術 授權條款

一款簡單、安全的一鍵式工具，專為啟用 Windows 11 中隱藏的 Xbox 全螢幕遊戲體驗而生。本工具將繁複的底層設定全部自動化，讓您輕鬆享受專為遊戲手把最佳化的類主機介面。

⚠️ 重大警告：請在繼續前閱讀

使用本工具代表您已閱讀、理解並同意以下所有條款：

  • 高風險操作：本工具會對您的 Windows 系統進行深層修改。此類操作具有固有風險，可能導致系統崩潰、應用程式衝突、資料遺失或需要重灌作業系統。
  • 後果自負：您同意完全自行承擔所有可能發生的正面或負面後果。開發者不對任何形式的損壞提供支援或承擔責任。
  • 無任何保證：本工具不提供任何穩定性或功能性的保證。它可能在您的特定硬體或軟體配置上無法正常運作。
  • 備份是您的責任：在執行本工具前，您有責任備份所有重要資料並建立系統還原點。
  • 非官方工具：本專案與 Microsoft 或 Xbox 官方無關。

💡 為桌機與筆電覆寫螢幕尺寸

Xbox 全螢幕體驗專為掌機尺寸的螢幕設計。若您的裝置不是掌機，就需要覆寫螢幕尺寸。本工具提供了兩種模式，並會根據您的裝置類型，自動引導您至最適當的選項。

工作排程模式: PhysPanelCS (建議)

此為預設且建議的選項。它簡單易用且無須額外的手動設定。自 v0.0.11 版起，此方法已獲增強，大幅提升了啟動時的穩定性，使其對於包含桌機與筆電在內的所有裝置都非常可靠。

驅動程式模式: PhysPanelDrv (替代方案)

這是一個替代用的進階模式，它使用一個自訂核心驅動程式，在系統開機的最早階段就套用螢幕尺寸覆寫。此方法適用於使用預設 PhysPanelCS 模式仍可能遇到問題的使用者，但它 要求您停用「安全啟動」 並 啟用「測試簽章」 (請參閱下述前置作業)。

如何選擇適合您的模式？

  • 所有使用者 (桌機 & 筆電)：請優先使用 PhysPanelCS。這是對大多數使用者而言最建議、最安全且最可靠的方法。
  • 桌機與筆電 (替代方案)：如果您在使用預設模式時遇到任何問題，PhysPanelDrv 可作為備用選項。它需要完成下列的前置作業。
  • 掌上型裝置：您的裝置不需要覆寫！模式選擇介面將會完全停用。

PhysPanelDrv 模式的前置作業 (替代方案)

⚠️ 重要提示： 這些步驟僅適用於需要使用替代方案 PhysPanelDrv 模式的 桌上型電腦與筆記型電腦使用者。

安裝此使用測試簽章的驅動程式需要您手動停用「安全啟動」並啟用 Windows 的「測試簽章模式」。

步驟一：進入 BIOS 設定

  1. 重新啟動電腦，在開機時按下指定按鍵 (通常是 Del, F2, F10, 或 Esc) 進入 BIOS/UEFI 設定。
  2. 找到並關閉 Secure Boot (安全啟動) 選項。
  3. 儲存設定並離開。

步驟二：啟用測試簽章

  1. 電腦重啟進入 Windows 後，使用系統管理員權限打開終端機 (PowerShell 或 CMD)。
  2. 輸入以下指令，然後按下 Enter： 
    bcdedit /set testsigning on
  3. 完成後，再次重新開機。

完成以上步驟後，您就可以在工具中選取 PhysPanelDrv。

⚙️ 系統版本要求

本工具適用於 Windows 11 24H2 組建版本 26100.7019 或更新版本。在不符要求的系統上，工具將提示錯誤並無法執行。

如何判讀版本號 (非常重要！)

當檢查版本時，請務必查看小數點前的「主要版本號」。小數點後的數字僅代表次要更新。

  • 相容: 26100.7019 或更新版本 (Release Build 24H2)
  • 相容: 26200.7019 或更新版本 (Release Build 25H2)
  • 相容: 26200.7015 或更新版本 (Release Preview Build 25H2)
  • 相容: 26220.6972 或更新版本 (Dev Build 25H2)

範例： 26100.1 這樣的版本是不相容的，因為它的次要版本號 .1 小於 (舊於) 所要求的 .7019。如果您處於 26100 / 26200 版本，請執行 Windows Update 以更新至最新狀態。

請在下載前確認您的作業系統版本。

➡️ 前往發行頁面下載最新版本

❤️ 支持這個專案 (Support This Project)

如果您覺得這個工具對您有幫助，您的支持會是我持續維護與開發更多開源專案的莫大動力！

前往 Patreon 支持我

✨ 功能特色

  • 一鍵切換：提供直觀的介面，只需點選一次即可啟用或停用 Xbox 全螢幕體驗。
  • 自動系統檢查：啟動時自動驗證您的 Windows 組建版本，確保符合執行要求。
  • 自動鍵盤修正：確保螢幕鍵盤隨時待命，讓非觸控電腦也能透過控制器無縫輸入文字。
  • 硬體類型模擬：若您使用桌上型或筆記型電腦，工具會自動將裝置類型模擬為掌機，以滿足啟用條件。
  • 自動模式選擇：自動偵測您的裝置類型（桌機、筆電、掌機），並提供最適當的螢幕尺寸覆寫選項。
  • 安全且完全可逆：所有變更都會在停用或解除安裝時被還原。工具會備份初始設定，確保您的系統能無損恢復原狀。
  • 標準化安裝：提供標準的 .msi 安裝檔，便於版本管理與乾淨解除安裝。

🚀 快速入門

本工具用於準備您的系統環境，最終的啟用步驟需要依照以下流程在 Windows 設定中完成。

1. 準備您的系統

  1. 從 發行頁面 下載最新的 .msi 安裝檔。
  2. 執行安裝程式（過程需要系統管理員權限）。
  3. 從桌面捷徑啟動工具。若使用桌機或筆電，工具將自動選取建議的 PhysPanelCS 模式。

    注意： 如果您是 桌機或筆電使用者，並希望改用替代的 PhysPanelDrv 模式，您可以手動選擇它。請務必先完成上述的前置作業。

  4. 點選 啟用 Xbox 全螢幕體驗 按鈕。
  5. 重新啟動您的電腦以套用變更。

2. 更新核心應用程式

  1. 電腦重啟後，開啟 Microsoft Store。
  2. 前往 「下載」 區 (舊版市集則為 「媒體櫃」)。
  3. 點選 「檢查更新」 來重新整理所有應用程式。請確保 Xbox 與 Xbox Game Bar 都已更新至最新版本。

    🔄 提示： 您可能需要點選「檢查更新」兩次，才能確保所有項目都安裝完整。

3. 啟用全螢幕體驗

  1. 進入 開始 → 設定 → 遊戲 → 全螢幕體驗。
  2. 在「選擇主畫面應用程式」中設定為 Xbox。
    • 若沒有出現此選項，請返回上一步驟，確保應用程式都已更新至最新。
  3. 啟用 啟動時進入全螢幕體驗。

如何還原

  1. 再次執行工具，並點選 停用並還原 按鈕。
  2. 重新啟動您的電腦即可完成還原。

💻 技術堆疊

  • 主要技術堆疊: C# & .NET 8
  • 使用者介面: Windows Forms (WinForms)
  • 輔助語言: C++, C, PowerShell
  • 元件與函式庫:
    • ViVeLib (ViVeTool): 一個用於操控 Windows 功能組態 (Feature Flags) 的原生 API 封裝函式庫。以 Git Submodule 方式整合，原始碼來自 thebookisclosed/ViVe，特此感謝。
    • PhysPanelLib: 封裝 ntdll.dll 未公開 API，用以讀寫實體顯示面板 (Physical Panel) 尺寸資訊的函式庫。為本專案自研，其概念參考自 riverar/physpanel 的 Rust 實作，特此感謝。
    • PhysPanelDrv: 一個用於進階「驅動程式模式」的輕量級核心驅動程式，能可靠地覆寫實體顯示面板尺寸。以 Git Submodule 方式整合，原始碼來自 8bit2qubit/PhysPanelDrv。
  • 安裝套件: Visual Studio Installer Projects (MSI)

🙏 致謝

這個專案的實現，歸功於以下這些出色的開源工具：

由衷感謝他們對社群的貢獻。

🛠️ 本地開發

若要在您自己的電腦上執行此專案，請遵循以下步驟。

  1. 複製儲存庫

    git clone https://github.com/8bit2qubit/XboxFullScreenExperienceTool.git
cd XboxFullScreenExperienceTool

  2. 初始化子模組 本專案使用 Git Submodules 來管理相依套件。

    git submodule update --init --recursive

  3. 在 Visual Studio 中開啟 使用 Visual Studio 開啟 XboxFullScreenExperienceTool.sln 方案檔。

  4. 執行以進行開發 在 Visual Studio 中，將組建組態設定為 Debug，然後按下 F5 來建置並執行應用程式。

  5. 建置以用於生產 當您準備好部署時，將組建組態切換至 Release 並建置方案。成品將會生成在 XboxFullScreenExperienceTool/bin/Release 資料夾下。

📄 授權條款

本專案採用 GNU General Public License v3.0 (GPL-3.0) 授權。

這意味著您可以自由地使用、修改與散佈本軟體，但任何基於此專案的衍生作品在散佈時，也必須採用相同的 GPL-3.0 授權，並提供完整的原始碼。更多詳情，請參閱 GPL-3.0 官方條款。