Android Games

A biblioteca Android Games espelha o SDK do Android Game, que está disponível como um download binário. Você pode usar a biblioteca AndroidX em vez de fazer o download e integrar manualmente o SDK para Jogos do Android ao seu build.

Para mais informações sobre o SDK para jogos do Android, consulte a documentação do SDK e as notas da versão do SDK.

Esta tabela lista todos os artefatos no grupo androidx.games.

Artefato Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
games-activity 3.0.1 - - -
games-controller 2.0.1 - - -
games-frame-pacing 2.1.0 - - -
games-memory-advice 2.0.1 - 2.1.0-beta01 -
games-text-input 3.0.1 - - -
games-performance-tuner - - 2.0.0-beta01 -
Esta biblioteca foi atualizada pela última vez em 20 de março de 2024

Requisitos

games-memory-advice

A API MemoryAdvice exige que seu aplicativo seja criado com uma das seguintes versões do NDK:

  • r20.*
  • r21.*
  • r23.*

Declarar dependências

Para adicionar uma dependência ao jogo, adicione o repositório Maven do Google ao seu projeto. Confira mais informações no repositório Maven do Google.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle para seu app ou módulo. A biblioteca games-activity integrou a mesma versão da biblioteca game-text-input, portanto, os apps GameActivity não podem incluir a dependência game-text-input novamente:

Groovy

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation "androidx.games:games-frame-pacing:2.1.0"

    // To use the Android Performance Tuner
    implementation "androidx.games:games-performance-tuner:"

    // To use the Games Activity library
    implementation "androidx.games:games-activity:3.0.1"

    // To use the Games Controller Library
    implementation "androidx.games:games-controller:2.0.1"

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation "androidx.games:games-text-input:3.0.1"
}

Kotlin

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab = true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation("androidx.games:games-frame-pacing:2.1.0")

    // To use the Android Performance Tuner
    implementation("androidx.games:games-performance-tuner:")

    // To use the Games Activity library
    implementation("androidx.games:games-activity:3.0.1")

    // To use the Games Controller Library
    implementation("androidx.games:games-controller:2.0.1")

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation("androidx.games:games-text-input:3.0.1")
}
}

Para ver mais informações sobre dependências, consulte Adicionar dependências de compilação.

Adicionar propriedades do Gradle

Talvez seja necessário adicionar propriedades ao arquivo gradle.properties localizado no mesmo diretório que o arquivo build.gradle do seu app ou módulo. Se o arquivo gradle.properties não existir, crie-o.

Se você estiver usando o Android Studio 4.0, verifique se gradle.properties contém as seguintes linhas:

# Enables experimental Prefab
android.enablePrefab=true
# Tell Android Studio we are using AndroidX
android.useAndroidX=true

Se estiver usando o Android Studio 4.1 ou uma versão mais recente, verifique se gradle.properties contém as seguintes linhas:

# Tell Android Studio we are using AndroidX
android.useAndroidX=true

Adicionar pacotes com o CMake

Para disponibilizar os pacotes importados do SDK do Game, adicione o seguinte ao arquivo CMakeLists.txt do app principal:

# Add the packages from the Android Game SDK
find_package(games-frame-pacing REQUIRED CONFIG)
find_package(games-performance-tuner REQUIRED CONFIG)

Isso permitirá que você inclua arquivos principais do SDK do Android Game no código do jogo:

#include "swappy/swappyGL.h"
#include "tuningfork/tuningfork.h"

No arquivo CMakeLists.txt do app principal, localize target_link_libraries para a biblioteca compartilhada principal. Adicione as referências às bibliotecas estáticas do SDK do Android Game para incluí-las na sua biblioteca compartilhada:

target_link_libraries(...
  games-frame-pacing::swappy_static
  games-performance-tuner::tuningfork_static
  ...)

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Games-Memory-Advice: versão 2.1

Versão 2.1.0-beta01

29 de novembro de 2023

Lançamento de androidx.games:games-memory-advice:2.1.0-beta01. A versão 2.1.0-beta01 contém estas confirmações.

Versão 2.1.0-alpha01

15 de novembro de 2023

Lançamento de androidx.games:games-memory-advice:2.1.0-alpha01. A versão 2.1.0-alpha01 contém estas confirmações.

Novos recursos

  • O modelo de memória da biblioteca foi atualizado para fazer previsões melhores.

Mudanças na API

  • Foi adicionada uma nova API getAvailableMemory() que retorna uma estimativa para a quantidade de memória que pode ser alocada com segurança em bytes

Versão 2.1.0-alpha01

26 de julho de 2023

Lançamento de androidx.games:games-memory-advice:2.1.0-alpha01. A versão 2.1.0-alpha01 contém estas confirmações.

Mudanças na API

  • Adicionar função GetAvailableMemory

Correções de bugs

  • Atualizar o modelo Memory Advice
  • Correção do destino de build memory_advice compartilhado.

Games-Memory-Advice: versão 2.0

Versão 2.0.1

20 de setembro de 2023

Lançamento de androidx.games:games-memory-advice:2.0.1. A versão 2.0.1 contém estas confirmações.

Correções de bugs

  • Foi corrigida a falha que ocorria na linha de execução do inspetor de estado quando ela não estava conectada à JVM

Versão 2.0.0

6 de setembro de 2023

Lançamento de androidx.games:games-memory-advice:2.0.0. A versão 2.0.0 contém estas confirmações.

Principais recursos da versão 2.0.0

  • Um novo modelo de ML foi treinado e lançado nesta versão.
  • Uma API para prever a quantidade de memória livre é implementada.

Versão 2.0.0-rc01

26 de julho de 2023

Lançamento de androidx.games:games-memory-advice:2.0.0-rc01. A versão 2.0.0-rc01 contém essas confirmações.

Novos recursos

  • Inclusão de um novo modelo para prever melhor a memória restante.

Correções de bugs

  • Correção do Memory Advice que não funcionava com um STL compartilhado.

Versão 2.0.0-beta04

24 de maio de 2023

Lançamento de androidx.games:games-memory-advice:2.0.0-beta04. A versão 2.0.0-beta04 contém estas confirmações.

Novos recursos

  • Atualização do modelo de aprendizado de máquina da biblioteca, o que permite melhores resultados para smartphones mais recentes.

Versão 2.0.0-beta03

5 de abril de 2023

Lançamento de androidx.games:games-memory-advice:2.0.0-beta03. A versão 2.0.0-beta03 contém estas confirmações.

Correções de bugs

  • Correção de um bug em que a biblioteca não conseguia carregar corretamente os recursos necessários do TensorFlow Lite.

Versão 2.0.0-beta02

22 de março de 2023

Lançamento de androidx.games:games-memory-advice:2.0.0-beta02. A versão 2.0.0-beta02 contém estas confirmações.

Correções de bugs

  • Correção de um bug que impedia a versão estática da biblioteca ser vinculada corretamente

Versão 2.0.0-beta01

22 de fevereiro de 2023

Lançamento de androidx.games:games-memory-advice:2.0.0-beta01. A versão 2.0.0-beta01 contém estas confirmações.

Novos recursos

  • Não houve mudanças.

Versão 2.0.0-alpha01

8 de fevereiro de 2023

Lançamento de androidx.games:games-memory-advice:2.0.0-alpha01. A versão 2.0.0-alpha01 contém estas confirmações.

Mudanças na API

  • Aumento da versão principal devido à refatoração de arquivos de build.

Correções de bugs

  • A configuração incorreta dos recursos da biblioteca agora gera um erro em vez de uma falha.

Games-Memory-Advice: versão 1.0.0

Versão 1.0.0-beta03

9 de novembro de 2022

Lançamento de androidx.games:games-memory-advice:1.0.0-beta03. A versão 1.0.0-beta03 contém estas confirmações.

Novos recursos

  • Não houve mudanças.

Versão 1.0.0-beta01

9 de março de 2022

Lançamento de androidx.games:games-memory-advice:1.0.0-beta01. A versão 1.0.0-beta01 contém estas confirmações.

  • Nenhuma mudança desde a versão 1.0.0-alpha01.

Versão 1.0.0-alpha01

23 de fevereiro de 2022

Lançamento de androidx.games:games-memory-advice:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estas confirmações.

Novos recursos

  • Essa biblioteca C possibilita consultar e receber callbacks para mudanças no estado da memória de um dispositivo que executa um jogo.

Mudanças na API

  • Essa é a versão inicial da biblioteca de conselhos sobre memória. Veja o cabeçalho em include/memory_advice/memory_advice.h para a API completa.

Contribuição externa

Games-Activity: versão 3.0

Versão 3.0.1

20 de março de 2024

Lançamento de androidx.games:games-activity:3.0.1 e androidx.games:games-text-input:3.0.1. A versão 3.0.1 contém estas confirmações.

Correções de bugs

  • Foi corrigido um problema com caracteres especiais sendo digitados e exibidos

Versão 3.0.0

6 de março de 2024

Lançamento de androidx.games:games-activity:3.0.0 e androidx.games:games-text-input:3.0.0. A versão 3.0.0 contém estas confirmações.

Principais recursos da versão 3.0.0

  • O app GameTextInput foi reformulado para ser usado em jogos.
  • Algumas interfaces em ambas as bibliotecas foram alteradas em relação à versão 2.0.0.

Correções de bugs

  • Correção de problemas de compatibilidade com NDKs antigos.
  • Correção de problemas de compilação do Windows

Versão 3.0.0-rc01

21 de fevereiro de 2024

Lançamento de androidx.games:games-activity:3.0.0-rc01 e androidx.games:games-text-input:3.0.0-rc01. A versão 3.0.0-rc01 contém estas confirmações.

Correções de bugs

  • Correção do congelamento em que os eventos do teclado não eram tratados adequadamente pelo looper.

Versão 3.0.0-beta01

29 de novembro de 2023

Lançamento de androidx.games:games-activity:3.0.0-beta01 e androidx.games:games-text-input:3.0.0-beta01. A versão 3.0.0-beta01 contém estas confirmações.

Versão 3.0.0-alpha01

15 de novembro de 2023

Lançamento de androidx.games:games-activity:3.0.0-alpha01 e androidx.games:games-text-input:3.0.0-alpha01. A versão 3.0.0-alpha01 contém estas confirmações.

Mudanças na API

  • O tamanho das estruturas GameActivityMotionEvent e GameActivityCallbacks mudou.
  • O onEditorAction muda o tipo de retorno de booleano para nulo.
  • O setImeEditorInfo agora espera parâmetros de tipo enumerado, não números inteiros
  • as funções internas de GameActivityEvents foram movidas para GameActivityEvents_internal.h.
  • Os tipos de entrada de GameTextInput também são enumerações, não números inteiros.

Games-Activity: versão 2.1

Versão 2.1.0-alpha02

6 de setembro de 2023

Lançamento de androidx.games:games-activity:2.1.0-alpha02 e androidx.games:games-text-input:2.1.0-alpha02. A versão 2.1.0-alpha02 contém estas confirmações.

Correções de bugs

  • A compatibilidade com dispositivos de 32 bits foi aprimorada.

Versão 2.1.0-alpha01

26 de julho de 2023

Lançamento de androidx.games:games-activity:2.1.0-alpha01. A versão 2.1.0-alpha01 contém estas confirmações.

Novos recursos

  • Capacidade de substituir a criação da instância do SurfaceView
  • Adicionar relatórios de versão do SDK

Mudanças na API

  • Use int64_t em vez de long para historicalEventTimes a fim de evitar a sobrecarga em sistemas de 32 bits.
  • Adicionar o método GameActivity_restartInput
  • Adicionar um callback nativo para processar a mudança na visibilidade do teclado de software

Correções de bugs

  • Otimizar o gerenciamento de eventos de toque
  • Destruição correta de um GameActivityMotionEven
  • Corrigir o cálculo do índice GameActivityMotionEvent_getHistoricalAxisValue
  • Corrigir bitmasks para o filtro de movimento

Games-Activity: versão 2.0

Versão 2.0.2

24 de maio de 2023

Lançamento de androidx.games:games-activity:2.0.2. A versão 2.0.2 contém estas confirmações.

Correções de bugs

  • Correções de estabilidade em GameActivityEvents (b/278017467).

Versão 2.0.1

5 de abril de 2023

Lançamento de androidx.games:games-activity:2.0.1. A versão 2.0.1 contém estas confirmações.

Correções de bugs

  • Correção da liberação antecipada de memória com historicalEventTimes.
  • Foi corrigido um problema com o estouro de historicalEventTimesNanos em sistemas de 32 bits.

Versão 2.0.0

8 de março de 2023

Lançamento de androidx.games:games-activity:2.0.0. A versão 2.0.0 contém estas confirmações.

Principais recursos da versão 2.0.0

  • Alteração da interface de tempos de eventos históricos para superar o limite de 32 bits.
  • Forneceu acesso do usuário a mudanças de configuração, como orientação.
  • Informações atualizadas na estrutura de contentRect.
  • Fornecimento de uma maneira mais fácil de personalizar o SurfaceView padrão.
  • Correção do processamento padrão do SO para eventos de toque, como o processamento de botões do sistema.
  • Otimização da maioria das chamadas JNI no tratamento de eventos de toque; isso costumava afetar o desempenho.

Versão 2.0.0-rc01

22 de fevereiro de 2023

Lançamento de androidx.games:games-activity:2.0.0-rc01. A versão 2.0.0-rc01 contém estas confirmações.

Versão 2.0.0-beta01

8 de fevereiro de 2023

Lançamento de androidx.games:games-activity:2.0.0-beta01. A versão 2.0.0-beta01 contém estas confirmações.

Correções de bugs

  • O processamento de botões do sistema foi corrigido (2a103e).

Versão 2.0.0-alpha01

11 de janeiro de 2023

Lançamento de androidx.games:games-activity:2.0.0-alpha01 sem mudanças. A versão 2.0.0-alpha01 contém estas confirmações.

Games-Activity: versão 1.2

Versão 1.2.2

7 de dezembro de 2022

Lançamento de androidx.games:games-activity:1.2.2. A versão 1.2.2 contém estas confirmações.

Correções de bugs

  • Agora, o número máximo de eventos de movimento pode ser definido no tempo de execução.

Versão 1.2.2-alpha01

9 de novembro de 2022

Lançamento de androidx.games:games-activity:1.2.2-alpha01. A versão 1.2.2-alpha01 contém estas confirmações.

Mudanças na API

  • A API agora também contém informações da versão na forma de GAMEACTIVITY_PACKED_VERSION (I287e6).
  • Foi adicionado o callback onContentRectChanged, que é chamado quando o retângulo na janela em que o conteúdo precisa ser colocado muda (I81396).

Correções de bugs

  • O excesso de buffer de eventos foi corrigido. As classes inputBuffer->keyEvents e motionEvents agora são buffers alocados dinamicamente (Ic00f6).
  • O sistema falha sem maiores problemas quando fica sem memória. Foi adicionado o processamento de erros realloc() durante o redimensionamento de buffers.

Versão 1.2.1

13 de julho de 2022

Lançamento de androidx.games:games-activity:1.2.1. A versão 1.2.1 contém estas confirmações.

Correções de bugs

  • Foram corrigidos os problemas com arquivos .aar ausentes na versão anterior.

Versão 1.2.0

15 de junho de 2022

Lançamento de androidx.games:games-activity:1.2.0. A versão 1.2.0 contém estas confirmações.

Mudanças importantes desde a versão 1.1.0

  • Agora, classes derivadas da GameActivity podem processar o carregamento de bibliotecas nativas.
  • Sempre carregue a biblioteca nativa em GameActivity.onCreate.
  • Use a biblioteca de carregamento de nome "main" como substituta se nenhuma outra biblioteca for encontrada.

Games-Activity versão 1.1

Versão 1.1.0

23 de fevereiro de 2022

Lançamento de androidx.games:games-activity:1.1.0 e androidx.games:games-controller:1.1.0. A versão 1.1.0 contém estas confirmações.

Mudanças importantes desde a versão 1.0.0

Games Activity:

  • A classe WindowInsets detecta e consulta a resposta do IME (editor de método de entrada, na sigla em inglês) e do entalhe.
  • Adição de filtros de eventos de movimento e teclas.
  • Correções de bugs:
    • Adição de mensagens ausentes para compatibilidade com a NativeActivity.
    • Correção da assinatura do onNativeWindowResized.
    • Correção das perdas de eventos de entrada.

Versão 1.1.0-rc01

9 de fevereiro de 2022

Lançamento de androidx.games:games-activity:1.1.0-rc01 e androidx.games:games-controller:1.1.0-rc01. A versão 1.1.0-rc01 contém estas confirmações.

Versão 1.1.0-beta03

26 de janeiro de 2022

Lançamento de androidx.games:games-activity:1.1.0-beta03. A versão 1.1.0-beta03 contém estas confirmações.

Correções de bugs

  • A assinatura de onNativeWindowResized foi corrigida.
  • A handle para a janela nativa em foi mantida em onSurfaceChanged.

Versão 1.1.0-beta02

15 de dezembro de 2021

Lançamento de androidx.games:games-activity:1.1.0-beta02. A versão 1.1.0-beta02 contém estas confirmações.

Correções de bugs

  • Correção da disputa na configuração do filtro de eventos.

Versão 1.1.0-beta01

17 de novembro de 2021

Lançamento de androidx.games:games-activity:1.1.0-beta01. A versão 1.1.0-beta01 contém estas confirmações.

Novos recursos

  • Adicionamos suporte à consulta de encartes de janelas e detecção de mudanças de encarte. Isso permite que os jogos reajam ao pop-up do IME (editor de método de entrada, na sigla em inglês) e processem os encartes de cascata e de corte da câmera.

Mudanças na API

  • void GameActivity_getWindowInsets(GameActivity* activity, enum GameCommonInsetsType type, GameCommonInsets* insets);

Correções de bugs

  • Evita o consumo de todos os principais eventos: volume, câmera etc. que agora são transmitidos ao sistema.

Versão 1.1.0-alpha01

29 de setembro de 2021

Lançamento de androidx.games:games-activity:1.1.0-alpha01. A versão 1.1.0-alpha01 contém estas confirmações.

Mudanças na API

  • O callback onContentRectChanged foi adicionado aos GameActivityCallbacks.

Correções de bugs

  • Mensagens ausentes adicionadas ao android_native_app_glue.h:
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

Games Performance Tuner 2.0

Versão 2.0.0-beta01

10 de janeiro de 2024

Lançamento de androidx.games:games-performance-tuner:2.0.0-beta01 sem mudanças em relação à última versão Alfa. A versão 2.0.0-beta01 contém estas confirmações.

Versão 2.0.0-alpha07

29 de novembro de 2023

Lançamento de androidx.games:games-performance-tuner:2.0.0-alpha07. A versão 2.0.0-alpha07 contém estas confirmações.

Correções de bugs

  • Correção de relatórios de telemetria de memória às vezes relatando valores incorretos

Versão 2.0.0-alpha06

1º de novembro de 2023

Lançamento de androidx.games:games-performance-tuner:2.0.0-alpha06. A versão 2.0.0-alpha06 contém estas confirmações.

Versão 2.0.0-alpha05

23 de agosto de 2023

Lançamento de androidx.games:games-performance-tuner:2.0.0-alpha05. A versão 2.0.0-alpha05 contém estas confirmações.

Novos recursos

  • Migração da biblioteca Protobuf para a versão Lite.

Correções de bugs

  • Correção de problemas com ponteiro suspenso

Versão 2.0.0-alpha04

19 de abril de 2023

Lançamento de androidx.games:games-performance-tuner:2.0.0-alpha04. A versão 2.0.0-alpha04 contém estas confirmações.

Novos recursos

  • Atualização dos recursos de coleta de telemetria na biblioteca, permitindo relatórios mais granulares dos tempos de renderização de frames.

Correções de bugs

  • Correção de um bug em que a biblioteca falhava se o número máximo de chaves de instrumentação fosse maior que a contagem de histogramas.

Versão 2.0.0-alpha03

22 de fevereiro de 2023

Lançamento de androidx.games:games-performance-tuner:2.0.0-alpha03. A versão 2.0.0-alpha03 contém estas confirmações.

Correções de bugs

  • A Games-Performance-Tuner foi movida para um novo processo de lançamento. Não haverá mudanças de comportamento.

Versão 2.0.0-alpha02

8 de fevereiro de 2023

Lançamento de androidx.games:games-performance-tuner:2.0.0-alpha02. A versão 2.0.0-alpha02 contém estas confirmações.

Mudanças na API

  • A API TuningFork_predictQualityLevels foi adicionada, o que ajuda a prever os parâmetros de fidelidade/nível de qualidade corretos a serem usados.

Games Performance Tuner 1.6

Versão 1.6.1-alpha01

9 de novembro de 2022

Lançamento de androidx.games:games-performance-tuner:1.6.1-alpha01. A versão 1.6.1-alpha01 contém estas confirmações.

Novos recursos

  • Não houve mudanças.

Versão 1.6.0

15 de junho de 2022

Lançamento de androidx.games:games-performance-tuner:1.6.0. A versão 1.6.0 contém estas confirmações.

Mudanças importantes desde a versão 1.5.0

  • O getpid que retornava 0 ao tentar fazer a telemetria de memória foi corrigido.
  • StopLoadingGroup não é mais executado sem um grupo de carregamento ativo.

Games Performance Tuner 1.5.0

Versão 1.5.0

9 de fevereiro de 2022

Lançamento de androidx.games:games-performance-tuner:1.5.0. A versão 1.5.0 contém estas confirmações.

Mudanças importantes desde a versão 1.4.0

  • Mudanças programáticas do intervalo entre os uploads, em vez da codificação nas configurações iniciais.
    • Adição da função TuningFork_setAggregationStrategyInterval.
  • Correção da corrupção de memória na chave da API na API<=23.

Versão 1.5.0-rc01

26 de janeiro de 2022

Lançamento de androidx.games:games-performance-tuner:1.5.0-rc01. A versão 1.5.0-rc01 contém estas confirmações.

Correções de bugs

  • A corrupção de memória foi corrigida na chave da API nos níveis 23 ou anteriores.

Versão 1.5.0-beta02

15 de dezembro de 2021

Lançamento de androidx.games:games-performance-tuner:1.5.0-beta02. A versão 1.5.0-beta02 contém estas confirmações.

Mudanças na API

  • Remoção da alteração interruptiva da ABI na estrutura TuningFork_Settings.

Versão 1.5.0-beta01

29 de setembro de 2021

Lançamento de androidx.games:games-performance-tuner:1.5.0-beta01. A versão 1.5.0-beta01 contém estas confirmações.

Novos recursos

  • Nenhuma mudança desde a versão Alfa. Aquela versão teve o seguinte:
    • Mudanças programáticas do intervalo entre os uploads, em vez da codificação nas configurações iniciais.

Mudanças na API

  • Nenhuma mudança desde a versão Alfa. Aquela versão teve o seguinte:
    • Nova função: TuningFork_setAggregationStrategyInterval
    • Novo campo em TuningFork_Settings: aggregation_strategy_intervalms_or_count

Versão 1.5.0-alpha01

18 de agosto de 2021

Lançamento de androidx.games:games-performance-tuner:1.5.0-alpha01. A versão 1.5.0-alpha01 contém estas confirmações.

Novos recursos

  • Agora é possível definir o intervalo entre os uploads do APT de forma programática, em vez de usar o arquivo de configurações.

Mudanças na API

  • Adição da função TuningFork_setAggregationStrategyInterval.
  • Adição de campo à estrutura de TuningFork_Settings: aggregation_strategy_intervalms_or_count

Games-Activity versão 1.0.0

Versão 1.0.0

4 de agosto de 2021

Lançamento de androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 e androidx.games:games-text-input:1.0.0. A versão 1.0.0 contém estas confirmações.

Principais recursos da versão 1.0.0

Esta é a versão estável inicial de Games-Activity, Games-Controller e Games-Text-Input. Consulte a página inicial do AGDK para mais informações.

Versão 1.0.0-rc01

12 de julho de 2021

Lançamento de androidx.games:games-activity:1.0.0-rc01. A versão 1.0.0-rc01 contém estas confirmações.

Correções de bugs

  • Correção do tipo de retorno de GameActivityCallbacks::onSaveInstanceState

Versão 1.0.0-beta01

30 de junho de 2021

Lançamento de androidx.games:games-activity:1.0.0-beta01. A versão 1.0.0-beta01 contém estas confirmações.

Mudanças na API

  • GameActivityInputInfo foi renomeado como GameActivityPointerAxes
  • O retorno de chamada onNativeWindowResized agora fornece largura e altura da janela.
  • O callback onContentRectChanged foi removido.
  • onLowMemory foi renomeado como onTrimMemory.
  • GameActivity_setWindowFormat removido.
  • Modelo de propriedade foi aprimorado para ponteiros GameActivityMotionEvents e GameActivityMotionEvent.
  • Melhorado o modelo de propriedade do estado do usuário no retorno de chamada onSaveInstanceState.

Versão 1.0.0-alpha01

16 de junho de 2021

Lançamento de androidx.games:games-activity:1.0.0-alpha01.

Novos recursos

  • Games-Activity é uma nova biblioteca que substitui a NativeActivity como a maneira recomendada para integrar um jogo C/C++ ao Android.

Games-Controller: versão 2.0

Versão 2.0.1

20 de setembro de 2023

Lançamento de "androidx.games: games-controller: 2.0.1 '. A versão 2.0.1 contém estas confirmações.

Correções de bugs do controlador de jogos:

  • Correção da condição NullReferenceException rara no gerenciador onInputDeviceChanged
  • Corrija o problema para evitar que determinados teclados USB sejam registrados incorretamente como controles de jogos.

Versão 2.0.0

8 de março de 2023

Lançamento de androidx.games:games-controller:2.0.0. A versão 2.0.0 contém estas confirmações.

Principais recursos da versão 2.0.0

  • Foi adicionada a capacidade de detectar o status de conexão de teclados de hardware.
  • Adicionada a capacidade de relatar dados de movimento (acelerômetro/giroscópio) do dispositivo principal (por exemplo, celular), bem como controles.
  • A API e o formato do banco de dados de definição do controlador foram alterados para reduzir o consumo de memória e oferecer suporte a recursos adicionais.

Versão 2.0.0-alpha01

11 de janeiro de 2023

Lançamento de androidx.games:games-controller:2.0.0-alpha01. A versão 2.0.0-alpha01 contém estas confirmações.

Novos recursos

  • Detecção de teclado de hardware.
  • Suporte integrado à geração de relatórios de dados de movimento do sensor, como o recebimento de dados do giroscópio e acelerômetro do próprio smartphone.
  • Novo formato de dados otimizado para mapeamento do controle.

Mudanças na API

  • Novas chamadas de API para o teclado de hardware: Paddleboat_getPhysicalKeyboardStatus e Paddleboat_setPhysicalKeyboardStatusCallback.
  • Novas chamadas de API para relatórios integrados de dados de movimento do sensor: Paddleboat_getIntegratedMotionSensorFlags e Paddleboat_setMotionDataCallbackWithIntegratedFlags.
  • Novas chamadas de API para o formato de dados revisado de mapeamento do controle: Paddleboat_addControllerRemapDataFromFd e Paddleboat_addControllerRemapDataFromFileBuffer.
  • Chamadas antigas descontinuadas da API de mapeamento: Paddleboat_addControllerRemapData e Paddleboat_getControllerRemapTableData.

Correções de bugs

  • Correção do problema de compatibilidade com eventos de movimento da GameActivity 1.2.2 e versões mais recentes.

Games-Controller: versão 1.1.0

Versão 1.1.0

23 de fevereiro de 2022

Lançamento de androidx.games:games-activity:1.1.0 e androidx.games:games-controller:1.1.0. A versão 1.1.0 contém estas confirmações.

Mudanças importantes desde a versão 1.0.0

Games Activity:

  • A classe WindowInsets detecta e consulta a resposta do IME (editor de método de entrada, na sigla em inglês) e do entalhe.
  • Adição de filtros de eventos de movimento e teclas.
  • Correções de bugs:
    • Adição de mensagens ausentes para compatibilidade com a NativeActivity.
    • Correção da assinatura do onNativeWindowResized.
    • Correção das perdas de eventos de entrada.

Versão 1.1.0-rc01

9 de fevereiro de 2022

Lançamento de androidx.games:games-controller:1.1.0-rc01. A versão 1.1.0-rc01 contém estas confirmações.

Versão 1.1.0-beta01

26 de janeiro de 2022

Lançamento de androidx.games:games-controller:1.1.0-beta01 sem mudanças desde 1.1.0-alpha01. A versão 1.1.0-beta01 contém estas confirmações.

Versão 1.1.0-alpha01

15 de dezembro de 2021

Lançamento de androidx.games:games-controller:1.1.0-alpha01. A versão 1.1.0-alpha01 contém estas confirmações.

Novos recursos

Adição de suporte ao status da bateria, vibração de dois motores, controle de luz e geração de relatórios sobre o eixo de movimento em controles compatíveis durante a execução no Android S ou em versões mais recentes.

Mudanças na API

  • A função Paddleboat_setMotionDataCallback foi adicionada para registrar callbacks de dados de movimento do controle.
  • A função Paddleboat_setControllerLight foi adicionada para mudar as configurações de iluminação do controle.
  • A estrutura Paddleboat_Controller_Battery foi adicionada a Paddleboat_Controller_Data.
  • Novas estruturas:
    • Paddleboat_Controller_Battery
    • Paddleboat_Motion_Data
  • Novas tipos enumerados:
    • Paddleboat_BatteryStatus
    • Paddleboat_LightType
    • Paddleboat_Motion_Type
  • Novas sinalizações do controlador:
    • PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
    • PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
    • PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
    • PADDLEBOAT_CONTROLLER_FLAG_BATTERY

Correções de bugs

  • Uma entrada alternativa do banco de dados deviceId foi adicionada para o controle do PS4.
  • Mais de 31 entradas de banco de dados da API foram adicionadas para o controle do PS5.

Games-Controller: versão 1.0.0

Versão 1.0.0

4 de agosto de 2021

Lançamento de androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 e androidx.games:games-text-input:1.0.0. A versão 1.0.0 contém estas confirmações.

Principais recursos da versão 1.0.0

Esta é a versão estável inicial de Games-Activity, Games-Controller e Games-Text-Input. Consulte a página inicial do AGDK para mais informações.

Versão 1.0.0-rc02

21 de julho de 2021

Lançamento de androidx.games:games-controller:1.0.0-rc02. A versão 1.0.0-rc02 contém estas confirmações.

Correções de bugs

  • Correção do erro de empacotamento que fazia a importação do Prefab falhar em permutações de arquitetura/versão vazias e não usadas.

Versão 1.0.0-rc01

12 de julho de 2021

Lançamento de androidx.games:games-controller:1.0.0-rc01. A versão 1.0.0-rc01 contém estas confirmações.

Correções de bugs

  • Correção de um problema de incompatibilidade com a GameActivity mais recente

Versão 1.0.0-beta01

30 de junho de 2021

Lançamento de androidx.games:games-controller:1.0.0-beta01. A versão 1.0.0-beta01 contém estas confirmações.

Mudanças na API

  • Funções que retornavam um booleano para sucesso ou falha agora retornam um enum Paddleboat_Error_Code.
  • Paddleboat_onPause foi renomeado como Paddleboat_onStop.
  • Paddleboat_onResume foi renomeado como Paddleboat_onStart.
  • Paddleat_processGameActivityEvent dividido em duas funções: Paddleboat_processGameActivityKeyInputEvent e Paddleboat_processGameActivityMotionInputEvent
  • Remoção dos recursos do controle estendido que exigiam uma compilação em um SDK de prévia do Android S.
  • Adicionamos a função Paddleboat_getBackButtonConsumed
  • Agora, os retornos de chamada de status do controle e do mouse têm um parâmetro opcional de um ponteiro para dados definidos pelo usuário
  • A string de nome do controlador foi removida da estrutura de informações do dispositivo. Agora ela é acessada com a função Paddleboat_getControllerName.

Correções de bugs

  • Foi corrigido um problema em que um controlador que não se declarava como controlador inicialmente, mas mais tarde em uma mensagem onInputDeviceChanged, não era detectado como uma conexão de controlador.

Versão 1.0.0-alpha01

16 de junho de 2021

Lançamento de androidx.games:games-controller:1.0.0-alpha01.

Novos recursos

  • Games-Controller é uma nova biblioteca que oferece uma API C para detectar, ler entradas e interagir com controles de jogos.

Games-Text-Input 2.1

Versão 2.1.0-alpha01

26 de julho de 2023

Lançamento de androidx.games:games-text-input:2.1.0-alpha01. A versão 2.1.0-alpha01 contém estas confirmações.

Novos recursos

  • Adicionar suporte aos modos de uma e várias linhas

Mudanças na API

  • Adicionar a função isSoftwareKeyboardVisible
  • Adição de definições de bitfield para GameActivity_setImeEditorInfo.
  • Adicionar callback onEditorAction

Correções de bugs

  • Correção de teclados de hardware e software dessincronizados
  • Limpar o foco quando o teclado de software estiver oculto

Games-Text-Input 2.0

Versão 2.0.0

8 de março de 2023

Lançamento de androidx.games:games-text-input:2.0.0. A versão 2.0.0 contém estas confirmações.

Mudanças importantes desde a versão 1.1.1

  • Atualização da versão principal devido a mudanças no sistema de build. Não há atualizações na biblioteca/API em si.

Games-Text-Input versão 1.1

Versão 1.1.2-alpha01

9 de novembro de 2022

Lançamento de androidx.games:games-text-input:1.1.2-alpha01. A versão 1.1.2-alpha01 contém estas confirmações.

Novos recursos

  • Não houve mudanças.

Versão 1.1.1

13 de julho de 2022

Lançamento de androidx.games:games-text-input:1.1.1. A versão 1.1.1 contém estas confirmações.

Correções de bugs

  • Foram corrigidos os problemas com arquivos .aar ausentes na versão anterior.

Versão 1.1.0

9 de fevereiro de 2022

Lançamento de androidx.games:games-text-input:1.1.0. A versão 1.1.0 contém estas confirmações.

Mudanças importantes desde a versão 1.0.0 - Adição da funcionalidade de escuta e consulta WindowInsets a GameTextInput. - Adição do cabeçalho gamecommon.h ausente.

Versão 1.1.0-rc01

26 de janeiro de 2022

Lançamento de androidx.games:games-text-input:1.1.0-rc01. A versão 1.1.0-rc01 contém estas confirmações.

Versão 1.1.0-beta01

15 de dezembro de 2021

Lançamento de androidx.games:games-text-input:1.1.0-beta01. A versão 1.1.0-beta01 contém estas confirmações.

Correções de bugs

  • Correção de encartes de hierarquia e IME.
  • O cabeçalho gamecommon.h ausente foi adicionado.

Versão 1.1.0-alpha01

13 de outubro de 2021

Lançamento de androidx.games:games-text-input:1.1.0-alpha01. A versão 1.1.0-alpha01 contém estas confirmações.

Mudanças na API

  • A funcionalidade de encartes do IME foi adicionada ao GameTextInput.

Games-Text-Input versão 1.0

Versão 1.0.0

4 de agosto de 2021

Lançamento de androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 e androidx.games:games-text-input:1.0.0. A versão 1.0.0 contém estas confirmações.

Principais recursos da versão 1.0.0

Esta é a versão estável inicial de Games-Activity, Games-Controller e Games-Text-Input. Consulte a página inicial do AGDK para mais informações.

Versão 1.0.0-rc01

12 de julho de 2021

Lançamento de androidx.games:games-text-input:1.0.0-rc01 sem alterações. A versão 1.1.0-rc01 contém estas confirmações.

Versão 1.0.0-beta01

30 de junho de 2021

Lançamento de androidx.games:games-text-input:1.0.0-beta01. A versão 1.0.0-beta01 contém estas confirmações.

Mudanças na API

  • Modelo de propriedade aprimorado de objetos GameTextInputState.
  • Arrumação de tipos para fins de consistência com o NDK

Versão 1.0.0-alpha01

16 de junho de 2021

Lançamento de androidx.games:games-text-input:1.0.0-alpha01.

Novos recursos

  • A Games-Text-Input é uma nova biblioteca que ajuda desenvolvedores de jogos a usar a entrada de teclado de software do Android em C/C++.

Games Frame Pacing: versão 2.1

Versão 2.1.0

15 de novembro de 2023

Lançamento de androidx.games:games-frame-pacing:2.1.0. A versão 2.1.0 contém estas confirmações.

Versão 2.1.0-rc01

20 de setembro de 2023

Lançamento de androidx.games:games-frame-pacing:2.1.0-rc01. A versão 2.1.0-rc01 contém estas confirmações.

Versão 2.1.0-beta01

24 de maio de 2023

Lançamento de androidx.games:games-frame-pacing:2.1.0-beta01. A versão 2.1.0-beta01 contém estas confirmações.

Correções de bugs

  • Tempo limite em caso de falha na inicialização de NDKChoreographer (ef466d).
  • Ao usar as taxas de atualização de consulta SwappyGL_getSupportedRefreshPeriodsNS explicitamente do sistema (c85235).

Versão 2.1.0-alpha01

5 de abril de 2023

Lançamento de androidx.games:games-frame-pacing:2.1.0-alpha01. A versão 2.1.0-alpha01 contém estas confirmações.

Novos recursos

  • Nova API para redefinir o estado de ritmo de frame.
  • Nova API para desativar o impacto do ritmo de frames do swappy sem deixar de observar os tempos de CPU e GPU.

Mudanças na API

  • SwappyGL_resetFramePacing/SwappyVk_resetFramePacing agora pode ser usado para redefinir o estado interno do ritmo de frame O ritmo de frames agora considera somente os dados a partir do momento em que a API de redefinição é chamada
  • Agora, SwappyGL_enableFramePacing/SwappyVk_enableFramePacing pode ser usado para ativar/desativar o ritmo de frames do Swappy. Quando está desativada,
  • A SwappyGL_enableBlockingWait/SwappyVk_enableBlockingWait pode ser usada para controlar se uma espera de bloqueio do trabalho da GPU do último frame acontece quando o ritmo de frames está desativado.

Correções de bugs

  • Melhorias no desempenho são feitas para casos vinculados à GPU ao usar a API Swappy GL.

Games Frame Pacing: versão 2.0

Versão 2.0.0

8 de março de 2023

Lançamento de androidx.games:games-frame-pacing:2.0.0. A versão 2.0.0 contém estas confirmações.

Mudanças importantes desde a versão 1.10.1

  • O sistema de compilação passou por grandes mudanças, que resultaram na geração de apenas uma biblioteca, em vez de várias por versão do SDK/NDK.
  • As estatísticas de frame do Vulkan foram adicionadas.
  • Foi adicionada uma nova API para limpar as estatísticas de frames.
  • Os registros são todos silenciosos no modo de lançamento e podem ser ativados no modo de depuração.

Versão 2.0.0-rc01

22 de fevereiro de 2023

Lançamento de androidx.games:games-frame-pacing:2.0.0-rc01. A versão 2.0.0-rc01 contém essas confirmações.

Novos recursos

  • O Logging agora fica oculto por uma flag de compilação. Por padrão, o build de lançamento da biblioteca não tem geração de registros, e a versão de depuração da biblioteca tem todos os registros ativados.

Versão 2.0.0-beta01

8 de fevereiro de 2023

Lançamento de androidx.games:games-frame-pacing:2.0.0-beta01. A versão 2.0.0-beta01 contém estas confirmações.

Novos recursos

  • Foi apresentada uma nova API para limpar as estatísticas de frames.

Mudanças na API

  • As APIs SwappyGL_clearStats e SwappyGL_clearStats foram adicionadas.

Versão 2.0.0-alpha01

11 de janeiro de 2023

Lançamento de androidx.games:games-frame-pacing:2.0.0-alpha01. A versão 2.0.0-alpha01 contém estas confirmações.

Novos recursos

  • Inclusão de estatísticas de frame do Vulkan.

Mudanças na API

  • Aumento da versão principal devido à refatoração de arquivos de build.
  • Foram adicionadas três novas APIs: SwappyVk_enableStats, SwappyVk_recordFrameStart e SwappyVk_getStats.

Correções de bugs

  • O limite foi aplicado apenas no modo de troca automática (Ic0786).

Games Frame Pacing: versão 1.10

Versão 1.10.2-alpha01

9 de novembro de 2022

Lançamento de androidx.games:games-frame-pacing:1.10.2-alpha01. A versão 1.10.2-alpha01 contém estas confirmações.

Novos recursos

  • Não houve mudanças.

Versão 1.10.1

15 de junho de 2022

Lançamento de androidx.games:games-frame-pacing:1.10.1. A versão 1.10.1 contém estas confirmações.

Correções de bugs

  • Foi corrigido o bug em que o swappy não era criado com versões do ndk anteriores entre a 17 e a 23.
  • A API foi exposta para extrair as taxas de atualização com suporte da tela.

Versão 1.10.0

23 de fevereiro de 2022

Lançamento de androidx.games:games-frame-pacing:1.10.0. A versão 1.10.0 contém estas confirmações.

Mudanças importantes desde a versão 1.9.0

  • Entradas de filtro do Choreographer poluídas são ignoradas e há mais suavização para evitar que o emulador trave.
  • Adição das funções *_uninjectTracer.

Versão 1.10.0-rc01

9 de fevereiro de 2022

Lançamento de androidx.games:games-frame-pacing:1.10.0-rc01. A versão 1.10.0-rc01 contém estas confirmações.

Versão 1.10.0-beta01

26 de janeiro de 2022

Lançamento de androidx.games:games-frame-pacing:1.10.0-beta01. A versão 1.10.0-beta01 contém estas confirmações.

Versão 1.10.0-alpha01

15 de dezembro de 2021

Lançamento de androidx.games:games-frame-pacing:1.10.0-alpha01. A versão 1.10.0-alpha01 contém estas confirmações.

Novos recursos

  • A função SwappyGL_uninjectTracer foi adicionada.

Mudanças na API

  • Remoção de callbacks que foram adicionados anteriormente usando SwappyGL_injectTracer com a API SwappyGL_uninjectTracer(const SwappyTracer *t).

Games Frame Pacing 1.9

Versão 1.9.1

13 de outubro de 2021

Lançamento de androidx.games:games-frame-pacing:1.9.1. A versão 1.9.1 contém estas confirmações.

Correções de bugs

Versão 1.9.0

12 de julho de 2021

Lançamento de androidx.games:games-frame-pacing:1.9.0. A versão 1.9.0 contém estas confirmações.

Mudanças importantes desde a versão 1.7.0

  • Atualizada para corresponder ao esquema de controle de versões interno.

Games Frame Pacing 1.7.0

Versão 1.7.0

30 de junho de 2021

Lançamento de androidx.games:games-frame-pacing:1.7.0. A versão 1.7.0 contém estas confirmações.

Versão 1.7.0-rc01

2 de junho de 2021

Lançamento de androidx.games:games-frame-pacing:1.7.0-rc01. A versão 1.7.0-rc01 contém estas confirmações.

Versão 1.7.0-beta02

24 de fevereiro de 2021

Lançamento de androidx.games:games-frame-pacing:1.7.0-beta02.

Versão 1.7.0-beta01

16 de dezembro de 2020

Lançamento de androidx.games:games-frame-pacing:1.7.0-beta01.

Games Performance Tuner 1.4.3

Versão 1.4.3

12 de julho de 2021

Lançamento de androidx.games:games-performance-tuner:1.4.3. A versão 1.4.3 contém estas confirmações.

Mudanças importantes desde a versão 1.1.0

  • Atualizada para corresponder ao esquema de controle de versões interno.

Games Performance Tuner 1.1.0

Versão 1.1.0

30 de junho de 2021

Lançamento de androidx.games:games-performance-tuner:1.1.0. A versão 1.1.0 contém estas confirmações.

Versão 1.1.0-rc01

2 de junho de 2021

Lançamento de androidx.games:games-performance-tuner:1.1.0-rc01. A versão 1.1.0-rc01 contém estas confirmações.

Versão 1.1.0-beta03

21 de abril de 2021

Lançamento de androidx.games:games-performance-tuner:1.1.0-beta03.

Versão 1.1.0-beta02

24 de fevereiro de 2021

Lançamento de androidx.games:games-performance-tuner:1.1.0-beta02.

Versão 1.1.0-beta01

16 de dezembro de 2020

Lançamento de androidx.games:games-performance-tuner:1.1.0-beta01.

Versão 1.1.0-alpha01

Lançamento do androidx.games:games-performance-tuner:1.1.0-alpha01.

Versão 1.0.0

Versão 1.0.0-alpha02

12 de agosto de 2020

A biblioteca Android Gaming foi renomeada como a biblioteca Android Games.

androidx.gaming -> androidx.games

Versão 1.0.0-alpha01

10 de junho de 2020

Lançamento de androidx.games:1.0.0-alpha01.