PlayStream を使用してデータを取り込むには、WriteEvents、WritePlayerEvent、WriteCharacterEvent、WriteTitleEvent の 4 種類の API を利用できます。
PlayFabGenerated イベントと UserGenerated イベントの比較
使用可能なイベントには、PlayFabGenerated と UserGenerated の 2 種類があります。 どちらのイベントの種類もプレイヤー順です。つまり、複数の API が特定の順序で呼び出された場合、イベントによってトリガーされるアクションは API 呼び出しと同じ順序で実行されます。
PlayFabGenerated イベントは、通常の API 呼び出しを通じて PlayFab によって作成されます。
一方、UserGenerated イベントは、開発者がそのイベントの構造とデータを定義し、ゲーム固有のものとして作成されます。 これらのイベントはリアルタイム分析ツールを通じて完全に反映されますが、標準的なイベントとは異なり、それらを投稿するにはいくつかのカスタム コードが必要です。
UserGenerated イベントはエンティティ別に分類でき、プレイヤー、キャラクター、またはタイトルに紐づけできます。 イベント エンティティの参照は、次の 2 つのフィールドを使用して指定します。
- EntityType
- EntityID
PlayFabGenerated イベントと UserGenerated イベント特性の比較表を次に示します。
| PlayFabGenerated イベント | UserGenerated イベント | |
|---|---|---|
| 生成者 | PlayFab サービス | 開発者 |
| スキーマ | 標準スキーマ (PlayFab によって定義) | ほとんどの場合、カスタム スキーマ (開発者によって定義) |
| レポートとテンプレート | 一般的なレポートとテンプレートで使用されます | レポートまたはテンプレートでは使用されません |
| イベント名前空間 | V1: "com.playfab" V2: "イベント" |
V1: "タイトル" V2: "カスタム" |
| 出力方法 | 該当せず | V1: WriteTitleEvent、WritePlayerEvent、WriteCharacterEvent V2: WriteEvents |
標準スキーマ イベントとカスタム スキーマ イベントの比較
PlayFab 内では、PlayFabGenerated 標準スキーマ イベントと UserGenerated カスタム スキーマ イベントの両方を利用できますが、後者のイベントの数は比較的限られています。
次の表では、これら 2 種類のイベントの例を示します。
| PlayFabGenerated イベント | UserGenerated イベント | |
|---|---|---|
| 標準スキーマ |
player_logged_in entity_created |
client_focus_change client_session_start |
| カスタム スキーマ | 該当せず | フリー スタイル |