Aghanim-PlayFab 통합

이 안내서는 Aghanim을 PlayFab과 통합하여 PlayFab의 서버 API를 통해 자동 플레이어 검증과 인벤토리 관리를 할 수 있도록 설명합니다.

요구 사항

PlayFab 계정에 설정된 타이틀이 있어야 합니다.
PlayFab 타이틀의 타이틀 ID와 비밀 키에 접근할 수 있어야 합니다.
Aghanim 상점 항목에 맞는 PlayFab 카탈로그에서 항목이 구성되어 있어야 합니다.

1단계: PlayFab 자격 증명을 얻습니다

PlayFab Game Manager에 로그인합니다.
대시보드에서 타이틀을 선택합니다.
설정 → API 기능으로 이동하여 타이틀 ID를 복사합니다.

설정 → 비밀 키로 이동하여 비밀 키를 복사합니다(필요한 경우 새로 만듭니다).

2단계: PlayFab 카탈로그에서 항목을 구성합니다

PlayFab 카탈로그에 Aghanim 상점 항목에 해당하는 항목이 포함되어 있는지 확인합니다:

PlayFab 대시보드에서 Economy → Catalog로 이동합니다.
Aghanim 상점에서 SKU 값과 일치하는 Item ID가 있는 항목을 생성하거나 확인합니다.
필요에 따라 적절한 표시 이름, 설명 및 기타 항목 속성을 설정합니다.

3단계: Aghanim에서 통합 구성

Aghanim 대시보드로 이동 → Aghanim Connect → PlayFab.
필수 입력란을 채워주기:
- Title ID – 당신의 PlayFab 타이틀 ID
- Secret Key – 당신의 PlayFab 비밀 키
- 카탈로그 버전 (선택 사항) – 버전화된 카탈로그를 사용하는 경우 카탈로그 버전을 지정합니다
통합을 활성화하려면 설치 버튼을 클릭합니다.

설치가 완료되면, Aghanim 대시보드 내 웹훅 아래에 PlayFab API 엔드포인트가 자동으로 생성되어 플레이어 검증 및 인벤토리 관리 이벤트를 처리할 준비가 됩니다. 거기에서 요청 및 응답 로그를 자세히 살펴보고 PlayFab 통합이 어떻게 작동하는지 정확히 확인할 수 있습니다.

작동 원리

구성 후 PlayFab 통합은 다음 웹훅 이벤트를 자동으로 처리합니다:

플레이어 검증

플레이어 검증 웹훅 이벤트를 처리합니다.
플레이어 존재를 검증하기 위해 PlayFab의 GetPlayerProfile API를 호출합니다.
표시 이름과 아바타 URL을 포함한 플레이어 프로필 데이터를 반환합니다.
플레이어 인증 흐름 중에 플레이어를 검증하기 위해 사용됩니다.

아이템 추가

아이템 추가 웹훅 이벤트를 처리합니다.
플레이어 인벤토리에 아이템을 추가하기 위해 PlayFab의 GrantItemsToUsers Admin API를 호출합니다.
성공적인 구매 또는 수동 부여를 기반으로 아이템을 부여합니다.
향후 제거를 대비하여 부여된 아이템 인스턴스 ID를 저장합니다.

아이템 제거

아이템 제거 웹훅 이벤트를 처리합니다.
플레이어 인벤토리에서 아이템을 제거하기 위해 PlayFab의 RevokeInventoryItems 서버 API를 호출합니다.
Aghanim을 통해 이전에 부여된 아이템만 제거합니다.
원래 부여 작업에서 저장한 아이템 인스턴스 ID를 사용합니다.

중요한 메모

SKU 일치: Aghanim 스토어 아이템 SKU가 PlayFab 카탈로그 항목 ID와 정확히 일치하는지 확인합니다.
오류에 대한 재시도 없음: PlayFab 작업은 멱등성을 지원하지 않으므로 실패한 요청은 중복 작업을 방지하기 위해 자동으로 재시도되지 않습니다.

도움이 필요하세요?
통합팀에 문의하십시오 integration@aghanim.com