> ## 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_role_members_added

> group_role_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)
- [group_members_added](/zh-CN/services/playfab/api-references/events/Groups/group-members-added.md)
- [group_role_members_removed](/zh-CN/services/playfab/api-references/events/Groups/group-role-members-removed.md)
- [PFGroupsEntityMemberRole](/zh-CN/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsentitymemberrole.md)
- [PFGroupsChangeMemberRoleRequest](/zh-CN/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupschangememberrolerequest.md)