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

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

트리거

createGathering

개더링 신규 생성

동기 실행 스크립트

개더링 신규 생성 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
gatheringGathering개더링
구현 예제
-- Request
local namespace = args.namespace
local gathering = args.gathering

-- Business logic:

-- Result
result = {
}

completeMatchmaking

매치메이킹 완료

동기 실행 스크립트

매치메이킹 완료 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
gatheringGathering개더링
구현 예제
-- Request
local namespace = args.namespace
local gathering = args.gathering

-- Business logic:

-- Result
result = {
}

changeRating

레이팅 값 변화

동기 실행 스크립트

레이팅 값 변화 처리 전에, 스크립트가 동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
oldRatingRating갱신 전 레이팅
newRatingRating갱신 후 레이팅
Result
타입필수기본값값 제한설명
permitbool
레이팅 값 변화를 허용할지 여부
구현 예제
-- Request
local namespace = args.namespace
local oldRating = args.oldRating
local newRating = args.newRating

-- Business logic:
local permit = true

-- Result
result = {
  permit=permit
}

비동기 실행 스크립트

레이팅 값 변화 처리 후에, 스크립트가 비동기 실행됩니다.

Request
타입설명
namespaceNamespace네임스페이스
oldRatingRating갱신 전 레이팅
newRatingRating갱신 전 레이팅
구현 예제
-- Request
local namespace = args.namespace
local oldRating = args.oldRating
local newRating = args.newRating

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

result = {
}