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

# Gamerpic URIs

> Gamerpic URIs

# Gamerpic URIs

本节提供有关*玩家图片*的 XBOX Live 服务 Gamerpic 通用资源标识符 (URI) 地址及关联的超文本传输协议 (HTTP) 方法的详细信息。

这些 URI 的域为 `gamerpics.xboxlive.com`。

玩家图片服务的设计旨在为用户提供更多的个性化选项,通过授予标题允许用户生成其游戏角色的玩家图片的能力(在此场景中,游戏角色指的是游戏内的主角;可以是人物、汽车、宇宙飞船或用户在标题中控制的任何其他实体)。

生成标题玩家图片的基本流程如下:

* 标题为用户提供创建其游戏内角色图像的能力。
  * 如果不能,则标题可以向用户显示消息,提示他们没有相应的权限。
  * 如果用户拥有该权限,则用户可以继续创建其角色玩家图片。

* 用户创建图像,标题将 1080x1080 的 .png 文件发送到玩家图片服务。

* 服务存储该图像,并将该图像设置为用户的新玩家图片。

* 任何请求用户玩家图片的体验都将获取更新后的图像。

设置标题玩家图片的能力由仅用于强制执行的权限 (211) 控制。如果强制执行撤销该权限,用户将无法保存标题玩家图片,并且服务将返回 403。标题应调用 CheckPrivilege 来验证用户是否被允许共享内容(权限 211)。

目前,为了使用此服务,您的标题必须列入允许列表。若要请求批准,请发送电子邮件至 `slsgamerpics@microsoft.com`。

## 本节内容

[/users/me/gamerpic](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/gamerpic/uri-usersmegamerpic)

  访问 1080x1080 的玩家图片。

## 另请参阅

##### 父主题

[通用资源标识符 (URI) 参考](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/atoc-xboxlivews-reference-uris)


## Related topics

- [XR046 Display Name and Gamerpic](https://devdocs.xbox.com/publishing/certification/fma/xr-046.md)
- [XR-046 Display Name and Gamerpic](https://devdocs.xbox.com/publishing/certification/xr/xr-046.md)
- [XR046 Nombre para mostrar y gamerpic](https://devdocs.xbox.com/es/publishing/certification/fma/xr-046.md)
- [Front Panel URIs (API contents)](https://devdocs.xbox.com/reference/deviceportal/frontpanel/atoc-rest-frontpanel.md)
- [Remote Recovery URIs (API contents)](https://devdocs.xbox.com/reference/deviceportal/remote/atoc-rest-remote.md)