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

# Início rápido - Biblioteca de cliente do PlayFab para C#

> Instale o pacote NuGet PlayFabAllSDK e faça sua primeira chamada à API de cliente do PlayFab em um aplicativo de console C# .NET Core usando o Visual Studio.

# Início rápido: biblioteca de cliente do PlayFab para C\#

Comece a usar a biblioteca de cliente do PlayFab para C#. Siga as etapas para instalar o pacote e experimentar o código de exemplo de uma tarefa básica.

Este início rápido ajuda você a fazer sua primeira chamada à API do PlayFab usando a biblioteca de cliente para C#.

[Documentação de referência da API](/pt-BR/services/playfab/api-references)

## Requisitos

* Uma [conta de desenvolvedor do PlayFab](https://developer.playfab.com).
* Uma instalação do [Visual Studio](https://visualstudio.microsoft.com/).

## Configuração do projeto em CSharp

Instalação

1. Abra o Visual Studio e selecione **Create a new project**.
2. Selecione **Console App (.Net Core)** para C#.
3. Instale o pacote NuGet do **PlayFabAllSDK**.

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/c-sharp/csharp-nuget-add.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=a87483676c9c787fa44ef10da4d0195a" alt="VS - Instalar o pacote nuget do SDK do PlayFab" width="918" height="336" data-path="images/playfab/sdks/c-sharp/csharp-nuget-add.png" />

Neste ponto, você deve conseguir compilar o projeto com êxito. A janela de saída deve conter algo semelhante ao exemplo a seguir.

```output theme={null}
1>------ Build started: Project: CSharpGettingStarted, Configuration: Debug Any CPU ------
1>  CSharpGettingStarted -> c:\dev\CSharpGettingStarted\CSharpGettingStarted\bin\Debug\CSharpGettingStarted.exe
========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========
```

## Configurar sua primeira chamada de API

Este guia fornece as etapas mínimas necessárias para fazer sua primeira chamada à API do PlayFab. A confirmação é feita por meio de uma impressão no console.

Seu novo projeto deve conter um arquivo chamado Program.cs, criado automaticamente pelo Visual Studio. Abra esse arquivo e substitua o conteúdo pelo código do exemplo mostrado abaixo (depois de colar o código, talvez seja necessário atualizar o arquivo para vê-lo). A confirmação da chamada de API será feita usando mensagens gravadas na saída do console.

```csharp theme={null}
using System;
using System.Threading;
using System.Threading.Tasks;
using PlayFab;
using PlayFab.ClientModels;

public static class Program
{
    private static bool _running = true;
    static void Main(string[] args)
    {
        PlayFabSettings.staticSettings.TitleId = "144"; // Please change this value to your own titleId from PlayFab Game Manager

        var request = new LoginWithCustomIDRequest { CustomId = "GettingStartedGuide", CreateAccount = true };
        var loginTask = PlayFabClientAPI.LoginWithCustomIDAsync(request);
        // If you want a synchronous result, you can call loginTask.Wait() - Note, this will halt the program until the function returns

        while (_running)
        {
            if (loginTask.IsCompleted) // You would probably want a more sophisticated way of tracking pending async API calls in a real game
            {
                OnLoginComplete(loginTask);
            }

            // Presumably this would be your main game loop, doing other things
            Thread.Sleep(1);
        }

        Console.WriteLine("Done! Press any key to close");
        Console.ReadKey(); // This halts the program and waits for the user
    }

    private static void OnLoginComplete(Task<PlayFabResult<LoginResult>> taskResult)
    {
        var apiError = taskResult.Result.Error;
        var apiResult = taskResult.Result.Result;

        if (apiError != null)
        {
            Console.ForegroundColor = ConsoleColor.Red; // Make the error more visible
            Console.WriteLine("Something went wrong with your first API call.  :(");
            Console.WriteLine("Here's some debug information:");
            Console.WriteLine(PlayFabUtil.GenerateErrorReport(apiError));
            Console.ForegroundColor = ConsoleColor.Gray; // Reset to normal
        }
        else if (apiResult != null)
        {
            Console.WriteLine("Congratulations, you made your first successful API call!");
        }

        _running = false; // Because this is just an example, successful login triggers the end of the program
    }
}
```

## Concluir e executar

Quando você executar este programa, a seguinte saída será exibida no console

"Congratulations, you made your first successful API call! Done! Press any key to close."

* Neste ponto, você pode começar a fazer outras chamadas de API e a criar seu jogo.

* Para criar utilitários de administração, consulte os arquivos de origem alternativos no arquivo zip do PlayFab CSharpSdk localizado em `{CSharpSdk}/PlayFabClientSDK/sources`.

Para ver a lista de todas as chamadas de API de cliente disponíveis ou muitos outros artigos, consulte [Referências da API do PlayFab](/pt-BR/services/playfab/api-references).


## Related topics

- [Início rápido do Unity](/pt-BR/services/playfab/sdks/unity3d/quickstart.md)
- [Início rápido de dados do jogador](/pt-BR/services/playfab/player-progression/player-data/quickstart.md)
- [Início rápido do plug-in Multiplayer para Unity](/pt-BR/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-plugin-quickstart.md)
- [Início rápido do plug-in do Party para Unity](/pt-BR/services/playfab/multiplayer/networking/party-unity-plugin-quickstart.md)
- [Início rápido da Unreal Engine](/pt-BR/services/playfab/sdks/unreal/quickstart.md)