PlayStream에서 데이터를 수집하려면 WriteEvents, WritePlayerEvent, WriteCharacterEvent, WriteTitleEvent, 이 네 가지 API를 활용할 수 있습니다.
PlayFabGenerated 이벤트 vs UserGenerated 이벤트
PlayFabGenerated와 UserGenerated라는 두 가지 유형의 이벤트를 사용할 수 있습니다. 이 두 가지 이벤트 유형은 모두 플레이어 순서를 따릅니다. 즉, 여러 API가 특정 순서로 호출되는 경우 이벤트에 의해 트리거되는 모든 작업이 API 호출과 동일한 순서로 실행됩니다.
PlayFabGenerated 이벤트는 일반적인 API 호출을 통해 PlayFab에서 생성됩니다.
이와 달리 UserGenerated 이벤트는 구조와 데이터를 정의하는 개발자에 의해 생성되며, 게임에만 적용됩니다. 이러한 이벤트는 실시간 분석 도구를 통해 완전히 반영되며 표준 이벤트와 달리 게시하려면 몇 가지 사용자 지정 코드가 필요합니다.
UserGenerated 이벤트는 엔터티별로 분류할 수 있으며 플레이어, 캐릭터 또는 제목에 바인딩될 수 있습니다. 이벤트 엔터티 참조는 다음 두 필드를 사용해 지정합니다.
- EntityType
- EntityID
다음은 PlayFabGenerated 이벤트와 UserGenerated 이벤트의 몇 가지 특성을 비교한 테이블입니다.
| PlayFabGenerated 이벤트 | UserGenerated 이벤트 | |
|---|---|---|
| 생성자 | PlayFab 서비스 | 개발자 |
| 스키마 | 표준 스키마(PlayFab에서 정의) | 주로 사용자 지정 스키마(개발자가 정의) |
| 보고서 및 템플릿 | 일반적인 보고서 및 템플릿에 사용 | 보고서 또는 템플릿에 사용되지 않음 |
| 이벤트 네임스페이스 | V1: "com.playfab" V2: "events" |
V1: "title" V2: "custom" |
| 내보내는 방법 | 해당 없음 | V1: WriteTitleEvent, WritePlayerEvent, WriteCharacterEvent V2: WriteEvents |
표준 스키마 이벤트 vs 사용자 지정 스키마 이벤트
PlayFab 내에서 PlayFabGenerated 표준 스키마와 UserGenerated 사용자 지정 스키마 이벤트를 모두 활용할 수 있지만 후자는 상대적으로 수가 제한됩니다.
다음 표에서는 이 두 가지 유형 이벤트의 예를 확인할 수 있습니다.
| PlayFabGenerated 이벤트 | UserGenerated 이벤트 | |
|---|---|---|
| 표준 스키마 |
player_logged_in entity_created |
client_focus_change client_session_start |
| 사용자 지정 스키마 | 해당 없음 | 자유 스타일 |