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

# group_members_added

> group_members_added event.

向实体组添加成员时触发此事件。

## 属性

| 名称            | 类型                                                                                | 说明                       |
| :------------ | :-------------------------------------------------------------------------------- | :----------------------- |
| EntityChain   | String                                                                            | 此实体的所有权链。                |
| EntityLineage | [EntityLineage](/services/playfab/api-references/events/data-types/entitylineage) | 此实体所属的父实体。               |
| GroupName     | String                                                                            | 此事件所应用于的组的名称。            |
| Members       | [Member](/services/playfab/api-references/events/data-types/member)               | 此事件所应用于的、被添加到该组和角色的实体列表。 |
| RoleId        | String                                                                            | 此事件所应用于的角色的角色 ID。        |
| RoleName      | String                                                                            | 此事件所应用于的角色的显示名称。         |

## 通用属性

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

| 名称             | 类型                                                                          | 说明                                                                                                                                                                                  |
| :------------- | :-------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| EntityId       | String                                                                      | 此事件所应用于的实体（游戏、玩家等）的标识符。                                                                                                                                                             |
| 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](/services/playfab/api-references/events/data-types/sourcetype) | 此事件的源类型（PlayFab 合作伙伴、其他后端或来自 PlayFab API）。                                                                                                                                          |
| Timestamp      | DateTime                                                                    | 与此事件关联的时间（UTC）。                                                                                                                                                                     |


## Related topics

- [PlayFab 的 PlayStream 事件模型参考](/zh-CN/services/playfab/api-references/events/index.md)
- [members_added](/zh-CN/services/playfab/api-references/events/Groups/members-added.md)
- [group_role_members_added](/zh-CN/services/playfab/api-references/events/Groups/group-role-members-added.md)
- [PFLobbyMemberAddedStateChange](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md)
- [PlayFabMultiplayer.OnLobbyMemberAdded](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnLobbyMemberAdded.md)