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

# DeviceEndpoint (JSON)

> DeviceEndpoint (JSON)

# DeviceEndpoint (JSON)

<a id="ID4EO" />

## DeviceEndpoint

DeviceEndpoint 物件具有下列規格。

| 成員 | 類型 | 描述 |
| - | - | - |
| deviceName | string | 選擇性。裝置的易記名稱 (如適用)。目前未使用此值。 |
| endpointUri | string | 必要。用戶端平台 (Windows 或 Windows Phone) 從其推播通知服務 (WNS 或 MPNS) 取得的 URL。 |
| locale | string | 必要。傳送至此端點之通知的所需語言。可以是依喜好順序排列的逗號分隔值清單。範例："de-DE, en-US, en"。 |
| platform | string | 選擇性。目前支援的值為 "WindowsPhone" 和 "Windows"。如果未指定，則會從裝置權杖衍生。 |
| platformVersion | string | 選擇性。此字串的格式依各平台而定。目前未使用此值。 |
| systemId | GUID | 必要。「應用程式執行個體」(裝置/使用者組合) 的唯一識別碼。最佳做法是讓應用程式在安裝/首次執行時產生隨機 GUID，並在後續執行應用程式時持續使用該值。 |
| titleId | 32 位元不帶正負號整數 | 必要。對服務發出呼叫之遊戲的 Title ID。 |

<a id="ID4EGD" />

## JSON 語法範例

```json theme={null}
{
  "systemId": "e9af05b4-70de-4920-880f-026c6fb67d1b",
  "userId" : 1234567890
  "endpointUri": "http://cloud.notify.windows.com/.../",
  "platform": "Windows",
  "platformVersion": "1.0",
  "deviceName": "Test Endpoint",
  "locale": "en-US",
  "titleId": 1297290219
}
    
```

<a id="ID4EPD" />

## 另請參閱

<a id="ID4ERD" />

##### 上層

[JavaScript 物件標記法 (JSON) 物件參考](/zh-TW/reference/live/rest/json/atoc-xboxlivews-reference-json)

<a id="ID4E4D" />

##### 參考


## Related topics

- [Party Quickstart](/services/playfab/multiplayer/networking/quickstart.md)
- [XblAchievementUnlockEvent](/reference/live/xsapi-c/achievements_c/structs/xblachievementunlockevent.md)
