Quickstart: C++ for Linux

Get started with the PlayFab Client library for C++. Follow steps to install the package and try out example code for a basic task. This quickstart helps you make your first PlayFab API call in the using the Client library for C++. This quickstart was written using Ubuntu 18.04 LTS. API reference documentation | Library source code

Requirements

A PlayFab developer account.

Linux C++ Project Setup

Install the following (sudo apt-get install ____ on Ubuntu):
- g++
- gdb
- make
- cmake
- libjsoncpp-dev
- libcurl4-openssl-dev
- git-all
Clone the PlayFab cross-platform (CPP) SDK into your project folder.

To verify that your installation is correct. Create a main.cpp and insert the “Hello World” code shown below.

// main.cpp: entry point for the console application

#include <iostream>

int main()
{
    std::cout << "Hello World" << std::endl;
    return 0;
}

If you’re using an IDE, make sure to:

Add the following folders to your sources:
- XPlatCppSdk/cppsdk/source/playfab
Add the following folders to your include directories:
- XPlatCppSdk/cppsdk
- XPlatCppSdk/cppsdk/include
Link the following libraries:
- jsoncpp
- curl
- pthread

Otherwise, create a file named CMakeLists.txt and copy the build commands shown below.

cmake_minimum_required(VERSION 3.10)
set(CMAKE_CXX_STANDARD 14)

project(PlayFab_Test)

file(GLOB PF_SOURCE XPlatCppSdk/cppsdk/source/playfab/*.cpp)
add_executable(PlayFab_Test ${PF_SOURCE} main.cpp)

include_directories(XPlatCppSdk/cppsdk)
include_directories(XPlatCppSdk/cppsdk/include)
target_link_libraries(PlayFab_Test -ljsoncpp -lcurl -lpthread)

Build and run the project from inside your IDE, or open a Terminal prompt and run:
- cmake .
- make
- ./PlayFab_Test

Set up your first API call

This guide provides the minimum steps to make your first PlayFab API call, without any GUI or on-screen feedback. Confirmation is performed using a console print statement. First, replace the contents of main.cpp with the content shown below.

// main.cpp: entry point for the console application

#include "playfab/PlayFabClientDataModels.h"
#include "playfab/PlayFabClientApi.h"
#include "playfab/PlayFabSettings.h"
#include <unistd.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.GenerateReport().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;
}

Finish and execute

Build and run the project inside your IDE, or open Terminal and run:
- ./PlayFab_Test
When it loads, the following text is displayed:
- “Congratulations, you made your first successful API call!”
Start making other API calls, and build your title.

XBOX Services

PlayFab

Quickstart C++ for Linux

Quickstart: C++ for Linux

Requirements

Linux C++ Project Setup

Set up your first API call

Finish and execute

​Quickstart: C++ for Linux

​Requirements

​Linux C++ Project Setup

​Set up your first API call

​Finish and execute

Quickstart: C++ for Linux

Requirements

Linux C++ Project Setup

Set up your first API call

Finish and execute