概覽

Steam 內嵌介面是 Steam 使用者介面的一部分，使用時可覆蓋於幾乎任何 Steam 遊戲之上。 使用者可通過介面開啟好友名單、網頁瀏覽器、聊天，和遊戲內 DLC 購買。

在遊戲中開啟內嵌介面的預設鍵是 SHIFT + TAB，但可在 Steam 設定中變更。

需求

您的遊戲不須任何特別的設置即可使用內嵌介面，它會自動掛勾任何從 Steam 開啟的遊戲！ 開發期間，於偵錯工具執行遊戲時，呼叫 SteamAPI_Init 即會載入內嵌介面。 所以必須在初始化 OpenGL/D3D 裝置前先呼叫 SteamAPI_Init，不然便無法與裝置掛鉤。

內嵌介面支援使用 DirectX 7 - 12、OpenGL、Metal，和 Vulkan 的應用程式。 在軟體模擬轉譯（Software-Rasterize）的遊戲中無法使用內嵌介面。

macOS：要在 10.15（Catalina）中支援內嵌介面需要您在組建配置中加入授權。 詳情請見平台頁面。

在應用程式中開啟內嵌介面

Steamworks API 中有一整組的功能，能讓您直接存取以開啟遊戲內嵌介面。

• ISteamFriends::ActivateGameOverlay
  此函式可開啟指定對話視窗的遊戲內嵌介面。
  
• ISteamFriends::ActivateGameOverlayToUser
  此函式可傳入使用者做為資料，並開啟指定對話視窗的遊戲內嵌介面。
  
• ISteamFriends::ActivateGameOverlayToWebPage
  此函式可開啟遊戲內嵌介面的網頁瀏覽器並載入指定網址。 當中的 URL 必須是完整的 URL，例如 http://www.steamgames.com/。
  
• ISteamFriends::ActivateGameOverlayToStore
  此函式可開啟購買目前遊戲 DLC 的內嵌介面（更多資訊請見可下載內容（DLC）一文）。
  
• ISteamUtils::SetOverlayNotificationPosition
  設定通知會出現在螢幕的哪一個角落。 預設是螢幕的右下方。
  
• ISteamUtils::IsOverlayEnabled
  傳回內嵌介面是否正在運作，和使用者是否可以使用。 內嵌介面可能需要幾秒鐘的時間才能與遊戲掛鉤，所以當內嵌介面在載入時，函式將傳回 False。

內嵌介面向遊戲的通訊

以下訊號（回呼）是根據內嵌介面中的使用者行動，從 Steam 傳送至您的遊戲：

• GameOverlayActivated_t
  當遊戲內嵌介面開啟或關閉時發送， 可用來當作暫停或繼續單人遊戲的訊號。
  
• GameServerChangeRequested_t
  當使用者選擇加入好友遊戲時發送，內含遊戲伺服器的詳細資訊。
  
• GameLobbyJoinRequested_t
  使用者選擇加入好友遊戲時發送，內含大廳的詳細資訊。

常見問答

備註： 您可以在給顧客參考的客服網站獲得關於此主題的其它解答：Steam 社群內嵌介面打不開。

問： 為什麼 Steam 內嵌介面會使得我的應用程式當機？

答： Steam 內嵌介面用於數千款遊戲中，經過非常徹底的測試，很少是導致當機的原因。 然而，由於其植入遊戲的方式，它常常會在使用您的彩現 API 時暴露出記憶體漏失或記憶體損壞的問題，而這不一定會影響遊戲的進行。

舉例來說，要診斷與 DirectX 有關的內嵌介面當機問題，可以使用 D3D 偵錯執行階段，開啟所有等級的釋出提示（資訊 / 警告 / 錯誤 / 通知），來嘗試釐清 D3D 進入錯誤狀態的原因。 這麼做可能會提示出孤立的 D3D 資源。 如果用此方法仍無法找出問題，則可能是更為一般的記憶體毀損問題。 如果問題總是在關機時發生，則可能是遊戲在關閉時，因為沒有進行清理而導致的關閉順序問題。

如果偵錯後應用程式仍有在內嵌介面中當機的問題，請至 Steamworks 開發群組通知我們。

問： 為什麼 Steam 內嵌介面沒有出現在我的應用程式中？

答： 首先，您必須滿足上述的需求。 如果您已滿足需求但依然沒有顯示，請確定您是透過 Steam 用戶端啟動應用程式，無論是直接使用從大廳 / 快速啟動列表，或是呼叫 SteamAPI_RestartAppIfNecessary 皆可。

問： 我的遊戲在 Windows 7 上使用 D3D12，而 Steam 內嵌介面無法運作。 怎麼會這樣？

答： 請參考 Microsoft 的這篇文獻，進一步了解如何支援 Steam 內嵌介面。