연령 신호 개요

Windows Age API는 앱이 로그인한 사용자의 연령 그룹 및 성인 확인 상태를 이해하는 데 사용할 수 있는 개인 정보 보호 신호를 제공합니다. API는 사용자의 정확한 연령이나 생년월일 대신 거친 신호를 반환합니다. 앱은 이러한 신호를 사용하여 콘텐츠, 기능 또는 액세스 제어를 조정할 수 있으며 신호를 사용할 수 없는 경우 적절한 대체 동작을 제공해야 합니다.

연령 신호란?

연령 신호는 앱이 현재 사용자의 Age API를 호출할 때 Windows 반환하는 값입니다. 앱은 적절한 최종 사용자 경험을 제공하기 위해 사용자의 연령 그룹 또는 성인 확인 상태를 요청할 시기를 결정합니다.

두 신호 모두 사용자의 정확한 연령이나 생년월일을 직접 노출하지 않습니다. API는 GetUserAgeRangeAsync 앱이 콘텐츠 관련 결정을 내리는 데 사용할 수 있는 연령 범위를 제공합니다. 다음과 같은 연령 그룹이 있습니다:

  • 10세 미만
  • 10-12
  • 13-15
  • 16-17
  • 18+

Windows Age API들

GetUserAgeRangeAsync

이 GetUserAgeRangeAsync 메서드는 사용자의 연령 범위를 UserAgeRange 및 Upper 속성이 있는 Lower 개체로 반환합니다.

연령 그룹 반환 값
10세 미만 {0, 9}
10-12 {10, 12}
13-15 {13, 15}
16-17 {16, 17}
18+ {18, INT32_MAX}
알 수 없음 null

결과가 null이면 연령대는 알 수 없거나 확인할 수 없습니다. 앱은 대체 환경을 사용해야 하며 특정 연령 그룹으로 해석 null 해서는 안 됩니다.

GetAgeVerificationStatusAsync

GetAgeVerificationStatusAsync 메서드는 사용자에 대해 보고된 성인 확인 상태를 나타내는 UserAgeVerificationStatus 값을 반환합니다. 연령 확인은 성인이라고 주장하는 사용자가 성인인지 여부를 확인합니다. 검증된 연령을 확인하거나 다른 연령대를 확인하지 않습니다.

가능한 값은 다음과 같습니다.

  • Verified: 사용자의 성인 여부가 확인되었습니다.
  • Unverified: 사용자에게 성인 인증이 되지 않았습니다. 이것이 사용자가 미성년자임을 입증하지는 않습니다.
  • OptedOut: 사용자가 성인 인증을 거부했습니다.
  • TemporarilyUnavailable: 현재 상태를 확인할 수 없습니다.
  • NotApplicable: 확인이 적용되지 않거나, 확인 신호를 사용할 수 없거나, 기능을 사용할 수 없거나 사용하지 않도록 설정합니다.

앱은 모든 값을 처리해야 합니다. NotApplicable 및 TemporarilyUnavailable은 사용자가 성인 상태를 확인했는지 여부를 판단하지 않습니다. 18세 이상의 연령 범위 결과는 그 자체로 성인 인증 상태를 설정하지 않습니다.

앱 패키지는 userAccountInformation 기능을 선언해야 합니다. 연령 신호에 대한 액세스는 앱이 Windows 개인 정보 설정의 계정 정보에 액세스하도록 허용하는 사용자의 동의를 받습니다. 액세스 권한이 부여되지 않으면 호출이 실패 E_ACCESSDENIED할 수 있습니다. 개체는 User 현재 프로세스를 실행하는 사용자를 나타내야 합니다.

정책 및 가용성

Age API를 사용할 수 없거나 비활성화된 경우 GetUserAgeRangeAsync는 null를 반환하고 GetAgeVerificationStatusAsync는 NotApplicable를 반환합니다. 관리자는 그룹 정책 또는 MDM을 통해 기본 연령 그룹 또는 확인 상태를 구성할 수도 있습니다. 구성되면 API는 해당 정책 정의 값을 반환합니다. 앱은 메서드를 호출하기 전에 메서드를 사용할 수 있는지 확인하고 사용할 수 없는 신호에 대한 대체 동작을 유지해야 합니다.

정책 정의 Verified 값은 사용자가 성인 확인 흐름을 완료했다는 증거가 아니라 관리 기본값입니다.

ID 공급자 연령 신호는 현재 Microsoft 계정에 대해서만 검색됩니다. 다른 계정 유형의 경우 관리자 기본값이 설정되지 않으면 GetUserAgeRangeAsync는 null을 반환하고 GetAgeVerificationStatusAsync는 NotApplicable을 반환합니다.

연령 신호를 사용하는 경우

앱이 다음에 해당하는 경우 연령 신호를 사용하세요:

  • 모든 연령대에 적합하지 않을 수 있는 사용자 생성 콘텐츠, 소셜 기능 또는 통신 도구를 표시합니다.
  • 연령 제한이 관련된 앱 내 구매 또는 가상 통화를 제공합니다.
  • 연령 등급이 있는 미디어 콘텐츠를 스트리밍하거나 재생합니다.

연령 신호가 높은 수준에서 작동하는 방식

구성 설정과 통신하는 디지털 안전 API 로컬 서비스와 연령 그룹 정보를 교환하는 앱을 보여 주는 다이어그램

개인 정보 및 데이터 처리

연령 신호는 다음의 핵심 원칙으로 개인 정보 보호로 설계되었습니다.

  • 정확한 연령이나 생년월일은 반환되지 않습니다. API는 연령 버킷 및 성인 확인 상태를 반환합니다. 성인 확인은 확인된 연령 또는 확인된 미성년자 연령 그룹을 입증하지 않습니다.
  • 연령 그룹은 일반적입니다. 그들은 게임이나 지역 법과 같은 다양한 사용 사례에 대한 공통 연령 그룹을 의사 소통합니다.

플랫폼 요구 사항

요구 사항 세부 정보
최소 OS 버전 윈도우 11
API 표면 Windows.System.User의 Windows 런타임 메서드
사용자 컨텍스트 호출은 현재 프로세스를 실행하는 사용자에게만 적용됩니다.
앱 기능 앱 패키지가 선언해야 합니다. userAccountInformation

참고하십시오