주요 콘텐츠로 건너뛰기

S3에서 리더보드 업데이트

Aghanim API 호출을 사용하는 대신 S3-호환 버킷에 게임 리더보드를 저장할 수 있습니다. Aghanim은 권장 스키마에 따라 파일을 업로드할 수 있는 지정된 버킷을 제공합니다.

파일 스키마

리더보드 파일은 다음과 같은 구조를 가져야 합니다:

Key유형설명
member_idstring게임 개발자가 지정한 고유한 리더보드 멤버 ID입니다.
member_datastring이름 등의 멤버 데이터입니다.
member_subdataOptional<string>클랜, 팀, 길드 등 소속된 멤버에 대한 추가 데이터입니다.
image_urlstring멤버 아바타 이미지 URL입니다.
scoreinteger다른 리더보드 멤버들 사이에서 멤버의 성과를 반영하는 숫자 값입니다.

예시:

[
  {
    "member_id": "12345",
    "member_data": "John Doe",
    "member_subdata": "Team Alpha",
    "image_url": "http://example.com/avatar1.png",
    "score": 1500
  },
  {
    "member_id": "67890",
    "member_data": "Jane Smith",
    "member_subdata": "Guild Beta",
    "image_url": "http://example.com/avatar2.png",
    "score": 1200
  }
]

파일 명명 규칙

파일을 체계적으로 정리하려면 아래와 같이 타임스탬프를 포함한 이름 규칙을 사용하세요. 이를 통해 리더보드 파일의 다양한 버전을 관리하는 데 도움이 됩니다.

<LEADERBOARD_ID>-<TIMESTAMP>.<EXTENSION>
  • <LEADERBOARD_ID>: Aghanim 시스템에서 리더보드를 생성할 때 얻은 고유한 리더보드 ID입니다.
  • <TIMESTAMP>: Unix epoch 시간으로 나타낸 파일 생성 날짜입니다.
  • <EXTENSION>: 파일 확장자 (예: csv, json, zip, gz).

예시 파일 이름:

  • CSV: lbrd_eAQiRnTwFaa-1626073200.csv
  • JSON: lbrd_eAQiRnTwFaa-1626073200.json
  • ZIP: lbrd_eAQiRnTwFaa-1626073200.zip
  • GZIP: lbrd_eAQiRnTwFaa-1626073200.gz

파일 업로드

지원되는 파일 유형:

  • Raw CSV 또는 JSON 파일
  • CSV 또는 JSON 파일을 포함하는 압축 파일 (ZIP) 또는 gzipped (GZIP) 파일

버킷에 파일을 업로드하려면:

  1. 게임 허브 -> 리더보드 UI 섹션에서 리더보드를 생성하거나 리더보드 API 호출 만들기를 사용합니다.
  2. 1단계에서 반환된 ID를 리더보드 ID로 사용하여 위의 요구 사항에 따라 리더보드 파일을 준비합니다.
  3. (선택 사항) ZIP 또는 GZIP 형식을 사용하는 경우, 파일을 압축합니다.
  4. 준비된 파일을 Aghanim이 제공한 버킷에 업로드합니다.

데이터 가져오기 빈도

리더보드 서비스는 업로드된 파일을 기반으로 자동으로 리더보드 멤버를 업데이트합니다. 데이터 가져오기 빈도는 게임 개발자가 결정하며 시간별, 일별, 주별 또는 월별로 설정할 수 있습니다.

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

On this page