GS2-AdReward 스크립트 트리거 레퍼런스

확장 스크립트를 호출하는 이벤트 트리거의 레퍼런스

트리거

acquirePoint

포인트 획득

동기 실행 스크립트

포인트 획득 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입 설명
namespace Namespace 네임스페이스
point Point 획득 처리 전 포인트
acquirePointValue long 획득 포인트 양
Result
타입 필수 기본값 값 제한 설명
permit bool
✓
포인트 획득을 허용할지 여부
overridePointValue long 0 ~ 2147483645 덮어쓸 획득 포인트 양
구현 예제
-- Request
local namespace = args.namespace
local point = args.point
local acquirePointValue = args.acquirePointValue

-- Business logic:
local permit = true
local overridePointValue = 0

-- Result
result = {
  permit=permit,
  overridePointValue=overridePointValue
}

비동기 실행 스크립트

포인트 획득 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입 설명
namespace Namespace 네임스페이스
point Point 획득 처리 전 포인트
afterPoint Point 획득 후 포인트
acquirePointValue long 획득 포인트 양
구현 예제
-- Request
local namespace = args.namespace
local point = args.point
local afterPoint = args.afterPoint
local acquirePointValue = args.acquirePointValue

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}

consumePoint

포인트 소비

동기 실행 스크립트

포인트 소비 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입 설명
namespace Namespace 네임스페이스
point Point 소비 처리 전 포인트
consumePointValue long 소비 포인트 양
Result
타입 필수 기본값 값 제한 설명
permit bool
✓
포인트 소비를 허용할지 여부
overridePointValue long 0 ~ 2147483645 덮어쓸 소비 포인트 양
구현 예제
-- Request
local namespace = args.namespace
local point = args.point
local consumePointValue = args.consumePointValue

-- Business logic:
local permit = true
local overridePointValue = 0

-- Result
result = {
  permit=permit,
  overridePointValue=overridePointValue
}

비동기 실행 스크립트

포인트 소비 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입 설명
namespace Namespace 네임스페이스
point Point 소비 처리 전 포인트
afterPoint Point 소비 후 포인트
consumePointValue long 소비 포인트 양
구현 예제
-- Request
local namespace = args.namespace
local point = args.point
local afterPoint = args.afterPoint
local consumePointValue = args.consumePointValue

-- 비동기 스크립트는 일반적으로 API 응답에 영향을 주지 않습니다.
-- 로그 출력이나 분석, 외부 알림 등에 사용됩니다.

result = {
}