MMORPG
리니지2M과 같이 특정 캐릭터로 오픈월드를 탐험하는 형태의 MMORPG(대규모 다중 사용자 온라인 게임) 게임을 플레이 하는 경우, 아래와 같이 메소드를 호출하세요.
맵 진입 및 퇴장
-
캐릭터가 특정 맵에 진입하거나 퇴장하는 경우
PlayStage
를 호출하세요.맵 진입 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
stage_type
필수
stageType.PvE
stage_slug
string
필수
데네브 마을
stage_category_slug
string
선택
안전 지역
stage_level
string
선택
null
stage_score
int
선택
null
stage_status
선택
stageStatus.Start
stage_playtime
int
선택
null
맵 퇴장 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
stage_type
필수
stageType.PvE
stage_slug
string
필수
데네브 마을
stage_category_slug
string
선택
안전 지역
stage_level
string
선택
null
stage_score
int
선택
null
stage_status
선택
stageStatus.Win
stage_playtime
int
선택
30
-
재화 또는 아이템을 사용하여 특정 맵으로 진입하거나 퇴장 하는 경우
UseCurrency
와UseConsumable
도 함께 호출하세요.-
캐릭터가 어떤 맵에서 나와 다른 맵으로 들어간다면
PlayStage
를 두 번 호출해야 합니다. 이 때 첫번째 호출은 이전 맵으로부터의 퇴장, 두번째 호출은 새로운 맵으로의 진입에 관한 것입니다. -
캐릭터가 새로운 맵으로 입장하는 경우 이전 맵의 퇴장에 관한
PlayStage
메소드의stage_status
값으로stageStatus.Win
을 입력하세요.
메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
currency_slug
string
필수
딜
currency_quantity
float
필수
10000
currency_total_quantity
float
선택
999999
where_to_entity
선택
entity.PlayStage
where_to_category_slug
string
선택
일반 지역
where_to_slug
string
선택
황금 벌판
이전 맵 퇴장 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
stage_type
필수
stageType.PvE
stage_slug
string
필수
데네브 마을
stage_category_slug
string
선택
안전 지역
stage_level
string
선택
null
stage_score
int
선택
null
stage_status
선택
stageStatus.Win
stage_playtime
int
선택
30
새로운 맵 진입 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
stage_type
필수
stageType.PvP
stage_slug
string
필수
황금 벌판
stage_category_slug
string
선택
일반 지역
stage_level
string
선택
23
stage_score
int
선택
null
stage_status
선택
stageStatus.Start
stage_playtime
int
선택
null
-
아이템 획득
플레이 도중 화폐 재화, 장비 등 Object를 획득하는 경우 각 Object별로 Get{ Object } 메소드를 호출하세요.
-
플레이 도중 화폐 재화를 획득한 경우
GetCurrency
를 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
currency_slug
string
필수
딜
currency_quantity
float
필수
100
currency_total_quantity
float
선택
99999
from_entity
선택
entity.PlayStage
from_category_slug
string
선택
일반 지역
from_slug
string
선택
황금 벌판
-
플레이 도중 재료 아이템을 획득한 경우
GetMaterial
을 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
철
item_quantity
float
필수
1
from_entity
선택
entity.PlayStage
from_category_slug
string
선택
일반 지역
from_slug
string
선택
황금 벌판
-
플레이 도중 장비 아이템을 획득한 경우
GetEquipment
를 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
리자드맨의 활
item_quantity
float
필수
1
from_entity
선택
entity.PlayStage
from_category_slug
string
선택
일반 지역
from_slug
string
선택
황금 벌판
-
플레이 도중 물약 등의 소비재를 획득한 경우
GetConsumable
를 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
아르데카의 고급 서약서 (각인)
item_quantity
float
필수
1
from_entity
선택
entity.PlayStage
from_category_slug
string
선택
일반 지역
from_slug
string
선택
황금 벌판
캐릭터 스탯 변경
플레이 도중 유저의 선택으로 캐릭터의 스탯이 변경되는 경우 ChangeStat
을 호출하세요.
메소드 | 파라미터 | 자료형 | 필수여부 | 비고 |
---|---|---|---|---|
player_uuid |
string |
필수 |
Notes |
|
character_uuid |
string |
필수 |
||
stat_slug |
string |
필수 |
|
|
stat_to |
int |
필수 |
|
|
stat_from |
int |
선택 |
|
|
stat_category_slug |
string |
선택 |
|
캐릭터 레벨업
플레이 도중 캐릭터가 레벨업 하는 경우 LevelUpCharacter
를 호출하세요.
메소드 | 파라미터 | 자료형 | 필수여부 | 비고 |
---|---|---|---|---|
player_uuid |
string |
필수 |
||
character_uuid |
string |
필수 |
||
level_to |
int |
필수 |
||
|
level_from |
int |
선택 |
캐릭터 사망
-
플레이 도중 캐릭터가 죽는 경우
PlayStage
를 호출하여 스테이지 종료를 기록하세요.stage_status
에는stageStatus.Lose
를 입력하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
stage_type
필수
stageType.PvP
stage_slug
string
필수
황금 벌판
stage_category_slug
string
선택
일반 지역
stage_level
string
선택
23
stage_score
int
선택
null
stage_status
선택
stageStatus.Lose
stage_playtime
int
선택
null
-
캐릭터 죽음에 대한 패널티(예: 아이템 삭제)가 있는 경우 스테이지 종료와 함께
Dismiss{ Object }
를 호출하세요.아래의 예시에는 아이템 삭제 페널티에 대해
DismissEquipment
메소드가 사용되었습니다.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
+6 롱소드
item_quantity
string
필수
1
장비, 스킬 또는 펫 장착
펫 장착 및 사용
플레이 도중 "펫"과 같이 본 캐릭터를 지원하는 서브 캐릭터를 활용하는 경우 다음의 메소드를 호출하세요.
-
캐릭터가 펫을 소환하거나 장착하는 순간
EquipPet
을 호출합니다.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
페럿 유니콘
equip_status
필수
equipStatus.Equip
item_level
int
선택
7
character_level
int
선택
14
-
캐릭터가 펫을 소환하거나 장착하고 맵에 진입하는 시점에
PlayStageWith
를 호출합니다.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
item_slug
string
필수
페럿 유니콘
stage_slug
string
필수
황금 벌판
stage_type
선택
stageType.PvP
stage_category_slug
string
선택
일반 지역
장비 장착 및 활용
캐릭터가 아이템을 장착하고 플레이 하는 경우 아래와 같이 Equipment 관련 메소드를 호출하세요.
-
캐릭터가 장비 아이템을 빈슬롯에 장착하고 플레이 하는 경우 아래와 같이
EquipEquipment
와PlayStageWithEquipment
를 호출하세요.-
장비를 캐릭터에 장착하는 순간에
EquipEquipment
를 호출합니다.빈 슬롯에 장비 장착 메소드
파라미터
자료형
필수여부
비고
아이템 A
아이템 B
player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
+6 롱소드
+1 미늘 갑옷
equip_status
필수
equipStatus.Equip
item_level
int
선택
6
1
character_level
int
선택
14
-
장비를 캐릭터에 장착하고 맵에 진입하는 순간에
PlayStageWithEquipment
를 호출합니다.메소드
파라미터
자료형
필수여부
비고
아이템 A
아이템 B
player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
+6 롱소드
+1 미늘 갑옷
stage_slug
string
선택
황금 벌판
stage_type
선택
stageType.PvP
stage_category_slug
string
선택
일반 지역
-
-
캐릭터가 장비 아이템을 교체 하는 경우 아래와 같이
EquipEquipment
및PlayStageWithEquipment
를 호출하세요.-
기존 장비를 캐릭터로부터 해제하는 순간에
EquipEquipment
를 호출하세요.착용 아이템 해제 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
+6 롱소드
equip_status
필수
equipStatus.Unequip
item_level
int
선택
6
character_level
int
선택
14
-
새로운 장비를 캐릭터에 장착하는 순간에
EquipEquipment
를 호출하세요.새 아이템 착용 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
+10 롱소드
equip_status
필수
equipStatus.Equip
item_level
int
선택
10
character_level
int
선택
14
-
새로운 장비를 장착하고 맵에 진입하는 순간에
PlayStageWithEquipment
를 호출하세요.새 아이템으로 플레이 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
+10 롱소드
stage_slug
string
선택
황금 벌판
stage_type
선택
stageType.PvP
stage_category_slug
string
선택
일반 지역
-
스킬 장착 및 활용
캐릭터가 특정 스킬을 장착하고 플레이하는 경우 아래와 같이 EquipSkill
및 PlayStageWithSkill
을 호출하세요.
-
새로운 스킬을 캐릭터에 해제하거나 장착하는 순간에
EquipSkill
을 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
skill_slug
string
필수
힘
skill_category_slug
string
선택
패시브
equip_status
필수
equipStatus.Equip
skill_level
int
선택
3
character_level
int
선택
14
-
새로운 스킬을 장착하고 맵에 진입하는 순간에
PlayStageWithSkill
을 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
skill_slug
string
필수
힘
skill_category_slug
string
선택
패시브
stage_slug
string
필수
황금 벌판
stage_type
선택
stageType.PvP
stage_category_slug
string
선택
일반 지역