Pular para o conteúdo principal
Este documento lista os pré-requisitos e requisitos básicos necessários para integrar o PlayFab Party aos seus aplicativos iOS ou macOS. Depois de concluir as etapas específicas da plataforma, confira o Início rápido do PlayFab Party para concluir a introdução ao PlayFab Party.

Pré-requisitos

Antes de iniciar este tutorial, verifique se os seguintes pré-requisitos foram atendidos:
  1. Você criou uma conta de desenvolvedor do PlayFab
  2. Você criou um título do PlayFab e seu título foi incluído na lista de permissões do PlayFab Party
  3. Você tem o Xcode versão 10.2.1 ou superior instalado
  4. Você tem acesso ao repositório de plataformas do PlayFab Party
  5. Você criou uma conta de desenvolvedor da Apple que pode ser usada para assinar seu aplicativo para implantação.
OBSERVAÇÃO: Se você planeja usar o simulador do Xcode para testes, precisará direcionar seu aplicativo para a arquitetura de 64 bits ($(ARCHS_STANDARD_64_BIT)). Atualmente, não há suporte para simuladores de 32 bits.

Incluindo as bibliotecas e os arquivos de cabeçalho necessários

Cabeçalhos

Frameworks

  • Você precisará vincular seu aplicativo aos seguintes frameworks, que também se encontram nos pacotes de distribuição do PlayFab Party.
    • iOS: PlayFabParty
    • macOS: PlayFabPartyMac
As bibliotecas SSL são compiladas a partir do Open SSL versão XXX. Use uma versão do OpenSSL XXX ou superior
Inclusões de cabeçalho Cabeçalhos do Party Além dos arquivos de biblioteca e cabeçalhos acima, você também precisará das bibliotecas e cabeçalhos do PlayFab SDK e de quaisquer outras dependências específicas da plataforma de que seu aplicativo precise. Confira a organização dos arquivos de projeto do exemplo para iOS para obter mais informações.

Etapas para fazer o PlayFab Party funcionar no iOS ou no macOS

Como a biblioteca principal do Party é escrita em C++, ela pode ser acessada diretamente a partir de código Objective-C++. Por conveniência, criamos uma classe wrapper simples em Objective-C++ para acessar a funcionalidade da biblioteca do Party. Em linhas gerais, você vai querer uma classe que tenha acesso aos métodos da API do Party para criar uma rede, conectar-se a uma rede e enviar mensagens por uma rede. A SimpleClientClass é mostrada como exemplo no nosso aplicativo de demonstração para iOS.
A ponte de objetos acima é apoiada por um arquivo de implementação em C++ puro que chama o NetworkManager.cpp, que, por sua vez, chama as APIs do Party. Veja um trecho de exemplo que mostra as várias camadas: A interface Objective-C SimpleClient expõe um método para inicializar o PlayFab Party.
A implementação do SimpleClient também inclui uma referência ao objeto C++ que chama as APIs do Party por meio do gerenciador de rede.
O SimpleClientImpl é uma classe C++ que faz o trabalho pesado de criar a rede do Party, conforme mostrado no trecho de código abaixo:
No trecho de código acima, o SimpleClient chama NetworkManager::CreateAndConnectToNetwork(), que, por sua vez, chama a API bruta do Party exposta em Party.h
De forma semelhante, cada método da interface Objective-C SimpleClient é mapeado para a API do Party por meio do SimpleClientImpl e do NetworkManager.

Comentários

Se o PlayFab Party for usado para chat de voz, o aplicativo precisará receber acesso ao microfone. Para isso, verifique se a seguinte propriedade foi adicionada ao arquivo Info.plist do aplicativo.

Próximas etapas

Depois de concluir as etapas específicas da plataforma para integrar a biblioteca do Party ao seu aplicativo iOS ou macOS, consulte o Início rápido do PlayFab Party para concluir a introdução ao PlayFab Party.
Última modificação em 20 de outubro de 2026