본문으로 건너뛰기

신뢰할 수 있는 성인 기본 설정

신뢰할 수 있는 성인은 자녀에 대한 동의 및 권한을 관리하는 방법에 대한 기본 설정을 구성할 수 있습니다. 이러한 기본 설정은 Family Connect에서 구성되며 동의 Challenge가 제시되고 처리되는 방식에 영향을 줍니다.

API와 함께 기본 설정 작동 방식​

신뢰할 수 있는 성인 기본 설정은 세션 객체의 일부이며 /session/get 엔드포인트를 통해 액세스할 수 있습니다. 기본 설정은 세션 응답 내의 allowances 배열에 저장됩니다.

세션에서 허용액 액세스​

/session/get를 사용하여 세션을 검색할 때 응답에는 해당 플레이어에 대해 구성된 신뢰할 수 있는 성인 기본 설정을 포함하는 allowances 배열이 포함됩니다. 각 허용액은 신뢰할 수 있는 성인이 구성한 기본 설정을 나타냅니다.

허용액이 있는 세션 응답 예시​

{
  "session": {
    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",
    "kuid": "12b9fa0e-6d6d-4903-a1fc-f2233027b71d",
    "ageStatus": "LEGAL_ADULT",
    "ageCategory": "adult",
    "etag": "e889efb9e8a985308e82bed78c5aef7f37f50cf36b7337bf654980d0bab7a574",
    "status": "ACTIVE",
    "dateOfBirth": "2005-04-15",
    "jurisdiction": "US-CA",
    "managedBy": "PLAYER",
    "permissions": [
      {
        "name": "text-chat-public",
        "enabled": false,
        "managedBy": "GUARDIAN"
      },
      {
        "name": "text-chat-private",
        "enabled": true,
        "managedBy": "PLAYER"
      },
      {
        "name": "forums",
        "enabled": false,
        "managedBy": "PROHIBITED"
      }
    ],
    "allowances": [
      {
        "name": "3516-7b2e",
        "numericalValue": 5,
        "type": "numerical"
      },
      {
        "name": "63d3-90ac",
        "selectionValue": "733c-ca11",
        "type": "selection"
      }
    ]
  },
  "status": "PASS"
}

허용액 구조​

allowances 배열의 각 허용액은 다음 구조를 가집니다:

필드유형설명
namestring허용액 기본 설정의 고유 식별자(Compliance Studio에서 구성됨)
typestring허용액 유형: "numerical" 또는 "selection"
numericalValuenumber숫자 값(type이 "numerical"인 경우에만 존재)
selectionValuestring선택된 값 식별자(type이 "selection"인 경우에만 존재)

허용액 유형​

숫자 허용액​

숫자 허용액은 숫자 값을 가진 기본 설정을 나타냅니다:

  • 최대 일일 플레이타임 시간
  • 최대 지출 한도
  • 시간 기반 제한

예시:

{
  "name": "3516-7b2e",
  "numericalValue": 5,
  "type": "numerical"
}

선택 허용액​

선택 허용액은 신뢰할 수 있는 성인이 미리 정의된 옵션 중에서 선택한 기본 설정을 나타냅니다:

  • 콘텐츠 등급 기본 설정
  • 통신 설정
  • 기능 액세스 수준

예시:

{
  "name": "63d3-90ac",
  "selectionValue": "733c-ca11",
  "type": "selection"
}

애플리케이션에서 허용액 사용​

허용액을 사용하여 신뢰할 수 있는 성인 기본 설정을 존중하는 게임 로직을 구현할 수 있습니다:

  1. 세션 검색: /session/get를 호출하여 허용액이 있는 현재 세션 가져오기
  2. 허용액 확인: 세션 응답에서 allowances 배열 찾기
  3. 각 허용액 처리: 허용액을 반복하고 기본 설정 값을 게임 로직에 적용
  4. 허용액 유형 처리: type 필드를 확인하여 numericalValue 또는 selectionValue를 사용할지 결정

구현 예시​

async function getPlayerAllowances(sessionId) {
  const response = await fetch(`/api/v1/session/get?sessionId=${sessionId}`, {
    headers: {
      'Authorization': `Bearer ${apiKey}`
    }
  });
  
  const data = await response.json();
  const allowances = data.session?.allowances || [];
  
  // 허용액 처리
  const preferences = {};
  allowances.forEach(allowance => {
    if (allowance.type === 'numerical') {
      preferences[allowance.name] = allowance.numericalValue;
    } else if (allowance.type === 'selection') {
      preferences[allowance.name] = allowance.selectionValue;
    }
  });
  
  return preferences;
}

허용액이 적용되는 경우​

허용액은 다음 경우에 세션에 자동으로 포함됩니다:

  • 동의 Challenge가 생성되고 승인될 때
  • 세션이 생성되거나 업데이트될 때
  • 권한이 업그레이드될 때

허용액은 신뢰할 수 있는 성인이 Family Connect에서 해당 플레이어에 대해 구성한 기본 설정을 반영합니다.

허용액 구성​

허용액은 Compliance Studio에서 구성되며 다음을 정의합니다:

  • 허용액 이름(식별자)
  • 허용액 유형(숫자 또는 선택)
  • 선택 유형 허용액에 대한 사용 가능한 옵션

신뢰할 수 있는 성인 기본 설정에 대한 자세한 내용(구성 방법 및 통합에 미치는 영향 포함)은 핵심 개념 섹션의 신뢰할 수 있는 성인 기본 설정을 참조하세요.