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

# 试验

> 读取游戏的 A/B 试验、记分卡、处理分配和排除组。

`playfab experiment` 命令系列属于实验性功能。其 CLI 接口可能会根据反馈而更改或被删除。

读取游戏的 PlayFab Experimentation A/B 试验。这些命令只执行读取;若要创建、启动或停止试验,请使用 [`playfab api`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/api) 调用相应的 API。

| 命令 | PlayFab API 路径 | 说明 |
| - | - | - |
| `playfab experiment list` | `/Experimentation/GetExperiments` | 列出游戏的试验。 |
| `playfab experiment scorecard get` | `/Experimentation/GetLatestScorecard` | 获取试验的最新记分卡。 |
| `playfab experiment treatment get` | `/Experimentation/GetTreatmentAssignment` | 获取实体的处理分配。 |
| `playfab experiment exclusion-group list` | `/Experimentation/GetExclusionGroups` | 列出排除组。 |

| 命令 | 选项 |
| - | - |
| `experiment list` | 无。 |
| `experiment scorecard get` | `--experiment-id`(必需)。 |
| `experiment treatment get` | `--entity-id` 和 `--entity-type`(两者均为必需)。对于玩家,请使用 `--entity-type title_player_account` 传递其游戏玩家帐户 ID,而不是其主玩家帐户 ID;[`playfab player account get`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/player) 会将其返回为 `UserInfo.TitleInfo.TitlePlayerAccount.Id`。 |
| `experiment exclusion-group list` | 无。 |

```bash theme={null}
xbox --playfab-title-id ABC123 playfab experiment list
xbox --playfab-title-id ABC123 playfab experiment scorecard get --experiment-id 11111111-2222-3333-4444-555555555555
xbox --playfab-title-id ABC123 playfab experiment treatment get --entity-id TITLEPLAYER123 --entity-type title_player_account
xbox --playfab-title-id ABC123 playfab experiment exclusion-group list
```

## 表格输出

以下命令接受 `--output table`;另外两个命令不接受。请参阅
[表格输出](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands.md#table-output)。

| 命令 | 列 |
| - | - |
| `playfab experiment list` | `ID`、`NAME`、`STATE`、`TYPE` |
| `playfab experiment exclusion-group list` | `GROUP ID`、`NAME`、`DESCRIPTION` |

`STATE` 为 `New`、`Started`、`Stopped` 或 `Deleted`,`TYPE` 为 `Active` 或
`Snapshot`。试验的变体、细分和计划仅出现在 JSON 输出中。

```bash theme={null}
xbox --playfab-title-id ABC123 playfab experiment list --output table
```

```text theme={null}
ID                                    NAME            STATE    TYPE
------------------------------------  --------------  -------  --------
11111111-2222-3333-4444-555555555555  weapon-balance  Started  Active
22222222-3333-4444-5555-666666666666  store-layout    New      Snapshot
```


## Related topics

- [Experiment](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/experiment.md)
- [ExperimentVariant](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/experimentvariant.md)
- [ExperimentVariable](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/experimentvariable.md)
- [ExperimentRequestOrigin](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/experimentrequestorigin.md)
- [实验关键术语](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/game-configuration/experiments/experimentation-key-terms.md)
