XBOX services ユーザー特権のクライアント側での使用

​

目次

• 前提条件
• 特権とアップセルのクライアント側の処理とプレイヤー体験
• アプリ側の特権処理のベスト プラクティス
• ゲームでの特権ベースのアクセス制御のテスト
• チェックする特権 ID

​

前提条件

​

特権とアップセルのクライアント側の処理とプレイヤー体験

1. プレイヤーはマルチプレイヤー セッションを開始するオプションを見て、UI で該当するオプションを選択して試合を開始しようとします。
2. ゲームは XUserCheckPrivilege API を使用して “ヒント” を確認します。
   • 存在する場合、プレイヤーが特権を持っているものとみなして進みます。
   • 存在しない場合、次のステップに進みます。

   [!NOTE] XBOX services API は、XToken に特権が存在しないためにフィーチャーへのアクセスが拒否された場合、ステータス コード 403 (HTTP_E_STATUS_FORBIDDEN) を返します。 XBOX services のすべてのエンドポイントは、必要に応じて特権ベースのアクセス制御を適用します。

3. 失敗コードに応じて、ゲームは解決しようとしている特権に対応する適切な特権 ID を指定して XUserResolvePrivilegeWithUiAsync を呼び出します。この関数は XBOX services を呼び出してプレイヤーが特権を持っているかどうかを確認し、プレイヤーにアクションが失敗した理由を伝えるか、それを解決するための UI を表示します。この API 呼び出しの結果として、以下が発生する可能性があります。
   • XBOX services のポリシーおよび違反対応モデレーターによって発行されたプレイヤーの適用ステータスに関連する UI を表示します。
   • ペアレンタル コントロールに関連する UI を表示します。
   • XBOX Game Pass Essential サブスクリプションなど、該当するサブスクリプション サービスをプロモートします。
   • 結果 (成功または失敗と、その理由) をゲームに返します。

   [!NOTE] XBOX services やネットワークに到達できない場合、XUserResolvePrivilegeWithUiAsync は失敗します。 この失敗は、プレイヤーが特権を持っていなかったものとして扱う必要があります。

4. XUserResolvePrivilegeWithUiAsync から戻ったとき:
   1. 失敗が返された場合、ゲームはプレイヤーが引き続きボタンを選択できるようにする必要があります。プレイヤーの禁止が期限切れになったり、ペアレンタル コントロールが変更されたりする可能性があるためです。
   2. 成功が返された場合、プレイヤーは救済されているため、ゲームは再度アクションを試みることができます。 プレイヤーのトークンには、XUserResolvePrivilegeWithUiAsync によって実行された救済の一環として必要な特権が含まれます。

タイトルに該当する特権の詳細については、トピック「Policies and XBOX Requirements」の XR-015 を参照してください。

​

コード例

XUserPrivilegeDenyReason reason;
bool hasPrivilege = false;

// check the Multiplayer (254) privilege
HRESULT hr = XUserCheckPrivilege(userHandle, XUserPrivilegeOptions::None, XUserPrivilege::Multiplayer, &hasPrivilege, &reason);

// error with the user such that we can't yet check privileges
if(E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED == hr)
{
      asyncBlock.callback = [](XAsyncBlock *async)
      {
         HRESULT hr = XUserResolveIssueWithUiResult(async);
         // if SUCCEEDED(hr), the issue is resolved, try the privilege check again
         // if FAILED(hr), the issue is not resolved, the title should deny access to the user, and perhaps try again later
      };

      hr = XUserResolveIssueWithUiAsync(userHandle, nullptr, &asyncBlock);
}

// user doesn't have the requested privilege, try to resolve the issue
else if(!hasPrivilege)
{
      asyncBlock.callback = [](XAsyncBlock *async)
      {
         HRESULT hr = XUserResolvePrivilegeWithUiResult(async);
         // if SUCCEEDED(hr), all privilege issues are now resolved, the user has the privilege,
         //    and the title should continue. It is not necessary to call XUserCheckPrivilege again.
         // if FAILED(hr), the user did not resolve all privileges, the title should deny access to the user and perhaps try again later
      };

      hr = XUserResolvePrivilegeWithUiAsync(userHandle, XUserPrivilegeOptions::None, XUserPrivilege::Multiplayer, &asyncBlock);
}
else if(hasPrivilege)
{
      // the user has the privilege, continue!
}

​

アプリ側の特権処理のベスト プラクティス

​

アプリで特権を解決する頻度

• ビデオ プレイヤーなどのメディア ストリーミング アプリでは、[再生] ボタンの選択 (ストリーム開始) ごと、またはプレイリストの開始時 (音楽プレイリストなど複数のストリームの場合) に特権チェックを解決します。
• メッセージング アプリでは、送信される最初のメッセージについて 1 回特権をチェックします。
• サードパーティのマッチ サービスを使用するマルチプレイヤー ゲームでは、セッション (試合) 開始ごとに特権チェックを解決します。

​

ユーザーのサブスクリプション ティアを想定しない

​

オフライン モード

​

正しいプレイヤーをターゲットにする

​

UI なし、または UI がフォーカスされていない状態でのチェック

​

ゲームでの特権ベースのアクセス制御のテスト

• プレイヤーの実効サブスクリプション権利
• デバイスの実効特権権利
• クライアント プラットフォームの実効特権権利
• 現在のゲームの実効特権権利
  • ゲームに特権のコレクションをパッケージ化して、ゲームのすべてのプレイヤーが実行中のゲームで使用するためにこれらの特権を自動的に取得できるようにすることができます。ゲームでこの機能が必要な場合は、Microsoft アカウント マネージャーにお問い合わせください。
• 親が家族の子供に対して追加または削除する特権を決定するためのペアレンタル コントロール
• XBOX モデレーターは、サービスの悪用が確認されたプレイヤーやデバイスの特権を禁止する場合があります

​

プレイヤーの特権とアクセス許可の管理と確認

• PC 上: https://aka.ms/XboxPrivSettings にアクセスします。
• XBOX 上: 設定 -> 一般 -> オンラインの安全性と家族 -> プライバシーとオンラインの安全性 -> XBOX プライバシー

​

XUserCheckPrivilege でチェックされる特権

XUserPrivilege::CrossPlay

• 説明: プレイヤーが、次のようなシナリオで XBOX services にサインインしていない他の実世界のプレイヤーとゲームプレイ セッションに参加できるようにします: 同じセッション内での同期のプレイヤー対プレイヤーのゲームプレイ、非同期のターンベースのゲームプレイ、チーム ベースのゲームプレイ、ユーザーが開始するマッチメイキング、招待の送信または受諾、進行中セッションへの参加。
• 要件: XR-045 - XBOX services and Account Privileges
• 特権 ID: 185
• PC 上の設定: You can play with people outside of XBOX services
• XBOX 上の設定: You can join cross-network play

XUserPrivilege::Sessions

• 説明: プレイヤーが共有環境で接続されたシングルプレイヤー体験に参加できるようにするか、またはタイトルがハイブリッドの無料プレイと有料マルチプレイヤーのタイトルであり、この特権を使用して XBOX コンソールでこれらの体験を制限するシナリオで使用します。シングルプレイヤー体験には、特権 252 または 254 (それぞれ Communications と Multiplayer) でカバーされる機能を持たせないでください。この特権の使用はタイトル機能であり、プラットフォームの承認が必要です。
• 要件: XR-045 - XBOX services and Account Privileges
• 特権 ID: 189
• PC 上の設定: You can join multiplayer games
• XBOX 上の設定: You can join multiplayer games

XUserPrivilege::Multiplayer

• 説明: プレイヤーが、次のようなシナリオで実世界のユーザー (ボットではない) とオンライン マルチプレイヤー ゲームプレイ セッションに参加できるようにします: 同じセッション内での同期のプレイヤー対プレイヤーのゲームプレイ、非同期のターンベースのゲームプレイ、チーム ベースのゲームプレイ、ユーザーが開始するマッチメイキング、招待の送信または受諾、進行中セッションへの参加。この特権は同じデバイス上で実行されるローカル マルチプレイヤー ゲームには関係しません。
• 要件: XR-045 - XBOX services and Account Privileges
• 特権 ID: 254
• PC 上の設定: You can join multiplayer games
• XBOX 上の設定: You can join multiplayer games

XUserPrivilege::UserGeneratedContent

• 説明: プレイヤーが他のユーザーの UGC をオンラインで見たり、他のユーザーの UGC をダウンロードしたり、自分の UGC をオンラインで共有したりできるようにします。以前にダウンロードした UGC の使用は制限されません。
• 要件: XR-045 - XBOX services and Account Privileges
• 特権 ID: 247
• PC 上の設定: You can see and upload community creations
• XBOX 上の設定: You can see and upload community creations

XUserPrivilege::SocialNetworkSharing

• 説明: XBOX コンソール専用: プレイヤーがゲームの進行状況、Kinect で生成されたコンテンツ、ゲーム クリップなどの情報を XBOX network の外部で共有できるようにします。
• 要件: XR-045 - XBOX services and Account Privileges
• 特権 ID: 220
• XBOX 上の設定: You can share outside of XBOX

XUserPrivilege::Communications

• 説明: プレイヤーが音声またはテキストを通じて他の XBOX services ユーザーと通信できるようにします。
• 要件: XR-045 - XBOX services and Account Privileges
• 特権 ID: 252
• PC 上の設定: Others can communicate with voice, text or invites
• XBOX 上の設定: Others can communicate with voice, text or invites

​

XblPrivacyCheckPermissionAsync でチェックされるアクセス許可

XblPermission::CommunicateUsingText

• 説明: プレイヤーがテキスト コンテンツを含むメッセージをターゲット ユーザーに送信できるかどうかを確認します。この値はプレイヤーがターゲット ユーザーをミュートしても変わりません。代わりに CommunicateUsingVoice を使用してください。たとえば、コミュニケーションをフレンドのみに設定していてターゲットがフレンドではない場合、この値は false になります。たとえば、ターゲット プレイヤーがあなたをブロックしている場合、この値は false になります。たとえば、コミュニケーション設定を「ブロック」に設定している場合、この値は false になります。
• 要件: XR-015 - Managing Player Communication
  • 別の XBOX services ユーザーを確認する場合
    • PC 上の設定: Others can communicate with voice, text or invites
    • XBOX 上の設定: Others can communicate with voice, text or invites
  • 匿名ユーザーを確認する場合
    • PC 上の設定: You can communicate outside of XBOX services with voice & text
    • XBOX 上の設定: You can communicate outside of XBOX with voice & text

XblPermission::CommunicateUsingVoice

• 説明: プレイヤーが音声を使用してターゲット ユーザーと通信できるかどうかを確認します。プレイヤーがターゲット ユーザーをミュートしている場合は false になります。
• 要件: XR-015 - Managing Player Communication
  • 別の XBOX services ユーザーを確認する場合
    • PC 上の設定: Others can communicate with voice, text or invites
    • XBOX 上の設定: Others can communicate with voice, text or invites
  • 匿名ユーザーを確認する場合
    • PC 上の設定: You can communicate outside of XBOX services with voice & text
    • XBOX 上の設定: You can communicate outside of XBOX with voice & text

​

サブスクリプションによって提供される特権のテスト

​

実行中のゲームによって提供される特権のテスト

​

ペアレンタル コントロールで削除される特権のテスト

​

チェックする特権 ID

​

特権の計算ロジック

​

デバイス タイプから発生する特権権利

​

サブスクリプションから発生する実効特権権利

• プレイヤーがサブスクリプション製品を購入した。
• 同じデバイス上の別のアクティブ プレイヤーがサブスクリプション製品を購入した。
• サブスクリプション製品が、プレイヤーが現在使用しているデバイスに関連付けられている。

​

プロモーション権利

​

スポンサー ゲスト アカウントで削除される特権

​

オンラインの安全性と Microsoft の適用

​

ペアレンタル コントロール

​

XBOX Game Pass Essential サブスクライバーの特権

​

パートナー サブスクリプションと特権

​

無料プレイのタイトルとマルチプレイヤー特権

​

ハイブリッド タイトルとマルチプレイヤー特権

​

関連項目