MMORPG
리니지2M과 같이 특정 캐릭터로 오픈월드를 탐험하는 형태의 MMORPG(대규모 다중 사용자 온라인 게임) 게임을 플레이 하는 경우, 아래와 같이 메소드를 호출하세요.
맵 진입 및 퇴장
-
캐릭터가 특정 맵에 진입하거나 퇴장하는 경우
PlayStage를 호출하세요.맵 진입 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
stage_type
필수
stageType.PvEstage_slug
string
필수
데네브 마을stage_category_slug
string
선택
안전 지역stage_level
string
선택
null
stage_score
int
선택
null
stage_status
선택
stageStatus.Startstage_playtime
int
선택
null
맵 퇴장 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
stage_type
필수
stageType.PvEstage_slug
string
필수
데네브 마을stage_category_slug
string
선택
안전 지역stage_level
string
선택
null
stage_score
int
선택
null
stage_status
선택
stageStatus.Winstage_playtime
int
선택
30 -
재화 또는 아이템을 사용하여 특정 맵으로 진입하거나 퇴장 하는 경우
UseCurrency와UseConsumable도 함께 호출하세요.-
캐릭터가 어떤 맵에서 나와 다른 맵으로 들어간다면
PlayStage를 두 번 호출해야 합니다. 이 때 첫번째 호출은 이전 맵으로부터의 퇴장, 두번째 호출은 새로운 맵으로의 진입에 관한 것입니다. -
캐릭터가 새로운 맵으로 입장하는 경우 이전 맵의 퇴장에 관한
PlayStage메소드의stage_status값으로stageStatus.Win을 입력하세요.
메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
currency_slug
string
필수
딜currency_quantity
float
필수
10000currency_total_quantity
float
선택
999999where_to_entity
선택
entity.PlayStagewhere_to_category_slug
string
선택
일반 지역where_to_slug
string
선택
황금 벌판이전 맵 퇴장 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
stage_type
필수
stageType.PvEstage_slug
string
필수
데네브 마을stage_category_slug
string
선택
안전 지역stage_level
string
선택
null
stage_score
int
선택
null
stage_status
선택
stageStatus.Winstage_playtime
int
선택
30새로운 맵 진입 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
stage_type
필수
stageType.PvPstage_slug
string
필수
황금 벌판stage_category_slug
string
선택
일반 지역stage_level
string
선택
23stage_score
int
선택
null
stage_status
선택
stageStatus.Startstage_playtime
int
선택
null
-
아이템 획득
플레이 도중 화폐 재화, 장비 등 Object를 획득하는 경우 각 Object별로 Get{ Object } 메소드를 호출하세요.
-
플레이 도중 화폐 재화를 획득한 경우
GetCurrency를 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
currency_slug
string
필수
딜currency_quantity
float
필수
100currency_total_quantity
float
선택
99999from_entity
선택
entity.PlayStagefrom_category_slug
string
선택
일반 지역from_slug
string
선택
황금 벌판 -
플레이 도중 재료 아이템을 획득한 경우
GetMaterial을 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
철item_quantity
float
필수
1from_entity
선택
entity.PlayStagefrom_category_slug
string
선택
일반 지역from_slug
string
선택
황금 벌판 -
플레이 도중 장비 아이템을 획득한 경우
GetEquipment를 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
리자드맨의 활item_quantity
float
필수
1from_entity
선택
entity.PlayStagefrom_category_slug
string
선택
일반 지역from_slug
string
선택
황금 벌판 -
플레이 도중 물약 등의 소비재를 획득한 경우
GetConsumable를 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
아르데카의 고급 서약서 (각인)item_quantity
float
필수
1from_entity
선택
entity.PlayStagefrom_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.PvPstage_slug
string
필수
황금 벌판stage_category_slug
string
선택
일반 지역stage_level
string
선택
23stage_score
int
선택
null
stage_status
선택
stageStatus.Losestage_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.Equipitem_level
int
선택
7character_level
int
선택
14 -
캐릭터가 펫을 소환하거나 장착하고 맵에 진입하는 시점에
PlayStageWith를 호출합니다.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuids
string
필수
item_slug
string
필수
페럿 유니콘stage_slug
string
필수
황금 벌판stage_type
선택
stageType.PvPstage_category_slug
string
선택
일반 지역
장비 장착 및 활용
캐릭터가 아이템을 장착하고 플레이 하는 경우 아래와 같이 Equipment 관련 메소드를 호출하세요.
-
캐릭터가 장비 아이템을 빈슬롯에 장착하고 플레이 하는 경우 아래와 같이
EquipEquipment와PlayStageWithEquipment를 호출하세요.-
장비를 캐릭터에 장착하는 순간에
EquipEquipment를 호출합니다.빈 슬롯에 장비 장착 메소드
파라미터
자료형
필수여부
비고
아이템 A
아이템 B
player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
+6 롱소드+1 미늘 갑옷equip_status
필수
equipStatus.Equipitem_level
int
선택
61character_level
int
선택
14 -
장비를 캐릭터에 장착하고 맵에 진입하는 순간에
PlayStageWithEquipment를 호출합니다.메소드
파라미터
자료형
필수여부
비고
아이템 A
아이템 B
player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
+6 롱소드+1 미늘 갑옷stage_slug
string
선택
황금 벌판stage_type
선택
stageType.PvPstage_category_slug
string
선택
일반 지역
-
-
캐릭터가 장비 아이템을 교체 하는 경우 아래와 같이
EquipEquipment및PlayStageWithEquipment를 호출하세요.-
기존 장비를 캐릭터로부터 해제하는 순간에
EquipEquipment를 호출하세요.착용 아이템 해제 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
+6 롱소드equip_status
필수
equipStatus.Unequipitem_level
int
선택
6character_level
int
선택
14 -
새로운 장비를 캐릭터에 장착하는 순간에
EquipEquipment를 호출하세요.새 아이템 착용 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
+10 롱소드equip_status
필수
equipStatus.Equipitem_level
int
선택
10character_level
int
선택
14 -
새로운 장비를 장착하고 맵에 진입하는 순간에
PlayStageWithEquipment를 호출하세요.새 아이템으로 플레이 메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
item_slug
string
필수
+10 롱소드stage_slug
string
선택
황금 벌판stage_type
선택
stageType.PvPstage_category_slug
string
선택
일반 지역
-
스킬 장착 및 활용
캐릭터가 특정 스킬을 장착하고 플레이하는 경우 아래와 같이 EquipSkill 및 PlayStageWithSkill을 호출하세요.
-
새로운 스킬을 캐릭터에 해제하거나 장착하는 순간에
EquipSkill을 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
skill_slug
string
필수
힘skill_category_slug
string
선택
패시브equip_status
필수
equipStatus.Equipskill_level
int
선택
3character_level
int
선택
14 -
새로운 스킬을 장착하고 맵에 진입하는 순간에
PlayStageWithSkill을 호출하세요.메소드 파라미터 자료형 필수여부 비고 player_uuid
string
필수
character_uuid
string
필수
skill_slug
string
필수
힘skill_category_slug
string
선택
패시브stage_slug
string
필수
황금 벌판stage_type
선택
stageType.PvPstage_category_slug
string
선택
일반 지역