동작 및 규칙 빠른 시작

PlayStream 규칙을 사용하면 한 가지의 유형의 PlayStream 이벤트의 하위 집합에 실시간으로 반응할 수 있습니다.

요구 사항

간단한 관련 용어 설명:

  • PlayStream: PlayFab 이벤트 파이프라인을 구성하는 기능 그룹입니다.

    • PlayStream 이벤트는 플레이어 또는 제목에 대한 이벤트를 설명하는 JSON 형식의 문자열입니다.
    • PlayStream 이벤트는 자동화 기능 계층에 따라 최대 크기를 가집니다.
  • 규칙: 실시간으로 한 가지 유형의 PlayStream 이벤트에 응답하여 추가 논리를 수행합니다.

    • 하나의 이벤트 트리거, 선택적 조건 목록 및 선택적 동작 목록의 합계입니다.
  • 트리거: 이 규칙을 활성화하는 이벤트의 이름입니다.

  • 조건: 규칙 및 기타 PlayStream 기능에 대한 콘텐츠 필터입니다.

    • PlayStream 이벤트 JSON 개체에 대한 매우 간단한 평가를 수행하고 요구 사항에 맞지 않는 이벤트는 건너뜁니다.
  • 동작: 해당 엔터티에 대해 수행할 상황에 맞는 동작입니다.

규칙은 정확히 하나의 트리거, 선택적 조건 목록 그리고 일반적으로 하나 이상의 동작(필수는 아니지만 없이는 쓸모가 없음)으로 구성됩니다.

또한 트리거, 조건 및 동작은 대량 동작토너먼트 순위표 등 다른 시스템의 일부입니다.

예제 사례: 클라이언트의 사용자 지정 이벤트 수

아래 제시된 예제에서 다음과 같은 클라이언트의 사용자 지정 이벤트를 게시합니다.

public void WriteEvent() {
    PlayFabClientAPI.WritePlayerEvent(new WriteClientPlayerEventRequest {
        EventName = "ForumPostEvent",
        Body = new Dictionary<string, object> {
            { "Subject", "My First Post" },
            { "Body", "My awesome Post." }
        }
    }, LogSuccess, LogFailure);
}

이 경우 클라이언트가 사용자 지정 ForumPostEvent(현재 PlayFab의 모든 자동 이벤트 또는 지원되는 파트너와 일치하지 않음)를 수동으로 보고하고 있습니다.

PlayStream 규칙을 사용하여 플레이어가 이런 방식으로 포럼 게시물을 보고하는 횟수를 계산합니다.

요구 사항: 게임 관리자 GUI에서 이벤트를 트리거하는 규칙을 만들 수 있도록 하기 전에 게임에서 이미 이러한 유형의 이벤트를 게시해야 합니다.

게임 관리자로 이동합니다.

  • 타이틀로 이동합니다.
  • 자동화를 선택합니다.
  • 규칙으로 이동합니다.
  • 새 규칙을 선택합니다.

게임 관리자 - 자동화 - 새 규칙

이 예제의 새 규칙을 하나씩 평가해 보겠습니다.

  • title.6195.ForumPostEvent
    • 6195자습서에서 사용된 타이틀입니다. titleId는 고유한 타이틀과 일치할 것입니다.
    • ForumPostEvent이 예제 사례의 코드에 사용된 이벤트 이름입니다.
    • 이 줄은 최근에 ForumPostEvent을(를) 타이틀에 적어도 하나 이상 게시한 경우에만 사용할 수 있습니다.
  • 이 예제에서 특별히 사용된 조건은 최소한 사용합니다.
    • 그러나 본문 키가 본문 사전의 잘못된 문자열에 매핑된 경우 사용자 지정 이벤트를 필터링하는 방법을 보여줍니다.
    • 필터는 선택 사항이며 관련 없는 플레이어를 규칙에서 제거해야 합니다.
  • 이 경우 선택된 동작은 통계 카운터를 1씩 증가시킵니다.
    • 요구 사항: 포럼 게시물 통계는 게임 관리자의 순위표에서 정의해야 합니다.

게임 관리자 Playstream 디버거(아래 참조)에서 트리거가 적용되는 것을 지켜볼 수 있습니다.

게임 관리자 - PlayStream - 디버거 - 이벤트 트리거

여기에서 볼 수 있는 것 처럼, 사용자 지정 ForumPostEvent은 새 규칙에 대한 동작에 설정된 통계를 자동으로 트리거합니다.

고급: CloudScript 동작

PlayFab의 기본 제공 동작의 대부분은 매우 간단하며, 필요한 모든 기능을 제공하지 못할 수도 있습니다. 이 때문에 CloudScript를 사용하여 동작 논리를 완벽하게 사용자 지정할 수 있습니다.

규칙을 편집해 보겠습니다.

  • 조건을 제거합니다.
  • 동작CloudScript 실행으로 설정합니다.
  • 조치 저장버튼을 선택합니다.

게임 관리자 - 자동화 - 규칙 편집

이제 새 ForumPostEvent를 게시하면 CloudScript 실행이 표시됩니다.

게임 관리자 - PlayStream - 디버거 - CloudScript 실행

PlayStream 규칙에 반응하도록 CloudScript를 작성하는 것은 자습서에서 다루는 고급 주제: PlayStream으로 CloudScript 작업 사용입니다.