목차
- 개요 및 개발 환경
- 토큰 키 발급 및 클럽 플레이어 정보 불러오기
- 플레이어 전투 기록 불러오기(현재 글)
Battle API 문서 확인
/players/{playerTag}/battlelog를 통해 플레이어 전투 정보를 불러올 수 있으며, 플레이어 태그를 입력하면 요청 URL과 응답 결과를 확인할 수 있다.
Player BattleLog json 요소
주로 사용되는 BattleLog json의 items 배열 내 요소들을 정리해보았다. 브롤스타즈의 전투 API의 경우 3vs3 매치와 쇼다운 매치에 따라 다르다.
- battleTime : 전투 시작 시간
- event : 전투 맵 정보(맵 ID, 게임 모드, 맵 이름)
- battle : 전투 정보
- mode : 게임 모드
- type : 전투 유형("ranked", "friendly", "soloRanked", "teamRanked", "challenge", "championshipChallenge")
- result
(3vs3 매치): 전투 결과("victory", "draw", "defeat") - duration
(3vs3 매치): 전투 지속 시간 - starPlayer
(3vs3 매치): 스타 플레이어 플레이어와 사용한 브롤러 정보 - rank
(쇼다운 매치): 쇼다운 순위 - trophyChange : 트로피 변화량
- teams
(3vs3 또는 듀오 쇼다운 매치): 전투 팀 플레이어와 사용한 브롤러 정보 배열 - players
(솔로 쇼다운 또는 듀얼 매치): 전투 플레이어와 사용한 브롤러 정보 배열
플레이어 전투 목록으로 이루어진 배열을 아래와 같이 불러올 수 있다. 전투 기록은 최근으로부터 25개 전투를 불러올 수 있다.
await fetch(`https://api.brawlstars.com/v1/players/%23태그/battlelog`, {
method: "GET",
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer ' + 토큰 값
}
}).then(res => res.json())
.catch(err => console.error(err));
게임 모드 전투 정보 통일
배열 내 전투 정보가 3vs3 모드, 듀오 쇼다운 모드와 솔로 쇼다운 모드, 듀얼 모드에 따라 JSON 구조가 다르다. 3vs3 모드와 솔로 쇼다운 모드의 경우 아래와 같이 구성된다.
- 3vs3 모드
{ "battleTime": "20230101T000000.000Z", "event": { "id": 15000051, "mode": "brawlBall", "map": "Super Beach" }, "battle": { "mode": "brawlBall", "type": "ranked", "result": "victory", "duration": 101, "trophyChange": 8, "starPlayer": { "tag": "#000000", "name": "laetipark1", "brawler": { "id": 16000001, "name": "COLT", "power": 10, "trophies": 500 } }, "teams": [ [ { "tag": "#000000", "name": "laetipark1", "brawler": { "id": 16000019, "name": "PENNY", "power": 10, "trophies": 500 } }, { "tag": "#RRRRRR", "name": "laetipark2", "brawler": { "id": 16000045, "name": "STU", "power": 11, "trophies": 500 } }, { "tag": "#VVVVVV", "name": "laetipark3", "brawler": { "id": 16000010, "name": "EL PRIMO", "power": 11, "trophies": 500 } } ] ... ] } } - 솔로 쇼다운 모드
{ "battleTime": "20230101T000000.000Z", "event": { "id": 15000033, "mode": "soloShowdown", "map": "Cavern Churn" }, "battle": { "mode": "soloShowdown", "type": "ranked", "rank": 1, "trophyChange": 10, "players": [ { "tag": "#OOOOOO", "name": "laetipark", "brawler": { "id": 16000070, "name": "CORDELIUS", "power": 11, "trophies": 500 } } ... ] } }
여러 형태의 JSON을 하나의 데이터베이스 테이블에 넣는 중, 솔로/듀오 쇼다운 모드에서의 브롤러 승률 통계를 내기 위해서는 전투 결과 값을 따로 만들어주어야 했다.
그래서 3vs3 모드 result 요소를 모든 전투 결과 값으로 통일시켜 솔로/듀오 쇼다운 모드의 rank 요소에 따라 값을 넣어주기로 했다.
솔로 쇼다운과 듀오 쇼다운 rank 값마다 result의 승(victory)/무(draw)/패(defeat) 개념을 나누었다.
솔로 쇼다운 : 승 1~4등 / 무 5~6등 / 패 7~10등
듀오 쇼다운 : 승 1~2등 / 무 3등 / 패 4~5등
프로젝트 코드에는 아래와 같은 방식으로 솔로 쇼다운(10팀) 또는 듀오 쇼다운(5팀)의 순위에 따라 rankResult값으로 다시 계산하여 승/무/패를 구분해주었다.
// 2 / (10 / teams) => 솔로 쇼다운 : 2 / 듀오 쇼다운 : 1
const rankResult = rank / (2 / (10 / teams));
if (rankResult < 2) { // 승리
return -1;
} else if (rankResult < 3) { // 무승부
return 0;
} else { // 패배
return 1;
}
전투 유형 세분화
API에서 제공하는 전투 유형(type) 요소 값은 아래와 같다. ranked : 트로피 리그 맵, 유저 맵 전투 friendly : 친선 전투 soloRanked : 파워 리그(솔로) teamRanked : 파워 리그(팀) challenge : 챌린지 championshipChallenge : 챔피언십 챌린지
클럽 리그의 경우 현재 API에서 위에 전투 유형과는 다른 방식으로 제공한다.
// 일반 모드로 플레이 할 경우
{
...
"battle": {
"type": "ranked",
"trophyChange": 4,
},
"teams": [
[
{
"tag": "#RRRRRR",
"name": "laetipark2",
"brawler": {
"id": 16000030,
"name": "EMZ",
"power": 11,
// 파워 리그 또는 클럽 리그로 플레이 할 경우 "trophies" 값은 각각의 랭크로 표기 된다.
// 다이아 1 == 10
"trophies": 18
}
}
...
]
...
]
}
// 파워 매치로 플레이 할 경우
{
...
"battle": {
"type": "teamRanked",
"trophyChange": 9,
}
...
}
트로피 리그와 파워 리그, 그리고 클럽 리그를 따로 구분하고 싶었으며, 관련한 내용을 검색하거나 공식 API에서의 응답을 확인해보니 클럽 리그는 아래와 같이 구분할 수 있음을 알 수 있었다.
if (type === "teamRanked" && [3, 5, 7, 9].includes(trophyChange)) {
// 파워 매치
comparePlayers.teams = currentPlayers;
type = "clubLeague";
}
if (type === "ranked" && [1, 2, 3, 4].includes(trophyChange) && trophies < 20 && !["duoShowdown", "soloShowdown"].includes(mode)) {
// 일반 모드
// trophies는 트로피 리그 맵에서 플레이할 경우 브롤러 트로피 개수가 1100개 이상인 것을 제외하기 위함
type = "clubLeague";
}
파워 매치의 경우 파워 리그와 같은 3판 2선승제로 같은 팀으로 두 번 이상의 전투가 진행되기 때문에, 프로젝트 코드에서는 해당 전투에서 파워 매치인 것이 확인되면 팀 정보를 저장하여 다음 전투에서의 팀 정보와 비교하여 클럽 리그인지 여부를 확인해주는 코드 또한 작성하였다.
Ghost