GS2-SkillTree 트랜잭션 액션
검증/소비/입수 각 트랜잭션 액션의 사양
Consume Action
소비 액션
Gs2SkillTree:MarkRestrainByUserId
사용자 ID를 지정하여 노드의 해방 상태를 미해방화
지정된 노드가 구속 가능한지 검증한 후(의존하는 노드가 해방 상태가 아니어야 합니다), 미해방으로 마크합니다.
수량 지정 가능한 액션: 아니오
반전 가능한 액션: 예
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||
| propertyId | string | ✓ | ~ 1024자 | 프로퍼티 ID 사용자마다 여러 개의 독립된 스킬트리 인스턴스를 가지기 위한 식별자입니다. 동일한 네임스페이스 내에서 플레이어가 서로 다른 캐릭터나 컨텍스트에 대해 별도의 스킬트리를 가지는 시나리오를 구현합니다. 최대 1024자. | ||
| nodeModelNames | List<string> | ✓ | 1 ~ 1000 items | 노드 모델 이름 목록 | ||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2SkillTree:MarkRestrainByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"userId": "[string]사용자ID",
"propertyId": "[string]프로퍼티 ID",
"nodeModelNames": [
"[string]노드 모델명"
],
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2SkillTree:MarkRestrainByUserId
request:
namespaceName: "[string]네임스페이스 이름"
userId: "[string]사용자ID"
propertyId: "[string]프로퍼티 ID"
nodeModelNames:
- "[string]노드 모델명"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("skillTree").consume.mark_restrain_by_user_id({
namespaceName="[string]네임스페이스 이름",
userId="[string]사용자ID",
propertyId="[string]프로퍼티 ID",
nodeModelNames={
"[string]노드 모델명"
},
timeOffsetToken="[string]타임 오프셋 토큰",
})Acquire Action
입수 액션
Gs2SkillTree:MarkReleaseByUserId
사용자 ID를 지정하여 해방된 노드 기록
지정된 노드가 해방 가능한지 검증한 후(전제 노드가 이미 해방되어 있어야 합니다), 해방됨으로 마크합니다.
수량 지정 가능한 액션: 아니오
반전 가능한 액션: 예
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||
| propertyId | string | ✓ | ~ 1024자 | 프로퍼티 ID 사용자마다 여러 개의 독립된 스킬트리 인스턴스를 가지기 위한 식별자입니다. 동일한 네임스페이스 내에서 플레이어가 서로 다른 캐릭터나 컨텍스트에 대해 별도의 스킬트리를 가지는 시나리오를 구현합니다. 최대 1024자. | ||
| nodeModelNames | List<string> | ✓ | 1 ~ 1000 items | 노드 모델 이름 목록 | ||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2SkillTree:MarkReleaseByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"userId": "[string]사용자ID",
"propertyId": "[string]프로퍼티 ID",
"nodeModelNames": [
"[string]노드 모델명"
],
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2SkillTree:MarkReleaseByUserId
request:
namespaceName: "[string]네임스페이스 이름"
userId: "[string]사용자ID"
propertyId: "[string]프로퍼티 ID"
nodeModelNames:
- "[string]노드 모델명"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("skillTree").acquire.mark_release_by_user_id({
namespaceName="[string]네임스페이스 이름",
userId="[string]사용자ID",
propertyId="[string]프로퍼티 ID",
nodeModelNames={
"[string]노드 모델명"
},
timeOffsetToken="[string]타임 오프셋 토큰",
})