샘플과 참고 자료
만들고 싶은 기능이나 궁금한 내용에 맞는 데모, 샘플, 상세 자료를 찾습니다.
여기까지가 모험 게임 튜토리얼입니다. 아래에는 기능 구현이나 API 인수를 알아볼 때 쓸 수 있는 자료를 모았습니다. 개발 중 필요할 때 이 목록에서 찾아보세요.
예제 설정과 개념 다시 살펴보기
- 설정값 목록: 각 장에서 사용한 이름과 수치입니다. 7장부터 숲 탐험의 보상은 15코인입니다.
- 게임 데이터와 처리 흐름: 마스터 데이터와 사용자 데이터, Unity와 GS2의 역할을 살펴봅니다.
예제 코드와 템플릿
1장의 로그인 C# 코드와 Account 템플릿, 이후 각 장의 코드와 템플릿을 아래에서 다운로드할 수 있습니다. 이름이 같은 C# 파일은 각 장의 안내에 따라 교체합니다. 4장은 3장의 코드로 동작을 확인합니다.
만들고 싶은 기능 찾기
| 기능 | 튜토리얼 | 상세 자료 |
|---|---|---|
| 계정 생성과 로그인 | 1장 | Account API(새 탭) |
| 모험과 클리어 보상 | 3장 | Quest API(새 탭) |
| 코인 잔액 조회 | 3장 | Money2 API(새 탭) |
| 스태미나 소비 | 5장 | Stamina API(새 탭) |
| 코인으로 스태미나 회복 | 6장 | 트랜잭션 설정(새 탭) |
| 보상 변경과 모험 추가 | 7장 | 마스터 데이터 관리(새 탭) |
| 캐릭터 동기화 | 실시간 편 | 동기화 튜토리얼(새 탭) |
시작 시 통신 줄이기
화면에서 사용하는 데이터가 많아지면 로그인 후 LoadUserDataAsync로 플레이어 데이터를 한꺼번에 가져올 수 있습니다. 가져온 데이터는 SDK 캐시에 들어가 이후 데이터 조회에 사용됩니다.
await Gs2.LoadUserDataAsync(login);이 호출은 로그인 후 각 화면이 데이터 조회를 시작하기 전에 실행합니다. SDK 예제에서는 AdventureLogin.cs의 Gs2.LoginAsync(...)가 반환된 뒤 Session = login; 직전입니다. 이후 변경은 Handler나 SubscribeWithInitialCallAsync 구독을 통해 화면에 반영됩니다.
일괄 조회는 개별 조회에 필요한 통신을 줄이기 위한 기능입니다. 같은 플레이어로 이어서 플레이하기 위해 추가로 필요한 설정은 아닙니다. 자세한 내용은 GS2 공식 블로그 소개 글(일본어, 새 탭)을 참고하세요.
데모와 샘플 찾기
- 쇼룸(새 탭): 브라우저에서 GS2 기능을 체험합니다.
- 샘플 코드(새 탭): 게임 전체 구현 예제와 기능별 샘플을 찾습니다.
- UIKit 튜토리얼(새 탭): UIKit으로 Unity 화면을 만드는 방법을 배웁니다.
- GS2 Studio(새 탭): Studio 소개와 시작 방법을 확인합니다.
예상대로 동작하지 않을 때
문제 해결에 흔한 증상과 확인할 곳을 정리했습니다. 내 상황과 비슷한 항목부터 살펴보세요. API 인수와 오류는 위 표의 서비스별 레퍼런스에서 자세히 확인할 수 있습니다.