Xbox 서비스 사용자 권한의 클라이언트 측 사용

아티클
05/10/2023

이 항목을 사용하여 Xbox 서비스에서 사용할 수 있는 사용자 권한을 확인 및 해결하고 Xbox 콘솔 또는 Windows PC에서 업셀 시스템을 결정하세요.

필수 구성 요소

Xbox 서비스 클라이언트 앱에서 사용자 권한을 처리하려면 Xbox 서비스 인증을 위해 타이틀을 구성하세요. 자세한 내용은 인증 및 로그인 개요 및 Xbox 서비스 사용자 권한 개요를 참조하세요.

권한 및 업셀 관련 사용자 환경 및 클라이언트 쪽 처리

클라이언트 앱은 XR-045: Xbox 서비스 및 계정 권한과 같이 타이틀의 일부를 제어할 수 있는 권한이 필요한 XR(Xbox 요구 사항)을 따릅니다. 자세한 내용은 정책 및 Xbox 요구 사항을 참조하세요.

권한으로 관리되는 앱의 경우 API를 사용할 수 있습니다. XUserCheckPrivilege - 사용자에게 특정 권한이 있는지 확인합니다. XUserResolvePrivilegeUiAsync를 사용하면 필요한 사용자 권한의 해상도 UI가 표시됩니다. 사용자에게 권한이 없는 경우 이를 설명하거나 업셀하는 데 필요한 UI가 표시됩니다.

예를 들어 XPRIVILEGE_MULTIPLAYER_SESSIONS 권한의 적용을 받는 앱의 흐름은 다음과 같습니다.

사용자는 멀티플레이어 세션을 시작하는 옵션을 보고 UI에서 적절한 옵션을 선택하여 일치 항목을 시작하려고 시도합니다.
앱은 XUserCheckPrivilege API를 사용하여 "힌트"를 확인합니다.
- 사용자에게 권한이 있다고 가정하고 계속 진행합니다.
- 힌트가 없으면 다음 단계로 넘어갑니다.
참고 항목

XToken의 누락된 권한으로 인해 기능에 관한 액세스가 거부되면 Xbox 서비스 API는 상태 코드 403(HTTP_E_STATUS_FORBIDDEN)을 반환합니다. Xbox 서비스의 모든 엔드포인트는 권한 기반 액세스 제어를 적절하게 적용합니다.
오류 코드에 응답하여 타이틀 앱은 해결하려는 코드에 적합한 권한 ID를 가진 XUserResolvePrivilegeWithUiAsync을(를) 호출합니다. 이 함수는 Xbox 서비스를 호출하여 사용자에게 권한이 있는지 확인한 다음 사용자에게 작업이 실패한 이유를 알려주거나 이를 해결할 수 있는 UI를 사용자에게 보여줍니다. 다음은 이 API 호출로 인해 발생할 수 있습니다.
- Xbox 서비스 정책 및 시행 중재자가 발급한 사용자의 시행 상태와 관련된 UI를 표시합니다.
- 자녀 보호와 관련된 UI를 표시합니다.
- Xbox Live Gold 구독과 같은 해당 구독 서비스를 승격합니다.
- 결과를 타이틀(성공 또는 실패와 이유 포함)으로 반환합니다.
참고 항목

Xbox 서비스 또는 네트워크에 연결할 수 없으면 XUserResolvePrivilegeWithUiAsync이(가) 실패합니다. 이 실패는 사용자에게 권한이 없는 것으로 간주해야 합니다.
XUserResolvePrivilegeWithUiAsync에서 반환되면:
1. 오류가 반환되면 타이틀은 사용자가 단추를 계속 클릭할 수 있게 해야 합니다. 사용자의 금지가 소멸되거나 자녀 보호가 변경되는 등의 일이 발생할 수 있기 때문입니다.
2. 성공이 반환되면 사용자가 수정되며 타이틀에서 작업을 다시 시도할 수 있습니다. 사용자의 토큰에는 XUserResolvePrivilegeWithUiAsync이(가) 수행하는 수정 과정에서 필요한 권한이 포함됩니다.

참고 항목

권한은 "내가 할 수 있나요?"(예: "이 사용자가 멀티플레이어 기능에 액세스할 수 있습니까?")와 같은 질문에 답하는 매크로 수준 검사입니다. 그러나 앱에서 확인해야 하는 권한은 사용 권한뿐만이 아닙니다.

타이틀에 적용할 수 있는 권한에 대한 자세한 내용은 정책 및 Xbox 요구 사항 항목의 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!
}

앱 쪽 권한 처리 모범 사례

타이틀에서 사용자 권한을 처리할 때 다음 모범 사례를 사용하고 있는지 확인하세요.

앱 내 권한 해결 빈도

권한 확인의 경우, 실행당 한 번씩 사용자에게 적절한 권한이 있는지 확인하고 해당 권한을 해결해야 합니다. 모든 논리적 세션 및 개별 작업을 확인하는 것이 좋습니다.

세션 정의는 앱 사용에 따라 크게 다를 수 있습니다.

다음은 모범 사례의 예입니다.

비디오 플레이어와 같은 미디어 스트리밍 앱의 경우 재생 버튼(스트리밍 시작)을 선택할 때마다 또는 재생 목록 시작 시(음악 재생 목록 등 여러 스트림의 경우) 권한 검사를 확인합니다.
메시징 앱의 경우 처음 보낸 메시지에 대한 권한을 한 번 확인합니다.
타사 일치 서비스를 사용하는 멀티플레이어 앱의 경우 세션(일치)이 시작될 때마다 권한 검사를 확인합니다.

사용자의 구독 계층은 가정하지 않습니다.

역사적으로 Xbox 360의 클레임은 사용자의 구독 계층(예: Xbox Live Gold 상태)에 대한 정보를 제공했습니다. 이 클레임은 Xbox One 패밀리 이상에서 더 이상 사용되지 않습니다. 권한을 사용하여 결정을 내리고 있는지 확인합니다. 사용자의 계층 또는 권한을 획득한 방법은 앱에 불투명해야 합니다.

오프라인 모드

XUserCheckPrivilege이(가) 서비스가 중단되었거나 연결할 수 없다고 반환하면, 권한 확인이 오류를 반환한 것처럼 처리합니다. 이렇게 하면 앱이 XR 준수 상태를 유지할 수 있도록 장애가 방지됩니다.

올바른 사용자 대상 지정

권한 검사에 다른 사용자가 지정되지 않은 경우 항상 해당 사용자를 참조하는 것이 좋습니다. 앱에서 사용자 지정을 지원하는 경우 현재 지정된 사용자를 사용하세요.

예를 들어, Bill, Bob, Beth 세 명의 사용자가 로그인되어 있습니다. 앱은 사용할 권장 사항, 기록 및 설정을 지정하기 위해 "활성 사용자" 간 전환을 지원합니다. Beth가 앱을 실행합니다. 앱이 실행 중일 때 활성 사용자가 Bob을 전환했습니다. Bob은 별도의 프로필, 권장 사항 집합과 기록을 가지고 있습니다. Bob에 대한 권한 검사를 시작하려면 XUserCheckPrivilege에 문의하세요.

UI가 없거나 UI가 포커스를 벗어난 상태에서 확인

앱에서 모달을 표시할 수 없는 경우가 있어 권한 확인을 위한 UX가 차단됩니다. 앱이 백그라운드에서 음악을 재생하거나, Skype 앱이 백그라운드에서 실행 중일 때 전화를 수신하는 상황 등이 여기에 해당합니다. 그러나 여전히 앱에서 권한을 확인해야 합니다. XUserCheckPrivilege을(를) 호출하는 것이 좋습니다. XUserCheckPrivilege은(는) UI를 표시하는 대신 사용자의 현재 사용 권한 상태를 반환하거나 해당 오류를 반환합니다. 앱은 권한에 정의된 대로 사용자에게 영향을 미칠 수 있으며 앱이 다시 포커스를 받을 때 권한 확인을 사용자에게 알릴 수 있습니다.

반대로, 타이틀은 원하는대로 사용자 비 모달 오류 정보 또는 다른 UX를 표시할 수 있습니다. 사용자에게 차단 UX를 표시하는 것이 적절한 경우 XUserResolvePrivilegeWithUiAsync을(를) 다시 호출하여 적절한 UX(예: 상향 판매 또는 시행 상태)를 표시합니다.

앱에서 권한 기반 액세스 제어 테스트

권한은 다음 입력을 기준으로 계산됩니다.

해당 사용자의 유효한 구독 권리.
장치의 유효 권한 권리
클라이언트 플랫폼의 효과적인 권한 부여-
현재 타이틀의 유효한 권한 권리
- 실행 중인 앱에서 사용할 수 있도록 앱의 모든 사용자가 이러한 권한을 자동으로 받도록 권한 모음과 함께 타이틀을 패키징할 수 있습니다. 타이틀에 이 기능이 필요한 경우 Microsoft 계정 관리자에게 문의하세요.
부모의 자녀에 대한 추가 또는 제거할 권한을 결정하는 자녀 보호
Xbox 중재자는 서비스 남용이 확인된 사용자나 디바이스의 권한을 금지할 수 있습니다.

사용자 권한 및 권한 관리 및 확인

사용자 개인 정보 설정은 두 가지 방법으로 액세스할 수 있습니다.

PC:
https://aka.ms/XboxPrivSettings로 이동합니다.
Xbox:
설정으로 이동 -> 일반 -> 온라인 안전 & 가족 -> 개인 정보 & 온라인 안전 -> Xbox 개인 정보

XUserCheckPrivilege로 확인된 권한

XUserPrivilege::CrossPlay

설명: 동일 세션에서 동시 플레이어 대 플레이어 게임 플레이, 비동기 턴 기반 게임 플레이, 팀 기반 게임 플레이, 사용자가 시작한 매치 메이킹, 초대 보내기 또는 수락, 진행 중 참가 세션과 같은 시나리오에서 Xbox 서비스에 로그인되지 않은 다른 실제 플레이어와 함께 게임 플레이 세션에 참가할 수 있게 해줍니다.
요구 사항: XR-045 - Xbox 서비스 및 계정 권한
권한 ID: 185
PC에서 설정 : Xbox 서비스 외부 사람들과 플레이 가능
Xbox에서 설정: 네트워크 간 플레이에 참가할 수 있습니다.

XUserPrivilege::Sessions

설명: 사용자가 공유 환경 또는 타이틀이 하이브리드 무료 플레이 및 유료 멀티 플레이어 타이틀인 시나리오에서 연결된 싱글 플레이어 환경에 참여할 수 있도록 하고, 이 권한을 사용하여 Xbox 콘솔에서 환경을 제어할 수 있습니다. 싱글 플레이어 환경에는 권한 252 또는 254(각각 통신 및 멀티 플레이)에 포함되는 기능이 없어야 합니다. 이 권한의 사용은 플랫폼 승인이 필요한 타이틀 기능입니다.
요구 사항: XR-045 - Xbox 서비스 및 계정 권한
권한 ID: 189
PC에서 설정: 멀티 플레이어 게임에 참가할 수 있습니다.
Xbox에서 설정: 멀티 플레이어 게임에 참가할 수 있습니다.

XUserPrivilege::Multiplayer

설명: 동일 세션에서 동시 플레이어 대 플레이어 게임 플레이, 비동기 턴 기반 게임 플레이, 팀 기반 게임 플레이, 사용자가 시작한 매치 메이킹, 초대 보내기 또는 수락, 진행 중 참가 세션과 같은 시나리오에서 실제 사용자(봇 제외)와 함께 온라인 멀티 플레이어 게임 플레이 세션에 참가할 수 있게 해줍니다. 이 권한은 동일 기기에서 실행되는 로컬 멀티 플레이어 게임과 관련이 없음을 참고하세요.
요구 사항: XR-045 - Xbox 서비스 및 계정 권한
권한 ID: 254
PC에서 설정: 멀티 플레이어 게임에 참가할 수 있습니다.
Xbox에서 설정: 멀티 플레이어 게임에 참가할 수 있습니다.

XUserPrivilege::UserGeneratedContent

설명: 사용자가 다른 사용자의 UGC 온라인을 확인하고, 다른 사용자의 UGC를 다운로드하고, 온라인에서 UGC를 공유할 수 있습니다. 이전에 다운로드한 UGC의 사용이 제한되지 않습니다.
요구 사항: XR-045 - Xbox 서비스 및 계정 권한
권한 ID: 247
PC에서 설정: 커뮤니티 만들기를 보고 업로드할 수 있습니다.
Xbox에서 설정: 커뮤니티 만들기를 보고 업로드할 수 있습니다.

XUserPrivilege::SocialNetworkSharing

설명: Xbox 콘솔만 해당: 사용자가 게임 진행 상황, Kinect 생성 콘텐츠, 게임 클립 등을 포함한 정보를 Xbox 네트워크 외부에서 공유할 수 있도록 허용합니다.
요구 사항: XR-045 - Xbox 서비스 및 계정 권한
권한 ID: 220
Xbox에서 설정: Xbox 외부에서 공유할 수 있습니다.

XUserPrivilege::Communications

설명: 사용자가 음성이나 텍스트를 통해 다른 Xbox 서비스 사용자와 통신할 수 있습니다.
요구 사항: XR-045 - Xbox 서비스 및 계정 권한
권한 ID: 252
PC에서 설정: 다른 사람들은 음성과 문자 또는 초대로 통신할 수 있습니다.
Xbox에서 설정: 다른 사람들은 음성과 문자 또는 초대로 통신할 수 있습니다.

XblPrivacyCheckPermissionAsync로 확인된 권한

또한 타이틀은 여러 사용자에 대해 권한을 확인해야 할 때 XblPrivacyBatchCheckPermissionAsync를 사용하고 비 Xbox 서비스 사용자에 대해 권한을 확인할 때 XblPrivacyCheckPermissionForAnonymousUserAsync를 사용할 수 있습니다.

XblPermission::CommunicateUsingText

설명: 사용자가 텍스트 콘텐츠가 포함된 메시지를 대상 사용자에게 전송할 수 있는지를 확인합니다. 플레이어가 대상 사용자를 음소거한 경우에는 이 값이 변경되지 않습니다. CommunicateUsingVoice를 대신 사용합니다. 예를 들어 친구에게만 통신하도록 설정했는데 대상이 친구가 아닌 경우 이 값은 false가 됩니다. 예를 들어 대상 사용자가 나를 차단한 경우 이 값은 false가 됩니다. 예를 들어 통신 설정을 차단됨으로 지정한 경우 이 값은 false가 됩니다.
요구 사항: XR-015 - 플레이어 통신 관리
- 다른 Xbox 서비스 사용자를 확인하는 경우
  - PC에서 설정: 다른 사람들은 음성과 문자 또는 초대로 통신할 수 있습니다.
  - Xbox에서 설정: 다른 사람들은 음성과 문자 또는 초대로 통신할 수 있습니다.
- 익명 사용자를 확인하는 경우
  - PC에서 설정: 음성 및 문자로 Xbox 서비스 외부에서 통신할 수 있습니다.
  - Xbox에서 설정: Xbox 외부에서 음성 및 텍스트로 통신할 수 있습니다.

XblPermission::CommunicateUsingVoice

설명: 사용자가 음성을 사용하여 대상 사용자와 통신할 수 있는지를 확인합니다. 플레이어가 대상 사용자를 음소거한 경우 이 값은 false가 됩니다.
요구 사항: XR-015 - 플레이어 통신 관리
- 다른 Xbox 서비스 사용자를 확인하는 경우
  - PC에서 설정: 다른 사람들은 음성과 문자 또는 초대로 통신할 수 있습니다.
  - Xbox에서 설정: 다른 사람들은 음성과 문자 또는 초대로 통신할 수 있습니다.
- 익명 사용자를 확인하는 경우
  - PC에서 설정: 음성 및 문자로 Xbox 서비스 외부에서 통신할 수 있습니다.
  - Xbox에서 설정: Xbox 외부에서 음성 및 텍스트로 통신할 수 있습니다.

구독에서 제공하는 권한 테스트

파트너 센터를 사용하여 Xbox Live Gold 구독으로 테스트 계정을 생성할 수 있습니다. 이 계정을 사용하여 Xbox Live Gold 구독을 통해 제공되는 권한에 대한 권한 논리를 테스트할 수 있습니다.

개발 클라이언트의 테스트 계정을 사용하여 다른 구독을 구입할 수 있습니다.

참고 항목

구독은 계정 또는 장치가 인증된 개발 샌드박스에 게시되어야 하며 개발 클라이언트의 계정은 동일한 샌드박스에서 활성화되어야 합니다.

파트너 센터를 통해 생성된 테스트 계정을 사용하면 정품 Xbox Live Gold 구독을 직접 구입할 수 없습니다. 대신 개발 시나리오에만 적용되는 Xbox Live Gold 개발자별 버전을 구입할 수 있습니다.

실행 중인 타이틀에서 제공하는 권한 테스트

사용자가 앱에 있을 때 권한을 자동으로 발급하도록 앱을 설정하려면 Microsoft 계정 관리자에게 문의하세요. 이 시나리오를 테스트하려면 Xbox 서비스 인증을 위해 앱을 구성하고 사용자가 로그인한 상태에서 앱을 실행해야 합니다.

자녀 보호에 의해 제거된 권한 테스트

자녀 보호를 사용하여 제거할 수 있는 권한(예: XPRIVILEGE_COMMUNICATIONS)으로 권한 로직을 테스트하려면 클라이언트 디바이스에 가족 계정을 설정합니다. 부모 또는 보호자는 가족 내 자녀의 권한을 제한하기 위해 이 장치를 사용할 수 있습니다.

사용자가 자신의 계정에 대한 권한을 제한할 수도 있습니다. 이 방법을 사용하여 사용자의 권한을 제한해야 하는 시나리오를 테스트하는 것이 좋습니다.

참고 항목

파트너 센터는 현재 테스트 계정 제품군을 만드는 방법을 제공하지 않습니다.

확인할 권한 ID

사용자 타이틀은 다음 권한 ID를 확인해야 합니다. 자세한 내용은 XR-045: Xbox 서비스 및 계정 권한을 참조하세요.

권한 ID	권한 이름	열거형 상수	설명
254	`XPRIVILEGE_MULTIPLAYER_SESSIONS`	`XUserPrivilege::Multiplayer`	이 권한이 있으면 사용자는 게임의 멀티 플레이어 세션에 참가할 수 있습니다.
185	`XPRIVILEGE_CROSS_PLAY`	`XUserPrivilege::CrossPlay`	사용자는 Xbox 서비스에 로그인하지 않은 다른 실제 사용자와 게임 플레이 세션에 참여할 수 있습니다. 예제 시나리오에는 동일한 세션에서 동기식 사용자 대 사용자 게임 플레이, 비동기식 턴 기반 게임 플레이, 팀 기반 게임 플레이, 사용자 시작 매치 메이킹, 초대 보내기 또는 수락, 참여 세션이 포함됩니다.
252	`XPRIVILEGE_COMMUNICATIONS`	`XUserPrivilege::Communications`	이 권한이 있으면 사용자는 모든 사용자를 상대로 음성 채팅이나 문자 메시지 전달을 사용할 수 있습니다. 추가 개인 정보 권한 확인을 통해 사용자가 통신할 수 있는 상대를 결정해야 합니다.
189	`XPRIVILEGE_SESSIONS`	`XUserPrivilege::Sessions`	사용자는 공유 환경에서 연결된 단일 플레이어 체험에 참여할 수 있습니다. 이러한 경험에는 권한 252(`XPRIVILEGE_COMMUNICATIONS`) 또는 254(`XPRIVILEGE_MULTIPLAYER_SESSIONS`)에 해당하는 기능이 있을 수 없습니다. 이 권한의 사용은 플랫폼 승인이 필요한 타이틀 기능입니다.
247	`XPRIVILEGE_USER_CREATED_CONTENT`	`XUserPrivilege::UserGeneratedContent`	사용자는 이 권한이 있을 때 온라인 사용자 작성 콘텐츠를 다운로드하고 볼 수 있습니다.
220	`XPRIVILEGE_SOCIAL_NETWORK_SHARING`	`XUserPrivilege::SocialNetworkSharing`	사용자는 이 권한이 있을 때 소셜 네트워크에서 진행률 정보를 공유할 수 있습니다.

사용 가능한 권한에 대한 자세한 내용은 XUserPrivilege를 참조하세요.

권한 계산 논리

권한은 콘솔이나 다른 장치에 동시에 로그인된 각 사용자에 대해 독립적으로 계산됩니다. 권한은 사용자, 장치, 현재 실행 중인 타이틀 및 플랫폼의 유효한 사용자 권리에서 추가됩니다. 그런 다음 자녀 보호, Xbox 서비스 정책 및 시행 상태, 각 사용자의 게스트 상태에 따라 각 사용자에 대한 권한이 제거됩니다.

유효한 권리는 사용자가 구매했거나, 동시에 로그인한 다른 사용자가 구매했거나, 장치에 바로 연결된 구독의 결과로 제공될 수 있습니다. “무료 멀티 플레이어 주말” 이벤트와 같은 판촉 행사의 결과로 유효한 권리가 제공되기도 합니다.

디바이스 유형에서 발생하는 권한 권리

특정 유형의 장치(예: Xbox One 패밀리 콘솔 및 Xbox 시리즈 콘솔, Windows PC 또는 모바일)는 플랫폼에서 Xbox 서비스에 연결하는 모든 사용자에게 권한 컬렉션을 자동으로 부여합니다.

구독으로 발생하는 유효한 권한 권리

구독 제품은 적용 가능한 사용자에게 권한 컬렉션을 제공할 수 있습니다. 다음 시나리오는 사용자에게 효과적으로 구독 기반 권한을 부여하는 방법입니다.

사용자가 구독 제품을 구매했습니다.
동일한 장치에 있는 다른 활성 사용자가 구독 제품을 구입했습니다.
구독 제품은 사용자가 현재 사용 중인 장치와 연결되어 있습니다.

Xbox One부터 Xbox Live Gold 구독이 이 논리를 따릅니다. Xbox Live Gold 구독을 디바이스에 연결할 수 있으며 디바이스의 모든 사용자는 Xbox Live Gold 구독 계층에 연결된 권한을 효과적으로 누릴 수 있습니다. Xbox Live Gold 구독을 구입한 사용자와 장치에서 동시에 활성화된 후원 게스트를 포함한 모든 사용자는 Xbox Live Gold 구독과 관련된 권한을 효과적으로 누릴 수 있습니다.

파트너 구독을 사용하여 활성 사용자에게 권한을 발급할 수도 있습니다. 또한 파트너 구독과 관련된 권한은 특정 참여 타이틀이 실행 중일 때만 발급될 수 있습니다.

판촉 권리

판촉 권리는 특정한 동적 조건을 충족하는 사용자에게 제한된 기간에 권한을 추가합니다. 예를 들어 판촉 행사가 주말 동안 특정 사용자에게 멀티 플레이어 권한을 제공하기도 합니다. “무료 Xbox Live Gold 주말”과 같은 기존 판촉은 판촉 권리의 모델을 따릅니다.

참고 항목

서비스 및 타이틀에서 이러한 프로모션을 직접 인식할 필요는 없습니다. 판촉 권리의 권한은 XSTS(Xbox Security Token Service) 토큰이 서비스에 연결된 사용자에게 발급될 때 동적으로 계산됩니다.

후원 게스트 계정에 대해 제거된 권한

후원 게스트는 Xbox 서비스에 로그인한 게스트 계정입니다. 후원 게스트는 한 명의 사용자만 로그인한 분할 화면 멀티 플레이어 게임처럼 클라이언트 장치에 하나 이상의 다른 활성 사용자가 있는 경우에만 존재합니다. 이 계정은 인증된 사용자이며, 다른 인증된 사용자와 같은 토큰을 받습니다. 후원 게스트는 여러 권한을 가지고 있지만, 일부 권한은 후원 게스트의 유효한 권리나 현재 실행 중인 앱과 관계없이 게스트 사용자에게 부여되지 않습니다.

후원 게스트에 대한 권한을 확인하려면 XUserCheckPrivilege에 문의하세요. 이 작업은 해결을 시도하지 않습니다. 후원 게스트는 "해결"되지 않으므로 해상도 UI를 표시할 필요가 없으며 XUserResolvePrivilegeWithUiAsync에 전화할 필요도 없습니다. 활성 Xbox 계정과 달리 후원 게스트는 구매를 하거나, 적용 작업을 수행하거나, 또는 다른 고유한 권한 또는 제한 집합을 가질 수 있는 경로가 없습니다.

현재 로그인한 사용자가 없는 경우(즉, “순수 게스트”로 구성된 경우)에는 사용자에게 토큰이 발급되지 않습니다. 따라서 디바이스에 있는 어떤 사용자에 대해서도 유효한 권한이 컴퓨팅되지 않습니다.

XR-045를 사용하려면 타이틀에서 XPRIVILEGE_SOCIAL_NETWORK_SHARING 또는 XUserPrivilege::SocialNetworkSharing을(를) 사용하여 202 권한을 확인해야 합니다. 이 권한은 게스트에 대해 제거되는 권한 중 하나입니다.

온라인 안전 및 Microsoft 적용

Xbox 서비스 정책 및 시행 중재자는 악의적인 사용자 또는 장치에서 권한을 제거할 수 있습니다.

자녀 보호

부모는 자녀의 구독 또는 현재 실행 중인 타이틀에 관계없이 가족 내 하위 계정에서 권한을 제거할 수 있습니다. 이 기능은 Xbox One, Xbox 360 또는 Xbox.com 클라이언트를 사용하여 제어합니다.

Xbox Live Gold 구독자에 대한 권한

특정 구독의 권한 권리에 관한 정책은 동적이며 시간이 지나면 변경됩니다. 구독자에게 권한이 있더라도 자녀 보호 변경 또는 적용 정책으로 인해 해당 구독자는 해당 권한을 잃을 수 있습니다.

참고 항목

권한은 사용자의 현재 구독을 정확하게 반영하지 않습니다.

XR-045를 사용하려면 타이틀에서 XPRIVILEGE_MULTIPLAYER_SESSIONS 또는 XUserPrivilege::Multiplayer을(를) 사용하여 254 권한을 확인해야 합니다. Xbox Live Gold 구독자가 사용할 수 있는 권한 중 하나입니다.

파트너 구독 및 권한

Xbox 서비스 권한 컬렉션을 제공하도록 파트너 구독을 구성할 수 있습니다. 파트너 구독은 사용자가 구독에 명시적으로 연결된 앱에 로그인했을 때 사용자의 권한을 계산하는 데만 사용합니다.

파트너 구독을 설정하려면 Microsoft 계정 관리자에게 문의하세요.

파트너 구독은 릴리스되기 전에 개발 샌드박스에서 테스트할 수 있습니다. 개발 샌드박스를 사용할 수 있는 권한이 있는 사용자와 장치만 이 구독을 구입할 수 있습니다.

무료 플레이(F2P) 타이틀 및 멀티플레이어 권한

무료 플레이(F2P) 모델에서 작동하도록 특별히 구성된 타이틀의 경우 평소와 같이 XPRIVILEGE_MULTIPLAYER_SESSIONS / XUserPrivilege::Multiplayer 권한을 확인해야 합니다. 그러나 이 설정을 사용하면 사용자는 Xbox Live Gold 구독 여부에 관계없이 멀티플레이어 권한을 갖게 됩니다. 이 권한은 사용자가 금지/차단되거나 어떤 식으로든 연령 제한이 있는 경우에만 거부됩니다. 이 권한의 사용은 플랫폼 승인이 필요한 타이틀 기능입니다. 귀하의 타이틀에 대해 이 기능을 활성화하려면 Microsoft 관리자 또는 DPM과 협력하세요.

하이브리드 타이틀 및 멀티플레이어 권한

하이브리드 모델에서 작동하도록 특별히 구성된 타이틀, 즉 유료 구독이 필요한 멀티플레이어 시나리오가 포함되어 있지만 무료로 재생할 수 있는 시나리오가 포함된 타이틀의 경우 권한 확인 프로세스가 약간 다릅니다.

유료 구독이 필요한 콘텐츠의 경우 XPRIVILEGE_MULTIPLAYER_SESSIONS / XUserPrivilege::Multiplayer 권한을 확인해야 합니다. 그러나 무료 멀티플레이어 시나리오의 경우 XPRIVILEGE_SESSIONS / XUserPrivilege::Sessions 권한을 대신 확인해야 합니다. 이 권한은 사용자가 금지/차단되거나 어떤 식으로든 연령 제한이 있는 경우에만 거부됩니다. 멀티플레이어 권한도 이러한 이유로 거부되지만 유료 구독이 부여되어야 합니다. 이 권한의 사용은 플랫폼 승인이 필요한 타이틀 기능입니다. 귀하의 타이틀에 대해 이 기능을 활성화하려면 Microsoft 관리자 또는 DPM과 협력하세요.

참고 항목

정책 및 Xbox 요구 사항

XUserCheckPrivilege

XUserPrivilege

XUserPrivilegeDenyReason

XUserPrivilegeOptions

다음을 통해 공유

Xbox 서비스 사용자 권한의 클라이언트 측 사용

목차

필수 구성 요소

권한 및 업셀 관련 사용자 환경 및 클라이언트 쪽 처리

예제 코드

앱 쪽 권한 처리 모범 사례

앱 내 권한 해결 빈도

사용자의 구독 계층은 가정하지 않습니다.

오프라인 모드

올바른 사용자 대상 지정

UI가 없거나 UI가 포커스를 벗어난 상태에서 확인

앱에서 권한 기반 액세스 제어 테스트

사용자 권한 및 권한 관리 및 확인

XUserCheckPrivilege로 확인된 권한

XUserPrivilege::CrossPlay

XUserPrivilege::Sessions

XUserPrivilege::Multiplayer

XUserPrivilege::UserGeneratedContent

XUserPrivilege::SocialNetworkSharing

XUserPrivilege::Communications

XblPrivacyCheckPermissionAsync로 확인된 권한

XblPermission::CommunicateUsingText

XblPermission::CommunicateUsingVoice

구독에서 제공하는 권한 테스트

실행 중인 타이틀에서 제공하는 권한 테스트

자녀 보호에 의해 제거된 권한 테스트

확인할 권한 ID

권한 계산 논리

디바이스 유형에서 발생하는 권한 권리

구독으로 발생하는 유효한 권한 권리

판촉 권리

후원 게스트 계정에 대해 제거된 권한

온라인 안전 및 Microsoft 적용

자녀 보호

Xbox Live Gold 구독자에 대한 권한

파트너 구독 및 권한

무료 플레이(F2P) 타이틀 및 멀티플레이어 권한

하이브리드 타이틀 및 멀티플레이어 권한

참고 항목

추가 리소스