> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# player_logged_in

> player_logged_in event.

当玩家登录时，将触发此事件。

## 属性

| 名称 | 类型 | 描述 |
| :- | :- | :- |
| Location | [EventLocation](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/eventlocation.md) | 玩家的地理位置（如果已知）。位置根据 IP 地址等因素进行估算，并非始终可用或准确。 |
| Platform | [LoginIdentityProvider](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/loginidentityprovider.md) | 用于登录玩家的身份验证方法。 |
| PlatformUserId | String | 用于登录玩家的身份验证方法下的玩家身份。 |
| PlatformUserName | String | 在玩家进行身份验证的身份提供程序中设置的显示名称。 |
| TitleId | String | 此玩家事件适用的 title 的 ID。 |

## 常用属性

所有 V1 PlayStream 事件都格式化为 JSON 对象，并共享以下常用属性：

| 名称 | 类型 | 描述 |
| :- | :- | :- |
| EntityId | String | 此事件适用的实体（title、player 等）的标识符。 |
| EntityType | String | 此事件适用的实体类型（player、title 等）。如果希望 PlayFab 对此实体执行操作，则 EntityType 必须为 'player'、'character' 或 'title'。当前 PlayFab 尚未解析的任何实体类型都必须加上命名空间前缀（例如 'com.mygame.guild'），因为 PlayFab 可能随时开始解析根实体。 |
| EventId | String | PlayFab 为此事件分配的唯一标识符。 |
| EventName | String | 此事件的名称。 |
| EventNamespace | String | 为此事件分配的命名空间。例如：'com.myprogram.ads' |
| Source | String | 此 PlayStream 事件的源的名称；如果事件源自我方，则为 PlayFab。 |
| SourceType | [SourceType](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/sourcetype.md) | 此事件的源类型（PlayFab 合作伙伴、其他后端或来自 PlayFab API）。 |
| Timestamp | DateTime | 与此事件关联的时间（UTC）。 |


## Related topics

- [趋势](https://docs.xbox.com/zh-CN/services/playfab/data-analytics/learn-data/trends/trends-overview.md)
- [将实验与其他 PlayFab 服务集成](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/game-configuration/experiments/experiments-other-services.md)
- [架构快速入门](https://docs.xbox.com/zh-CN/services/playfab/data-analytics/acting-data/schemas-quickstart.md)
- [Write Player Event](https://docs.xbox.com/api-reference/analytics/write-player-event.md)
- [记分卡指标](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/game-configuration/experiments/scorecard-metrics.md)