Skip to main content

XGameStreamingGetTouchBundleVersion

取得指定裝置目前所使用之觸控調整套件組合的版本。

語法

參數

client   _In_
類型:XGameStreamingClientId
要查詢的串流用戶端。 version   _Out_opt_
類型:XVersion*
指定用戶端目前所使用之套件組合的版本號碼。如果套件組合中未指定版本號碼,將傳回 0.0.0.0。 versionNameSize   _In_
類型:size_t
要傳回之 versionName 的大小上限 (以位元組為單位)。可呼叫 XGameStreamingGetTouchBundleVersionNameSize 來取得要指定的大小。 versionName   _Out_writes_opt_z_
類型:char*
指定用戶端目前所使用之套件組合的版本名稱。如果套件組合中未指定版本名稱,將傳回 null。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。

可能的錯誤

如需錯誤碼清單,請參閱錯誤碼。

備註

遊戲串流期間呈現給玩家的觸控配置,使用的是預先定義的配置,這些配置會作為觸控調整套件組合的一部分上傳至 Microsoft。XGameStreamingGetTouchBundleVersion 可讓遊戲根據特定用戶端上所使用的觸控控制項集合,在執行階段做出決策。以下是可能使用此功能的一些範例:
  • 如果玩家正在使用觸控,且某個元素可透過觸控覆疊控制項取得,則從 HUD 中移除該元素。
  • 根據將顯示的觸控配置,決定要在遊戲中顯示哪些圖形提示。
version 對於上傳至服務的每個版本都是唯一的。每次更新都需要新的版本號碼。 versionName 可用來提供語意版本 (例如,這是一組支援 DLC2 的配置),而不是鎖定特定的版本號碼。例如,如果版本號碼是由您的建置系統自動指派,遊戲程式碼可能很難知道執行階段會出現之觸控調整套件組合的確切版本號碼。為了讓程式碼能夠偵測套件組合是否存在,而不需要知道其確切版本,可以選擇使用版本名稱,而不是根據版本號碼進行比較。

範例

需求

標頭: XGameStreaming.h 程式庫: xgameruntime.lib 支援的平台:Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

XGameStreaming
XGameStreamingGetTouchBundleVersionNameSize
Last modified on October 6, 2026