'도전과제'에 해당되는 글 1건

원문: https://partner.steamgames.com/doc/features/achievements

통계 및 업적(Stats and Achievements)

업적은 게임 플레이어에게 높은 가치의 보상을 제공하는 것 외에도 팀워크와 플레이어 상호 작용을 장려하고 보상하며, 게임 목표에 추가적인 차원을 부여하고, 게임에서 더 많은 시간을 보낸 사용자에게 보상을 제공하는 데 유용합니다.

통계는 플레이 시간, 파워업 사용 횟수 등과 같은 세분화된 정보를 추적합니다. 예를 들어, 여러 대의 컴퓨터에서 수집한 여러 세션의 게임 플레이 통계를 기반으로 업적을 부여하는 등 단순히 게임 내부 데이터를 추적하는 데 사용할 수도 있습니다.

도전 과제는 애플리케이션에 따라 다르며 Steamworks 파트너 사이트의 앱 관리자 페이지에서 설정할 수 있습니다.

게임에서 저장할 수 있는 통계에는 세 가지 유형이 있습니다:

Steamworks 파트너 웹사이트는 게임의 통계와 업적을 정의하고 업데이트할 수 있는 인터페이스를 제공합니다. 이를 사용하면 다음과 같이 할 수 있습니다:

통계에는 다음과 같은 속성이 있습니다:

AVGRATE 통계에는 다음과 같은 추가 속성이 있습니다:

• Window - 데이터를 평균화하는 데 사용되는 '슬라이딩 창'의 크기입니다.

AVGRATE 통계는 Steam에서 자동으로 평균을 내는 통계입니다. 자세한 내용은 아래 AVGRATE 섹션을 참조하세요.

업적에는 다음과 같은 속성이 있습니다:

• ID - 각 업적에 대해 자동으로 생성된 숫자 ID입니다.
• API Name - API를 사용하여 이 업적에 액세스하는 데 사용되는 문자열입니다.
• Progress Stat - 커뮤니티에서 이 업적의 진행률 표시줄로 사용되는 스탯을 지정합니다. 스탯이 잠금 해제 값에 도달하면 업적도 자동으로 잠금 해제됩니다.
• Display Name - 이 업적의 이름은 클라이언트 알림 팝업과 커뮤니티에서 확인할 수 있습니다. 현지화될 수 있습니다.
• Description - 커뮤니티에 표시하기 위한 이 업적에 대한 설명입니다. 현지화될 수 있습니다.
• Set By - 업적을 잠금 해제할 수 있는 사용자를 설정합니다. 기본값은 클라이언트입니다. 자세한 내용은 게임 서버 통계(Game Server Stats)를 참조하세요.
• Hidden? - True라면, '숨겨진' 업적은 사용자가 달성할 때까지 사용자의 커뮤니티 페이지에 전혀 표시되지 않습니다.
• Achieved Icon - 달성 시 표시되는 아이콘입니다.
• Unachieved Icon - 아직 달성하지 못한 경우 표시되는 아이콘입니다.

다음은 Steamworks API 예제 애플리케이션(SpaceWar)의 업적 목록입니다:

특별 고려 사항

• 업적 이름과 아이콘은 모든 연령대에 적합한 것이어야 합니다.
• 기본적으로 게임은 처음에는 100개의 도전 과제로 제한됩니다. 앱이 프로필 기능(Profile Features)의 임계값에 도달하면 업적을 더 추가할 수 있습니다.

사용 방법

게임 내에서 통계 및 도전 과제에 액세스하기:

• Steamworks API를 초기화한 후에는 ISteamUserStats에 포함된 통계 및 업적 API를 사용할 수 있습니다.
• 게임 세션이 시작될 때 ISteamUserStats::RequestCurrentStats를 호출하여 Steam 백엔드에서 사용자의 통계 및 도전 과제 데이터를 가져옵니다. 데이터가 준비되면 ISteamUserStats::UserStatsReceived_t 콜백을 받게 됩니다.
• ISteamUserStats::GetStat 및 ISteamUserStats::GetAchievement를 사용하여 데이터를 반복하고 게임 상태를 초기화합니다.
• 게임에서 도전 과제를 표시하려면 ISteamUserStats::GetAchievementDisplayAttribute를 사용하여 이름("이름")과 설명("설명")을 포함하여 사람이 읽을 수 있는 도전 과제의 속성을 검색할 수 있습니다. 이러한 속성은 Steamworks 파트너 웹사이트에서 현지화할 수 있으며, 반환되는 데이터는 사용자가 게임을 실행하는 언어에 따라 달라집니다. 또한 ISteamUserStats::GetAchievementIcon을 사용하여 업적의 아이콘을 가져오거나 ISteamUserStats::GetAchievementAndUnlockTime을 사용하여 각 업적이 잠금 해제된 시간을 가져올 수도 있습니다.
• 통계가 변경될 때마다, 특히 변경 사항이 사용자에게 표시되기 전에 ISteamUserStats::SetStat 또는 ISteamUserStats::UpdateAvgRateStat를 호출하세요. 이러한 호출은 Steam의 인메모리 상태만 수정하며 매우 저렴합니다. 이렇게 하면 게임 충돌이 발생하더라도 Steam이 세션 간의 변경 사항을 유지할 수 있습니다.
• 게임 내 적절한 지점(예: 체크포인트, 레벨 전환)에서 ISteamUserStats::StoreStats를 호출하여 변경 사항을 업로드합니다. 업로드가 완료되면 ISteamUserStats::UserStatsStored_t 콜백을 받게 됩니다.
• 진행률 표시줄이 있는 업적의 경우 중요한 지점에서 ISteamUserStats::IndicateAchievementProgress를 사용하여 진행률이 표시된 팝업을 표시하세요. 예를 들어 20승이 필요한 경우 10승이 되었을 때 이를 호출하여 사용자가 절반을 달성했음을 표시할 수 있습니다.
• 하나 이상의 도전 과제가 잠금 해제될 때마다 잠금 해제된 각 도전 과제에 대해 ISteamUserStats::SetAchievement를 호출한 다음 ISteamUserStats::StoreStats를 호출하여 즉시 업로드합니다. 게임에는 잠금 해제된 각 도전 과제에 대해 ISteamUserStats::UserStatsStored_t 콜백이 하나씩 표시되고, ISteamUserStats::UserAchievementStored_t 콜백이 하나 더 표시됩니다. Steam 게임 오버레이는 사용자에게 알림 패널을 표시합니다.

AVGRATE 통계 유형

이 유형의 통계는 독특하고 매우 유용한 기능을 제공하지만 설명하려면 조금 더 자세한 설명이 필요합니다.

"시간당 획득한 포인트"와 같은 평균 통계를 추적하고자 하는 경우를 생각해 보겠습니다. 한 가지 접근 방식은 두 개의 통계, 즉 INT "총 포인트"와 FLOAT "총 플레이 시간 시간"을 가진 다음 포인트를 시간으로 나누어 시간당 포인트를 구하는 것입니다.

이 구현의 단점은 플레이어가 상당한 양의 플레이 시간을 누적하면 계산된 평균이 매우 느리게 변한다는 것입니다. 실제로 사용자가 게임을 더 많이 플레이할수록 평균의 반응성이 떨어집니다. 사용자가 100시간 동안 게임을 플레이했다면, 계산된 평균은 그 중 약 50시간 정도 "지연"됩니다. 스킬이 증가해도 시간당 포인트가 기대만큼 증가하지 않습니다.

평균 통계 유형을 사용하면 평균에 "슬라이딩 윈도우" 효과를 구현할 수 있습니다. 예를 들어, 이전 몇 시간의 게임 플레이만 활용할 수 있으므로 통계에 플레이어의 현재 스킬 레벨이 더 정확하게 반영됩니다.

이전 20시간의 게임 플레이만 값에 영향을 미치는 "시간당 포인트"를 구현하기 위해 AVGRATE 통계를 설정해 보겠습니다. 이렇게 하려면 다음과 같이 하세요:

• 평균은 "시간당"이므로 이 통계와 관련된 모든 시간 매개변수의 시간 단위는 "시간"이 됩니다. 이는 통계 자체의 Window 프로퍼티와 아래의 UpdateAvgRateStat에 전달된 "dSessionLength" 파라미터에도 적용됩니다.
• "AvgPointsPerHour"라는 AVGRATE 통계와 20.0의 Window 속성을 만듭니다(이 값은 "시간" 단위임을 기억하세요).
• 게임 중 적절한 시점에 다음 매개변수를 사용하여 ISteamUserStats::UpdateAvgRateStat를 호출합니다:
  
  • pchName - "AvgPointsPerHour"
  • flCountThisSession - UpdateAvgRateStat를 마지막으로 호출한 이후 플레이어가 획득한 포인트 수입니다.
  • dSessionLength - UpdateAvgRateStat를 마지막으로 호출한 이후의 게임 시간입니다. 단위는 통계의 창 프로퍼티에 있는 단위와 동일해야 합니다. 이 경우 "시간"입니다.
• 예를 들어, 플레이어가 0.225시간(13.5분) 동안 지속된 마지막 라운드에서 77점을 획득했다면, SteamUserStats()->UpdateAvgRateStat( "AvgPointsPerHour", 77, 0.225 )가 됩니다.

위의 예에서 Steam은 현재 라운드 평균 점수인 시간당 342.2점(77을 0.225로 나눈 값)을 이전 값과 혼합합니다. 결과는 플레이어의 지난 20시간 게임 시간 동안의 총 평균을 반영합니다. 현재 사용자에 대한 스탯이 처음 업데이트된 경우 현재 값은 342.2가 됩니다.

이 예에서는 시간 단위로 '시간'을 사용했지만 원하는 시간 단위를 사용할 수 있습니다. 다만 "dSessionLength" 및 Window 프로퍼티의 기본 단위로 해당 단위를 일관되게 사용해야 한다는 점만 기억하세요.

Steam은 통계 및 업적 데이터의 로컬 캐시를 유지하여 오프라인 모드에서도 API를 정상적으로 사용할 수 있도록 합니다. 커밋할 수 없는 통계는 사용자가 다음에 온라인 상태가 될 때를 위해 저장됩니다. 두 대 이상의 컴퓨터에서 수정이 이루어진 경우, Steam은 자동으로 업적을 병합하고 더 많이 진행된 통계 세트를 선택합니다. Steam은 통계 데이터의 로컬 캐시를 보관하므로 게임에서 디스크에 데이터의 로컬 캐시를 보관할 필요는 없습니다. 이러한 캐시가 충돌하는 경우가 종종 발생하며, 충돌이 발생하면 사용자에게는 진행 상황이 되돌아간 것처럼 보이므로 매우 불쾌한 경험이 될 수 있습니다.

각 업적은 Steamworks 제어판에 설정된 대로 해당 아이콘과 이름 및 설명이 표시됩니다. 업적 이름과 설명이 사용자가 선택한 언어로 현지화된 경우 해당 언어로 표시됩니다.

또한 이 페이지와 게임의 기본 Steam 페이지에서 게임의 글로벌 업적 통계로 연결되는 링크가 있습니다. 여기에는 가장 일반적인 업적부터 가장 희귀한 업적까지 순서대로 각 업적을 달성한 Steam 플레이어의 비율이 표시됩니다. 이 정보는 플레이어가 재미있게 볼 수 있을 뿐만 아니라 개발자에게도 유용한 자료가 됩니다: 특별 업적이 충분히 어려운가요? 아니면 너무 어려운가요? (이 정보는 판매 및 활성화 보고서 사이트에서도 확인할 수 있습니다).