> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameStreaming (API 內容)

> XGameStreaming

# XGameStreaming

## 初始化

初始化遊戲串流功能所需的 API。

| 函式 | 描述 |
| :- | :- |
| [XGameStreamingInitialize](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminginitialize.md) | 初始化遊戲串流 API。 |
| [XGameStreamingUninitialize](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminguninitialize.md) | 取消初始化遊戲串流 API。 |

## 用戶端屬性

用於取得串流裝置或其遊戲串流屬性的 API

### 函式

| 函式 | 描述 |
| :- | :- |
| [XGameStreamingClientPropertiesChangedCallback](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingclientpropertieschangedcallback.md) | 串流裝置的屬性變更時的通知。 |
| [XGameStreamingGetClientIPAddress](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetclientipaddress.md) | **已淘汰。** 取得串流用戶端的 IP 位址。請改用 XSTS 權杖宣告。 |
| [XGameStreamingGetDisplayDetails](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md) | 取得串流用戶端的顯示器詳細資料。 |
| [XGameStreamingGetSessionId](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetsessionid.md) | 取得串流用戶端的工作階段識別碼。 |
| [XGameStreamingGetStreamPhysicalDimensions](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetstreamphysicaldimensions.md) | 取得目前在串流用戶端上呈現之視訊串流的實體大小。 |
| [XGameStreamingGetTouchBundleVersion](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggettouchbundleversion.md) | 取得指定裝置上目前使用之觸控調整套件組合的版本。 |
| [XGameStreamingGetTouchBundleVersionNameSize](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggettouchbundleversionnamesize.md) | 取得指定裝置上觸控調整套件組合中所指定版本名稱的大小。 |
| [XGameStreamingIsTouchInputEnabled](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingistouchinputenabled.md) | 檢查用戶端是否會將觸控輸入傳送至遊戲。 |
| [XGameStreamingRegisterClientPropertiesChanged](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingregisterclientpropertieschanged.md) | 註冊在串流用戶端裝置的任何屬性變更時要叫用的回呼。 |
| [XGameStreamingUnregisterClientPropertiesChanged](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingunregisterclientpropertieschanged.md) | 取消註冊先前註冊的 XGameStreamingClientPropertiesChangedCallback。 |

### 列舉

| 列舉 | 描述 |
| :- | :- |
| [XGameStreamingClientProperty](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingclientproperty.md) | 可查詢之用戶端串流裝置相關屬性。 |
| [XGameStreamingVideoFlags](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingvideoflags.md) | 用戶端串流裝置可能支援的可用視訊功能。 |

### 結構

| 結構 | 描述 |
| :- | :- |
| [XGameStreamingDisplayDetails](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/structs/xgamestreamingdisplaydetails.md) | 串流用戶端裝置之顯示器的詳細資料。 |

## 連線狀態

管理串流用戶端裝置連線狀態所需的 API。

### 函式

| 函式 | 描述 |
| :- | :- |
| [XGameStreamingConnectionStateChangedCallback](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingconnectionstatechangedcallback.md) | 每當已連線之串流用戶端的狀態變更時要叫用的回呼函式。 |
| [XGameStreamingGetClientCount](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount.md) | 目前已連線的串流裝置數目。 |
| [XGameStreamingGetClients](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetclients.md) | 取得每個目前已連線用戶端的識別碼。 |
| [XGameStreamingGetConnectionState](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetconnectionstate.md) | 取得指定裝置目前的連線狀態。 |
| [XGameStreamingIsStreaming](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingisstreaming.md) | 判斷遊戲目前是否正在串流。 |
| [XGameStreamingRegisterConnectionStateChanged](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged.md) | 註冊在串流用戶端裝置的連線狀態變更時要叫用的回呼。 |
| [XGameStreamingUnregisterConnectionStateChanged](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingunregisterconnectionstatechanged.md) | 取消註冊先前註冊的 XGameStreamingConnectionStateChangedCallback。 |

### 列舉

| 列舉 | 描述 |
| :- | :- |
| [XGameStreamingConnectionState](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingconnectionstate.md) | 串流用戶端裝置的連線狀態。 |

## 延遲

針對串流延遲調整遊戲玩法的 API。

### 函式

| 函式 | 描述 |
| :- | :- |
| [XGameStreamingGetStreamAddedLatency](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetstreamaddedlatency.md) | 取得最近串流相關延遲的平均值。 |
| [XGameStreamingGetLastFrameDisplayed](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetlastframedisplayed.md) | **已淘汰。** 取得最近一次顯示在串流用戶端畫面上之畫面的畫面管線權杖。 |
| [XGameStreamingGetAssociatedFrame](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe.md) | **已淘汰。** 從特定輸入讀數取得畫面管線權杖。 |

## 伺服器位置

用於存取遊戲串流來源位置的 API。

### 函式

| 函式 | 描述 |
| :- | :- |
| [XGameStreamingGetServerLocationName](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationname.md) | 取得串流伺服器的資料中心位置。 |
| [XGameStreamingGetServerLocationNameSize](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize.md) | 取得串流伺服器資料中心位置名稱的大小 |

## 觸控調整

管理將公開給適當串流用戶端之觸控控制器配置的 API。

### 函式

| 函式 | 描述 |
| :- | :- |
| [XGameStreamingGetGamepadPhysicality](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetgamepadphysicality.md) | 從特定遊戲台讀數取得輸入實體性對應。 |
| [XGameStreamingHideTouchControls](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols.md) | 要求所有已連線的串流用戶端裝置在觸控配置可見時將其隱藏。 |
| [XGameStreamingHideTouchControlsOnClient](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrolsonclient.md) | 要求指定的串流用戶端裝置在觸控配置可見時將其隱藏。 |
| [XGameStreamingShowTouchControlLayout](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout.md) | 要求所有已連線的串流用戶端裝置顯示指定的觸控配置。 |
| [XGameStreamingShowTouchControlLayoutOnClient](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient.md) | 要求指定之已連線串流用戶端裝置顯示指定的觸控配置。 |
| [XGameStreamingShowTouchControlsWithStateUpdate](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrolswithstateupdate.md) | 要求所有已連線的串流用戶端裝置更新其觸控控制項狀態，然後顯示指定的觸控配置。 |
| [XGameStreamingShowTouchControlsWithStateUpdateOnClient](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrolswithstateupdateonclient.md) | 要求指定的串流用戶端裝置更新其觸控控制項狀態，然後顯示指定的觸控配置。 |
| [XGameStreamingUpdateTouchControlsState](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingupdatetouchcontrolsstate.md) | 更新所有已連線串流用戶端裝置上的觸控控制項狀態。 |
| [XGameStreamingUpdateTouchControlsStateOnClient](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingupdatetouchcontrolsstateonclient.md) | 更新指定串流用戶端裝置上的觸控控制項狀態。 |

### 列舉

| 列舉 | 描述 |
| :- | :- |
| [XGameStreamingGamepadPhysicality](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/enums/xgamestreaminggamepadphysicality.md) | 標準 XBOX 無線控制器上所有按鈕、搖桿和扳機的實體性對應。對於任何指定的按鈕/搖桿/扳機，實體性可以是未知、實體、虛擬或兩者皆是。 |
| [XGameStreamingTouchControlsStateOperationKind](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingtouchcontrolsstateoperationkind.md) | 更新觸控控制項配置狀態時可採取的作業。 |
| [XGameStreamingTouchControlsStateValueKind](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingtouchcontrolsstatevaluekind.md) | 指定與觸控配置相關聯之狀態的類型。 |

### 結構

| 結構 | 描述 |
| :- | :- |
| [XGameStreamingTouchControlsStateOperation](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/structs/xgamestreamingtouchcontrolsstateoperation.md) | 指定要套用的作業、特定變數的路徑和值。 |
| [XGameStreamingTouchControlsStateValue](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/structs/xgamestreamingtouchcontrolsstatevalue.md) | 提供觸控控制項狀態之特定元素的類型和值。 |

## 解析度

管理串流解析度的 API。

### 函式

| 函式 | 描述 |
| :- | :- |
| [XGameStreamingSetResolution](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingsetresolution.md) | 設定視訊串流的解析度。 |

## 錯誤碼

XGameStreaming API 可能會傳回下列錯誤碼。如需完整清單，請參閱[錯誤碼](https://docs.xbox.com/zh-TW/reference/errorcodes.md)。

| 代碼 | 值 | 描述 |
| - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | XGameStreaming 執行階段尚未初始化。請先呼叫 [XGameStreamingInitialize](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminginitialize.md)，再呼叫其他 API。 |
| E\_GAMESTREAMING\_CLIENT\_NOT\_CONNECTED | 0x89245401 | 指定的用戶端未連線。 |
| E\_GAMESTREAMING\_NO\_DATA | 0x89245402 | 要求的資料無法使用。資料可能稍後才可使用。 |
| E\_GAMESTREAMING\_NO\_DATACENTER | 0x89245403 | 目前的電腦不是在資料中心內執行。 |
| E\_GAMESTREAMING\_NOT\_STREAMING\_CONTROLLER | 0x89245404 | 目前的讀數並非來自串流控制器。 |

## 概念文件

* [雲端感知 API 呼叫](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-am-i-streaming.md)
* [開始使用觸控](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-getting-started-with-touch.md)
* [遊戲串流延遲補償深入探討](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive.md)
* [遊戲串流延遲補償概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-latency-compensation-overview.md)
* [遊戲串流延遲測量](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-latency-measurement.md)

## 另請參閱

[系統 API 參考](https://docs.xbox.com/zh-TW/reference/system/gc-reference-system-toc.md)


## Related topics

- [雲端感知 API 呼叫](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-am-i-streaming.md)
- [開始使用觸控](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-getting-started-with-touch.md)
- [遊戲串流延遲測量](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-latency-measurement.md)
- [遊戲串流延遲補償概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-latency-compensation-overview.md)
- [遊戲串流延遲補償深入探討](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive.md)
