트리거 구조
Understand the structure of a trigger configuration that defines what to invoke when an event fires.
읽는 시간 1분최근 업데이트: 3달 전
트리거 구성은 이벤트가 발생할 때 호출해야 할 항목을 정의합니다. 예시는 다음과 같습니다.
{ "name" : "example-trigger", "eventType" : "com.unity.services.{{SERVICE_NAME}}.{{EVENT_NAME}}.v{{EVENT_VERSION}}", "actionUrn" : "urn:ugs:cloud-code:{{SCRIPT}}", "actionType" : "cloud-code", "filter": "data['parameter'] == 'value'"}
- : 트리거 이름으로, 프로젝트별로 고유해야 합니다.
name - : 트리거와 이벤트를 일치시킬 때 사용합니다.
eventType및eventName필드로 구성되며, 각각 이벤트 구성의eventVersion및eventName필드와 상응합니다.payloadVersion - : 트리거가 발동할 때 호출할 항목을 정의합니다. 예를 들어,
actionUrn는urn:ugs:cloud-code:TestScriptCloud Code 스크립트를 호출하고,TestScript은urn:ugs:cloud-code:TestModule/TestFunctionCloud Code 모듈의TestModule함수를 호출합니다.TestFunction - : 트리거가 발동할 때 실행할 작업 유형입니다. 현재
actionType만 지원됩니다.cloud-code - : 트리거가 실행되기 위해 충족되어야 하는 조건을 정의하는 선택 사항 필드입니다. 조건이 충족되지 않으면 트리거가 실행되지 않습니다. 자세한 내용은 필터를 참고하십시오.
filter
참고
참고: CLI를 통해 필터로 트리거를 생성할 수 없습니다. Triggers API나 Unity Dashboard를 사용합니다.
이벤트와 오버랩
트리거는 이벤트와 연결됩니다. 이벤트가 발생하면 연결된 트리거가 호출됩니다. 이벤트와 트리거는 동일한eventNamepayloadVersion참고
참고: 은 이벤트를 트리거에 매핑합니다.
eventType예약된 이벤트
다음과 같은 일정 구성을 사용한다고 가정해 보겠습니다.또한 다음과 같은 트리거 구성을 사용합니다.{ "name" : "recurring-schedule", "eventName": "example-event", "type": "recurring", "schedule": "0 0 * * *", "payloadVersion": 1, "payload": "{\"someBoolean\": true, \"someString\": \"something\"}"}
트리거 구성의{ "name" : "example-trigger", "eventType" : "com.unity.services.scheduler.example-event.v1", "actionUrn" : "urn:ugs:cloud-code:my-script", "actionType" : "cloud-code"}
eventTypeeventNamepayloadVersionUGS 이벤트
트리거를 UGS의 이벤트 유형과 연결하려면 트리거 구성에서 이벤트 유형을 지정해야 합니다. 예를 들어 Authentication의 가입 이벤트에서 트리거를 발생시키려면 다음과 같은 트리거 구성을 생성하면 됩니다.사용자가 가입할 때마다 트리거가 발동하여{ "name" : "example-trigger", "eventType" : "com.unity.services.player-auth.signed-up.v1", "actionUrn" : "urn:ugs:cloud-code:my-script", "actionType" : "cloud-code"}
my-script복수 이벤트(트리거당)
여러 트리거를 사용하여 동일한 이벤트를 연결할 수 있습니다.참고
참고: 현재 이벤트 유형당 트리거 수는 32개로 제한됩니다.
add-cloud-save-data두 번째 트리거는{ "name" : "auth-cloud-save", "eventType" : "com.unity.services.player-auth.signed-up.v1", "actionUrn" : "urn:ugs:cloud-code:add-cloud-save-data", "actionType" : "cloud-code"}
Economyadd-economy-items사용자가 가입할 때마다 두 트리거가 실행되며, 관련 Cloud Code 리소스가 호출됩니다.{ "name" : "auth-economy", "eventType" : "com.unity.services.player-auth.signed-up.v1", "actionUrn" : "urn:ugs:cloud-code:Economy/add-economy-items", "actionType" : "cloud-code"}