Skip to main content

玩家圖片 URI

本節提供 XBOX Live 服務中與玩家圖片相關的玩家圖片統一資源識別碼 (URI) 位址及相關聯超文字傳輸通訊協定 (HTTP) 方法的詳細資料。 這些 URI 的網域為 gamerpics.xboxlive.com。 玩家圖片服務的設計目的是為使用者提供更多個人化選項,方法是讓遊戲能夠允許使用者產生其遊戲角色的玩家圖片 (此案例中的遊戲角色是指遊戲內的主角;可以是人物、汽車、太空船,或使用者在遊戲中控制的任何其他實體)。 產生遊戲玩家圖片的基本流程如下:
  • 遊戲讓使用者能夠建立其遊戲內角色的影像。
    • 如果沒有權限,遊戲可以向使用者傳送訊息,告知其沒有適當的權限。
    • 如果使用者具有權限,使用者可以繼續建立其角色玩家圖片。
  • 使用者建立影像,然後遊戲將 1080x1080 .png 檔案傳送至玩家圖片服務。
  • 服務會儲存影像,並將該影像設定為使用者的新玩家圖片。
  • 任何呼叫使用者玩家圖片的體驗都會取得更新後的影像。
設定遊戲玩家圖片的能力由僅限執法的權限 (211) 控制。如果執法撤銷此權限,使用者將無法儲存遊戲玩家圖片,而服務會傳回 403。遊戲應呼叫 CheckPrivilege 以確認使用者是否獲准分享內容 (權限 211)。 目前,若要使用此服務,您的遊戲必須列入允許清單。若要要求核准,請傳送電子郵件至 slsgamerpics@microsoft.com。

本節內容

/users/me/gamerpic   存取 1080x1080 玩家圖片。

另請參閱

上層
統一資源識別碼 (URI) 參考
Last modified on October 6, 2026