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

# 适用于 Windows 的 C++ 快速入门

> 在 Windows 的 Visual Studio 中设置原生 C++ 项目，并使用 PlayFab XPlatCppSdk 客户端库进行首次 PlayFab API 调用。

# 快速入门：适用于 Windows 的 C++

<Note>
  该 SDK 正在被新的 [PlayFab C SDK](/services/playfab/sdks/c) 取代。新 SDK 支持 Windows (Win32)。随着时间的推移，我们将扩展新 SDK 支持的平台集合。
</Note>

开始使用适用于 C++ 的 PlayFab 客户端库。按照步骤安装包并试用基本任务的示例代码。

本快速入门可帮助您使用 C++ 客户端库进行首次 PlayFab API 调用。

[API 参考文档](/services/playfab/api-references) | [库源代码](https://github.com/PlayFab/XPlatCppSdk)

## 要求

* 一个 [PlayFab 开发者帐户](https://developer.playfab.com)。
* 已安装 [Visual Studio](https://visualstudio.microsoft.com/)。

## Windows C++ 项目设置

安装：

1. 下载并安装 [PlayFab 跨平台 (CPP) SDK](https://github.com/PlayFab/XPlatCppSdk)。
2. 创建一个新的 C++ 控制台项目。
3. 在 **解决方案资源管理器** 中右键单击项目，选择 **管理 NuGet 包**，然后使用 "playfab" 进行搜索。将会有几个匹配项。选择 **com.playfab.xplatcppsdk.vXXX**
4. 验证您的项目在 x64 Release 下能够编译

## 设置您的首次 API 调用

本指南提供了进行首次 PlayFab API 调用所需的最少步骤，没有任何 GUI 或屏幕反馈。确认通过控制台打印语句进行。

1. 在 Visual Studio 中，打开您的 C++ 控制台应用程序。
2. 打开该项目的主 cpp 文档。如果您未重命名项目，文件名将类似于 ConsoleApplication1.cpp\`。
3. 使用下面显示的代码替换该文件的内容。

```cpp theme={null}
// ConsoleApplication1.cpp : Defines the entry point for the console application.
//

#include "playfab/PlayFabError.h"
#include "playfab/PlayFabClientDataModels.h"
#include "playfab/PlayFabClientApi.h"
#include "playfab/PlayFabSettings.h"
#include "playfab/PlayFabApiSettings.h"
#include <windows.h>

using namespace PlayFab;
using namespace ClientModels;

bool finished = false;

void OnLoginSuccess(const LoginResult& result, void* customData)
{
    printf("Congratulations, you made your first successful API call!\n");
    finished = true;
}

void OnLoginFail(const PlayFabError& error, void* customData)
{
    printf("Something went wrong with your first API call.\n");
    printf("Here's some debug information:\n");
    printf(error.GenerateErrorReport().c_str());
    printf("\n");
    finished = true;
}

int main()
{
    PlayFabSettings::staticSettings->titleId = ("144");

    LoginWithCustomIDRequest request;
    request.CreateAccount = true;
    request.CustomId = "GettingStartedGuide";

    PlayFabClientAPI::LoginWithCustomID(request, OnLoginSuccess, OnLoginFail);

    while (PlayFabClientAPI::Update() != 0)
        Sleep(1);

    printf("Press enter to exit\n");
    getchar();
    return 0;
}
```

## 完成并执行

1. 要运行项目，请选择 **调试** > **开始调试**。
2. 加载时，将显示以下文本：

   "Congratulations, you made your first successful API call!"
3. 开始进行其他 API 调用，并构建您的游戏。


## Related topics

- [适用于 GDK 的 C/C++ 快速入门](/zh-CN/services/playfab/sdks/playfab-cpp/quickstart-gdk.md)
- [适用于 Corona 的 Lua 快速入门](/zh-CN/services/playfab/sdks/lua/quickstart-corona.md)
- [适用于 Linux 的 C++ 快速入门](/zh-CN/services/playfab/sdks/playfab-cpp/quickstart-linux.md)
- [快速入门 - 适用于 C# 的 PlayFab 客户端库](/zh-CN/services/playfab/sdks/c-sharp/quickstart.md)
- [适用于 Windows 的 PlayFab Services](/zh-CN/services/playfab/sdks/platforms/windows.md)