> ## 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](/zh-TW/services/playfab/sdks/c) 取代。新的 SDK 支援 Windows (Win32)。我們會逐步擴充新 SDK 支援的平台。
</Note>

開始使用適用於 C++ 的 PlayFab Client 程式庫。請依照步驟安裝套件，並試用基本工作的範例程式碼。

本快速入門可協助您使用適用於 C++ 的 Client 程式庫進行第一次 PlayFab API 呼叫。

[API 參考文件](/zh-TW/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. 在 **Solution Explorer** 中以滑鼠右鍵按一下專案，選取 **Manage NuGet packages**，然後使用 "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. 若要執行專案，請選取 **Debug** > **Start Debugging**。
2. 載入時，會顯示下列文字：

   "Congratulations, you made your first successful API call!"
3. 開始進行其他 API 呼叫，並建置您的遊戲。


## Related topics

- [適用於 GDK 的 C/C++ 快速入門](/zh-TW/services/playfab/sdks/playfab-cpp/quickstart-gdk.md)
- [適用於 Linux 的 C++ 快速入門](/zh-TW/services/playfab/sdks/playfab-cpp/quickstart-linux.md)
- [Unity 快速入門](/zh-TW/services/playfab/sdks/unity3d/quickstart.md)
- [快速入門 - 適用於 C# 的 PlayFab 用戶端程式庫](/zh-TW/services/playfab/sdks/c-sharp/quickstart.md)
- [適用於 Postman 的 PlayFab REST API 集合快速入門](/zh-TW/services/playfab/sdks/postman/postman-quickstart.md)