Steamworks 文獻庫
Steam 內嵌介面

英文原文已更新

本頁原文在翻譯完成後已再次更新。\r
點擊這裡檢視最新的英文版本。

總覽

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

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

需求

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

內嵌介面支援使用 DirectX 7 - 12、OpenGL,和 Vulkan 的遊戲,但目前並不支援 Metal。在軟體模擬轉譯(Software-Rasterize)的遊戲中無法使用內嵌介面。
備註:類型為「軟體」的應用程式將自動關閉內嵌介面功能。

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

Steamworks API 中有幾項可以在遊戲中直接打開內嵌介面的函式。

內嵌介面向遊戲的通訊

以下是根據使用者在內嵌介面中的動作,Steam 會傳給您的遊戲的訊號(回呼)

常見問題

備註:您也可在提供給一般顧客的客服網站中找到更多答案,請見無法開啟 Steam 社群內嵌介面一文。

問:為什麼 Steam 內嵌介面會導致我的應用程式當機?

:Steam 內嵌介面目前用於上千款遊戲之中,已測試得非常徹底,也極少是當機的主因。然而,由於它插入遊戲的方式,使用渲染 API 時經常會導致記憶體洩漏或損毀,但通常不影響遊戲的進行。

例如要以 DirectX 診斷內嵌介面的當機問題,可使用 D3D 偵錯執行階段,開啟所有溢出等級(資訊 / 警告 / 錯誤 / 注意),找出 D3D 進入損壞狀態的原因。這或許可以找出孤立的 D3D 資源。如果這樣還是無法找出問題,則可能是一般的記憶體損毀問題。如果都是在關閉時發生,則可能是關閉順序的問題,也就是關閉遊戲時沒有清理完成所造成的。

如果經過偵錯,應用程式依然會在內嵌介面中當機,請前往 Steamworks 開發者群組 通知我們。

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

:首先,請確認您是否符合上列的需求。如果已經符合,卻還是不出現,請確認您是由 Steam 用戶端開啟應用程式,無論是直接從大廳 / 快速開啟清單,或是呼叫 SteamAPI_RestartAppIfNecessary