⚠️이 글은 API 문서를 보면서 공부한 내용 정리한겁니다. ↓
https://kb.heathen.group/assets/steamworks/unity-engine/debugging-tools
디버깅 활성화 하는 방법
프로젝트에서 사용하고 계신 Steam Settings를 찾아준 뒤,
사진 처럼 Enable Debug Messages 버튼을 눌러주면 됩니다.
Heathen의 도구를 켜면 가장 흔한 오류 지점인 초기화와 관련된 자세한 정보가 추가로 작성됩니다.
테스트를 완료하지 않았고 출시 전 버전일 경우 이 기능을 켜야 합니다.
스팀웍스 인스펙터 Steamworks Inspector
Heathen에서 프로젝트에 대해 구성된 모든 Steam API Artifacts의 상태와 값을 볼 수 있습니다.
바로 검사기 UI 인스펙터 Steamworks Inspector에서 상태와 값을 제공합니다.
인스펙터를 볼려면 아까 위의 Steam Settings SO에서 Open Debug Window를 눌러주면 됩니다.
아니면 유니티 왼쪽 상단 Window> Steamworks Inspector 메뉴를 열기만 하면 됩니다.
★인스펙터의 데이터는 시뮬레이션이 실행되는 동안에만 채워집니다.
실행 모습 ↓
위의 사진처럼 인스펙터 Home에 보이는 각 항목을 살펴보자면
Initialization Status
이것은 Steam API의 상태를 나타내며 다음 값 중 하나를 가집니다.
● Idle
이는 API가 실행되지 않았거나 초기화를 시도하지 않았음을 의미합니다.
상태는 시뮬레이션이 실행되고 있지 않을 때마다 이렇게 표시됩니다.
즉, 이것이 전혀 작동하지 않으려면 Play를 눌러야 합니다.
● Initializing
이것은 API가 초기화를 시도하고 있음을 의미합니다.
이는 일반적으로 매우 빠르게 지나가기 때문에 못 볼 수도 있습니다.
● Initialized
이는 API가 초기화되었으며 보고된 값이 API에서 보고된 값임을 의미합니다.
● Error or Failed
이는 API 초기화에 실패했음을 의미합니다.
이유에 대한 자세한 내용은 Unity 에디터 콘솔 로그를 확인하세요.
Listed App ID
활성 Steam 설정 개체에 나타나는 앱 ID입니다. 나열된 다른 ID와 일치해야 합니다.
Reported App ID
이것은 Steam API가 요청했을 때 우리에게 다시 보고한 앱 ID입니다.
Steam가 알고 싶은건 이 앱 ID가 당신 본인이 맞는지입니다.
Steam_AppId.txt
이것은 현재 steam_appid.txt 파일에 기록된 앱 ID입니다.
이번엔 두번 째 탭인 Stats 탭을 봅시다.
Inspecting Stats
통계 탭을 사용하여 등록된 모든 통계의 값을 보고 Set 버튼으로 값을 업데이트할 수 있습니다.
세번째 탭인 Achievements 탭
Inspecting Achievements
업적 탭을 사용하여 등록된 모든 업적을 보고 잠금 해제/초기화할 수 있습니다.
Reset하면 Unlocked된 업적이 다시 False 상태가 됩니다.
네번째 탭인 Leaderboards 탭
Inspecting Leaderboards
순위표의 탭을 사용하여 등록된 모든 순위표에서 점수와 순위를 볼 수 있습니다.
순위표는 Steam API의 가장 단순한 부분이지만 더 문제 발생하기 쉬운 부분 중 하나이기도 합니다.
가장 흔한 문제 예시 ↓
1. 정렬 순서가 잘못 설정되었습니다.
2. 리더보드를 "신뢰할 수 있는 것만"으로 설정했습니다.
3. Steam 개발자 포털에서 변경하고 게시하지 않았습니다.
때때로 순위표가 "중단"되는 것을 볼 수 있습니다.
일반적으로 보드의 값을 변경하거나 삭제 하는 경우,
이름은 같지만 설정이 다른 새 보드를 만들 때 발생하는 문제입니다.
대부분의 경우 새 고유 API 이름으로 새 보드를 만드는 것이 가장 쉽고 좋습니다.
오작동하는 보드를 수리해야 하는 경우에는,
Heathen이 볼 수 없고 영향을 미칠 수 없는 백엔드 기능이므로 Valve 지원팀에 문의해야 합니다.
다섯 번째 탭인 Leaderboardstext-align: start;"> 탭
Inspecting Downloadable Content
text-align: start;">위 사진에선 App Id가 너무 길어서 잘린 모습. text-align: start;">
text-align: start;">DLC 탭에서 모든 DLC의 구독 상태를 볼 수 있습니다.
여섯 번째 탭인 Inspecting Inventory 탭
인벤토리 탭에는 게임에 등록된 모든 아이템이 표시되며 각 아이템을 지우고 부여할 수 있습니다.
일곱 번 째 Inspecting Lobbies 탭
로비 탭은 감지된 각 로비에 대한 하위 페이지를 채우고 구성원 목록과 로비의 MetaData를 표시합니다.
'스팀웍스SteamWorks > Heathen API' 카테고리의 다른 글
| 스팀 인벤토리 구조 Steam Inventory Schema (0) | 2023.06.07 |
|---|---|
| 유니티 Heathen api로 스팀웍스 스탯 및 업적 구현 Unity Heathen api SteamWorks Stats and Achievements (0) | 2023.06.01 |
| Heathen API Steamworks Behaviour 스팀웍스 Behaviour (0) | 2023.05.16 |
| Heathen API 게임 오브젝트 초기화 GameObject Initialization (0) | 2023.05.16 |