> ## 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)

## DeviceEndpoint

DeviceEndpoint 对象具有以下规范。

| 成员 | 类型 | 说明 |
| - | - | - |
| deviceName | string | 可选。设备的友好名称(如适用)。此值当前未使用。 |
| endpointUri | string | 必填。客户端平台(Windows 或 Windows Phone)从其推送通知服务(WNS 或 MPNS)获取的 URL。 |
| locale | string | 必填。发送到此终结点的通知的目标语言。可以是按优先级顺序排列的、以逗号分隔的值列表。示例:“de-DE, en-US, en”。 |
| platform | string | 可选。当前支持的值是 “WindowsPhone” 和 “Windows”。如果未指定,则从 Device 令牌派生。 |
| platformVersion | string | 可选。该字符串的格式特定于每个平台。此值当前未使用。 |
| systemId | GUID | 必填。“应用实例”(设备/用户组合)的唯一标识符。最佳实践是应用在安装/首次运行时生成随机 GUID,并在后续应用运行中继续使用该值。 |
| titleId | 32 位无符号整数 | 必填。发出对服务调用的游戏的 Title ID。 |

## 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
}
    
```

## 另请参阅

##### 父主题

[JavaScript 对象表示法 (JSON) 对象参考](/zh-CN/reference/live/rest/json/atoc-xboxlivews-reference-json)

##### 参考


## Related topics

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