Início rápido: definir e obter dados do jogador

Nas APIs do PlayFab, os nomes das funções utilizam o termo UserData. No Game Manager, esse conceito é descrito como Player Data. Eles são idênticos e intercambiáveis.

Comece a usar os dados do jogador do PlayFab. Este início rápido mostra como definir e recuperar dados do jogador usando C# no Unity e usando o CloudScript do PlayFab. Os dados do jogador são informações que se aplicam a um jogador individual ou a um grupo de jogadores (dados compartilhados) e são armazenados como pares de chave/valor (KVPs) pelo PlayFab. Este artigo aborda as chamadas de API de cliente, que são seguras para chamar a partir de qualquer processo ou contexto. Ele também aborda as chamadas de API de servidor, que devem ser feitas somente a partir de um processo de servidor dedicado que você controla ou de uma chamada do CloudScript cuidadosamente protegida. As APIs de servidor exigem sua chave secreta de desenvolvedor. A chave não deve ser fornecida ao seu cliente nem publicada com ele.

Requisitos

Uma conta de desenvolvedor do PlayFab.
Uma cópia instalada do Unity Editor. Para instalar o Unity para uso pessoal por meio do Unity Hub, ou o Unity+ para uso profissional, consulte Baixar o Unity.

O PlayFab Unity3D SDK oferece suporte ao Unity Editor versão 5.3 (lançado em dezembro de 2015) e posteriores.

Um projeto do Unity pode ser:
- Um projeto totalmente novo. Para obter mais informações, consulte Iniciando o Unity pela primeira vez.
- Um projeto de tutorial guiado. Para obter mais informações, consulte Introdução ao Unity.
- Um projeto existente.
O PlayFab Unity3D SDK.

Para obter informações sobre como configurar o PlayFab Unity3D SDK, consulte o artigo Início rápido: biblioteca de cliente do PlayFab para C# no Unity. Esse artigo garante que você tenha uma conta do PlayFab e que tenha configurado corretamente o Unity3D SDK.

Sobre os exemplos de código

Os exemplos em C# deste artigo foram escritos para o SDK do Unity. O SDK do Unity usa um modelo orientado a eventos para tratar tarefas não síncronas. Para executar o código de exemplo usando o SDK do C#, você precisa modificar o código para usar um modelo de Task assíncrono. Os métodos que precisam ser modificados têm Async acrescentado ao nome do método na assinatura. Por exemplo, SetObject no SDK do Unity se torna SetObjectAsync no SDK do C#. Para obter mais informações, consulte Programação assíncrona com async e await. Embora você possa usar um projeto do Unity existente, este início rápido pressupõe que você está usando o exemplo criado ao concluir o Início rápido: biblioteca de cliente do PlayFab para C# no Unity.

Dados do jogador no Game Manager

Você sempre pode obter e definir dados do jogador pelo Game Manager executando as etapas a seguir.

Abra o Game Manager. Se você não estiver familiarizado com ele, consulte o Início rápido do Game Manager.
Selecione a guia Players.
Selecione o nome do Player para acessar a guia Players Account.
Selecione a guia Player Data para ver os dados dele.

Adicionar um método para definir e recuperar os dados do jogador

No Unity Editor, abra seu projeto de exemplo.
Na janela Project, abra Assets > Scripts e, em seguida, abra o script PlayFabLogin.
No Visual Studio, adicione o seguinte à instrução using: using System.Collections.Generic;

Para definir os dados do jogador, adicione um método SetUserData à classe PlayFabLogin. SetUserData usa o método UpdateUserData para criar ou atualizar os dados do jogador conectado. O método cria (ou atualiza, se os pares de chave-valor (KVPs) já existirem) os KVPs Ancestor, com o valor Arthur, e Successor, com o valor Fred.

void SetUserData() {
    PlayFabClientAPI.UpdateUserData(new UpdateUserDataRequest() {
        Data = new Dictionary<string, string>() {
            {"Ancestor", "Arthur"},
            {"Successor", "Fred"}
        }
    },
    result => Debug.Log("Successfully updated user data"),
    error => {
        Debug.Log("Got error setting user data Ancestor to Arthur");
        Debug.Log(error.GenerateErrorReport());
    });
}

Para obter os dados do jogador, adicione um método GetUserData à classe PlayFabLogin. SetUserData usa o método GetUserData para recuperar os dados do jogador especificado.

void GetUserData(string myPlayFabId) {
    PlayFabClientAPI.GetUserData(new GetUserDataRequest() {
        PlayFabId = myPlayFabId,
        Keys = null
    }, result => {
        Debug.Log("Got user data:");
        if (result.Data == null || !result.Data.ContainsKey("Ancestor")) Debug.Log("No Ancestor");
        else Debug.Log("Ancestor: "+result.Data["Ancestor"].Value);
    }, (error) => {
        Debug.Log("Got error retrieving user data:");
        Debug.Log(error.GenerateErrorReport());
    });
}

Chame SetUserData e GetUserData no método OnLoginSuccess.

private void OnLoginSuccess(LoginResult result) {
    Debug.Log("Congratulations, you made your first successful API call!");
    SetUserData();
    GetUserData(result.PlayFabId);
}

Salve o arquivo.

Executar o exemplo

No Unity Editor, selecione o botão de reprodução. Em caso de êxito, os resultados das chamadas serão exibidos na janela do console.

XBOX Services

PlayFab

Início rápido de dados do jogador

Início rápido: definir e obter dados do jogador

Requisitos

Sobre os exemplos de código

Dados do jogador no Game Manager

Adicionar um método para definir e recuperar os dados do jogador

Executar o exemplo

Confira também

​Início rápido: definir e obter dados do jogador

​Requisitos

​Sobre os exemplos de código

​Dados do jogador no Game Manager

​Adicionar um método para definir e recuperar os dados do jogador

​Executar o exemplo

​Confira também

Início rápido: definir e obter dados do jogador

Requisitos

Sobre os exemplos de código

Dados do jogador no Game Manager

Adicionar um método para definir e recuperar os dados do jogador

Executar o exemplo

Confira também