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 Game Controller é distribuída como uma biblioteca Jetpack para jogos que usam um sistema de build baseado em Gradle (incluindo o Android Studio). 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 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
Para ver uma amostra que integra a biblioteca Game Controller, consulte o repositório games-samples.
Próximas etapas
Consulte os seguintes guias para continuar integrando a biblioteca Game Controller ao seu jogo:
- Usar a biblioteca Game Controller
- Adicionar compatibilidade com mouse
- Adicionar mapeamentos personalizados para controles