Biblioteca Game Controller Parte do Android Game Development Kit.

A biblioteca Game Controller, também conhecida como Paddleboat, ajuda você a implementar compatibilidade robusta para controles de jogo. A biblioteca fornece o seguinte:

  • Callbacks para detectar conexões e desconexões do controle
  • Informações do controle, incluindo estilo de botão e layout
  • Dados de entrada do controle, padronizados em designs modernos de controles direcionais analógicos duplos
  • Recursos estendidos em controles compatíveis, incluindo vibração, luzes, dados do eixo de movimento e status da bateria
  • Capacidade de ler entradas de mouses físicos e virtuais
  • Capacidade de especificar dados personalizados de mapeamento do controle para dispositivos específicos

Requisitos de compatibilidade

A biblioteca Game Controller tem estes requisitos mínimos de compatibilidade:

  • Android 4.4 (nível 19 da API) ou mais recente
  • Android NDK versão 21 ou mais recente

Integrar

A biblioteca Game Controller é distribuída em dois formatos: como uma biblioteca Jetpack para jogos, usando um sistema de compilação baseado em Gradle (incluindo o Android Studio), e como arquivos discretos para jogos que usam sistemas de compilação personalizados.

Para um exemplo que integra a biblioteca Game Controller, consulte o repositório games-samples.

Biblioteca Jetpack

A página Android Games do Jetpack tem instruções de integração para adicionar a dependência da biblioteca Game Controller ao arquivo build.gradle do jogo.

A versão da Game Controller do Jetpack é uma biblioteca estática criada em relação à biblioteca compartilhada do ambiente de execução C++.

Depois de atualizar o arquivo build.gradle, será necessário adicionar a seguinte linha ao arquivo CMakeLists.txt principal do jogo:

find_package(games-controller REQUIRED CONFIG)

Você também precisa adicionar a seguinte entrada à lista de bibliotecas no comando target_link_libraries da biblioteca compartilhada principal do jogo:

games-controller::paddleboat_static

Arquivos discretos

A distribuição de arquivos .zip do Android Game Development Kit inclui arquivos principais e de biblioteca para a biblioteca Game Controller. Os seguintes arquivos precisam ser incluídos no seu projeto para usar a biblioteca Game Controller:

  • O arquivo classes.jar, que contém as partes de bytecode Dalvik da biblioteca Game Controller. Esse arquivo está localizado em libs/classes.jar.
  • O arquivo principal de interface paddleboat.h. Esse arquivo está localizado em include/paddleboat/paddleboat.h.
  • O arquivo de biblioteca compartilhada libpaddleboat.so ou o arquivo de biblioteca estática libpaddleboat-static.a. Esses arquivos são encontrados nos subdiretórios de configuração do build no diretório libs.

Os subdiretórios de configuração do build no diretório raiz libs são categorizados por:

  • arquitetura ABI;
  • nível mínimo da API Android;
  • versão do Android NDK;
  • versão da biblioteca do ambiente de execução C++;
  • Configuração do build de depuração ou de lançamento.

Por exemplo, o subdiretório arm64-v8a_API16_NDK21_cpp_shared_Release contém arquivos de biblioteca:

  • para ABI ARM de 64 bits;
  • para API de nível 16, no mínimo;
  • criados com base na versão 21 do NDK;
  • criados com base na versão da biblioteca compartilhada do ambiente de execução C++;
  • para configuração do build de lançamento.

O arquivo libpaddleboat_static.a está localizado diretamente no subdiretório. O arquivo libpaddleboat.so está localizado em lib/paddleboat/ dentro do subdiretório.

Próximas etapas

Consulte os seguintes guias para continuar integrando a biblioteca Game Controller ao seu jogo: