メインコンテンツへスキップ

ゲーマーアイコン URI

このセクションでは、ゲーマーアイコン に関する XBOX Live Services のゲーマーアイコン Universal Resource Identifier (URI) アドレスと関連する Hypertext Transport Protocol (HTTP) メソッドの詳細について説明します。 これらの URI のドメインは gamerpics.xboxlive.com です。 ゲーマーアイコン サービスは、タイトルがユーザーに対して自身のゲーム キャラクターのゲーマーアイコンを生成できる機能を許可することで、より多くのパーソナライズ オプションをユーザーに提供するように設計されています (このシナリオにおけるゲーム キャラクターとは、ゲーム内の主人公を指します。人物、車、宇宙船、その他ユーザーがタイトル内で操作するあらゆるエンティティが該当します)。 タイトル ゲーマーアイコンを生成する基本的なフローは次のとおりです。
  • タイトルは、ユーザーが自身のゲーム内キャラクターの画像を作成できる機能を提供します。
    • 提供しない場合、タイトルは適切な特権をユーザーが持っていない旨をユーザーに通知できます。
    • ユーザーがその特権を持っている場合、キャラクターのゲーマーアイコンを引き続き作成できます。
  • ユーザーが画像を作成し、タイトルは 1080x1080 の .png ファイルをゲーマーアイコン サービスに送信します。
  • サービスはその画像を保存し、そのユーザーの新しいゲーマーアイコンとして設定します。
  • ユーザーのゲーマーアイコンを要求するあらゆるエクスペリエンスは、更新された画像を取得します。
タイトル ゲーマーアイコンを設定する機能は、エンフォースメント専用の特権 (211) で制御されます。エンフォースメントによってこの特権が取り消されると、ユーザーはタイトル ゲーマーアイコンを保存できなくなり、サービスは 403 を返します。タイトルは CheckPrivilege を呼び出して、ユーザーがコンテンツを共有できる (priv 211) ことを確認してください。 現時点では、このサービスを利用するにはタイトルの許可リスト登録が必要です。承認をリクエストするには、slsgamerpics@microsoft.com にメールを送信してください。

このセクションの内容

/users/me/gamerpic   1080x1080 のゲーマーアイコンにアクセスします。

関連項目

親
Universal Resource Identifier (URI) リファレンス
最終更新日 2026年10月19日