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

# PlayFab 用户角色

> 在 PlayFab Game Manager 中创建用户角色，按游戏分配细粒度权限，并管理管理员、支持团队和产品团队的工作室访问权限。

角色是你在 PlayFab 的 Game Manager 中管理用户权限和导航的方式。工作室是管理角色和用户的管理分组，而角色分配通常控制对单个游戏的访问。角色是一组已命名的权限集合，你可以按游戏将其分配给工作室中的人员。只需定义一次角色，即可将其分配给任意数量的用户，并通过编辑角色一次性更新所有人的访问权限。有关这些范围的详细信息，请参阅 [PlayFab 概念](https://docs.xbox.com/zh-CN/services/playfab/get-started/concepts.md#studios-namespaces-and-titles)。

本文介绍你最常执行的三项操作：创建角色、配置其权限以及将其分配给用户。

## 角色的工作原理

PlayFab 使用包含数百个单独权限的细粒度权限模型，因此你可以*精确*决定每个人可以执行的操作。Game Manager 的各个区域可以完全关闭、设置为只读或开放编辑。

以下是一些适用场景示例：

* 客户服务代表可以编辑玩家配置文件，但永远看不到收入数据。
* 产品经理可以查看收入仪表板，但不能上传多人游戏服务器版本。
* 数据科学家可以读取每个事件和仪表板，但在任何地方都没有写入权限。

由于权限位于角色上而不是每个用户上，因此策略更改只需一次编辑：更新角色，持有该角色的每个人都会立即获得更改。

角色是**按游戏**分配的，用户可以在同一游戏上持有**多个角色**。因此，你可以同时为某人分配*客户支持*角色和*数据科学家*角色，他们将获得两者的组合权限。同一个人还可以在同一工作室内，在一个游戏上担任游戏管理员，在另一个游戏上担任产品经理，在第三个游戏上担任客户服务代表。

### 内置角色和管理员级别

每个工作室都附带三个预定义角色：

* **Title Admin**：给定游戏的完全权限
* **Dashboard**：仅有查看游戏仪表板的权限
* **Commercial admin**：查看游戏仪表板、编辑设置、查看 Economy 付款以及管理产品激活的权限

有两个特殊的工作室范围权限会影响游戏访问。

* **Studio Admin**：创建游戏、定义和编辑角色，并自动拥有工作室中每个游戏的 **title admin** 权限。你需要是 Studio Admin 才能创建角色或将角色分配给用户。
* **Commercial admin**：对工作室的计费流程拥有一定控制权，并自动拥有工作室中每个游戏的 **commercial admin** 权限。

## 创建角色

1. 使用开发人员帐户[登录 PlayFab](https://developer.playfab.com/)。
2. 在 **My Studios and Titles** 中，选择工作室右侧的**三点 (...) 菜单**，然后选择 **Roles**。

   ![工作室三点菜单中 Roles 选项的屏幕截图](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-my-studios-roles.jpg?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=3dbf611d76d08ed29680e4bd5d7c8c29)
3. 你将看到工作室中已存在的角色列表。选择 **New custom role** 以开始创建自定义角色。

   ![带有 New Role 按钮的 Roles 列表屏幕截图](https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/identity/dev-identity/user-roles-list-roles.jpg?fit=max\&auto=format\&n=Oa_DP1q6U1lat7c2\&q=85\&s=1e8a58c2d5a2eb248aa5c5acaa470f47)
4. 在 **Role details** 下，为角色指定一个清晰的 **Role title**。稍后分配角色时将从中进行选择，因此请使其具有描述性（例如 *Customer Support* 或 *Build Engineer*）。

   ![Role details 部分的屏幕截图](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-role-details.jpg?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=970a9b4ba4dc6ece42e3fe7ad5722a18)
5. 如果此角色应拥有对游戏的不受限制的访问权限，请选中 **Title admin**。这将授予该游戏的完全权限，并覆盖下面的单个权限选择。

### 配置权限

在 **Configure permissions** 部分中，你可以精确选择角色可以执行的操作。权限按组进行组织，例如 **Overview**、**Identity**、**Economy** 等，每个组上都有一个计数器（例如 *Overview (0/7)*），显示当前选择了该组中的多少个权限。

每个权限提供一个或多个访问级别：

* **Read**：查看数据或区域
* **Edit**：创建和修改
* **Delete**：删除

并非每个权限都具有这三种级别。某些区域会添加自己专门的操作，例如 **Activate**、**Submit** 或 **Review**。如果你不确定某个操作涵盖的内容，请将鼠标悬停在其旁边的 **(i)** 工具提示上以查看完整说明。例如，*Payouts 选项卡*上的 **Review** 操作说明它允许你"Approve and reject payouts"(批准和拒绝付款)。

若要快速操作，请使用批量控件：

* **Search**：筛选权限列表以查找特定项。
* **Toggle all permissions**：一次选择或清除所有权限。
* **Set read only**：在整个范围内仅选择 **Read** 框，使 **Edit** 和 **Delete** 保持清除状态。
* **Collapse all**：隐藏每个组的内容，使视图更简洁。

每个组还有自己的 **Select all** 和 **Set read only**，因此你可以一次配置一个区域。

![显示权限组的 Configure permissions 部分屏幕截图](https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/identity/dev-identity/user-roles-category-selected.jpg?fit=max\&auto=format\&n=Oa_DP1q6U1lat7c2\&q=85\&s=18a2e99f0363de481ec86a5ff0131c15)

权限设置正确后，滚动到底部并选择 **Save Role**。

## 将角色分配给用户

可以通过两种方式分配角色：从用户分配，或从角色分配。

**从用户分配：**

1. 在 **My Studios and Titles** 中，选择工作室旁边的**三点 (...) 菜单**，然后选择 **Users**。
2. 打开要更新的用户，并按游戏选择其角色。由于角色的作用域为游戏，因此请为用户需要该角色的每个游戏分配该角色。
3. 保存更改。

![按游戏为用户分配角色的屏幕截图](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-user-manage-roles.jpg?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=58ae4b3237a5ad03b373cbeccf95a12c)

**从角色分配：**

打开现有角色并选择其 **Members** 选项卡。在那里，你可以选择工作室中哪些用户应持有此角色以及针对哪些游戏。当你同时将多个人员加入同一角色时，此方法非常方便。

![角色上 Members 选项卡的屏幕截图](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-role-members.jpg?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=e86015d46073fe8c2ad1f8a98a4303f2)

## 摘要

角色可让你在工作室范围内灵活控制谁可以在 Game Manager 中执行哪些操作。定义角色，使用 Read/Edit/Delete（以及特定于区域的）控件调整其权限，然后按游戏将其分配给团队。只需更新一次角色，持有该角色的每个人都会保持同步。


## Related topics

- [Game Manager 快速入门](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/gamemanager/quickstart.md)
- [用于 PlayFab API 的 Microsoft Entra ID 身份验证](https://docs.xbox.com/zh-CN/services/playfab/identity/dev-identity/authentication/entra-id-api-authentication.md)
- [Insights 最佳实践](https://docs.xbox.com/zh-CN/services/playfab/data-analytics/legacy/insights/best-practices.md)
- [PlayFab 概念](https://docs.xbox.com/zh-CN/services/playfab/get-started/concepts.md)
- [Data Explorer 快速入门](https://docs.xbox.com/zh-CN/services/playfab/data-analytics/learn-data/data-explorer/quickstart.md)