Como foi feito: o quebra-cabeça de palavras cruzadas do I/O, com IA
Um toque divertido e útil em um jogo de palavras clássico, com Flutter, Firebase Genkit e a API Gemini
Para o I/O deste ano, a Very Good Ventures fez uma parceria com as equipes do Flutter e do Firebase no Google para criar uma experiência digital única, que mostra o poder da API Gemini.
A graça (e o desafio) das palavras cruzadas é resolver as pistas para completar o tabuleiro. Um lugar natural para começar as palavras e as pistas foi tudo o que falamos no I/O deste ano. Para gerar o conteúdo do jogo, demos os vídeos das keynotes ao Gemini Advanced e pedimos que criasse uma lista de palavras e pistas sobre tecnologia, relacionadas aos temas do momento, para tornar o jogo uma forma divertida de aprender sobre tudo o que foi anunciado no I/O deste ano.
Continue lendo para saber como construímos a interface com Flutter e confira o código aberto do jogo, que você pode acessar no GitHub.
Como jogar
Ao fazer login no quebra-cabeça, você é convidado a escolher seu time. Conforme você acerta uma pista, a palavra é preenchida e as células mudam para a cor do seu time. Seu time ganha pontos por cada palavra resolvida, e você ganha um bônus por uma sequência de palavras resolvidas sem pedir dicas.
Precisa de uma dica? Clique no botão Hint e faça até dez perguntas de sim ou não sobre a palavra oculta. A API Gemini responde suas perguntas em particular, para que você preencha mais palavras e ajude seu time a conquistar a vitória!

O design do recurso de dica é um ótimo exemplo de como tecnologias diferentes podem trabalhar juntas para resolver um problema. As dicas são feitas com o Firebase Genkit, um novo framework para desenvolvimento de IA anunciado no I/O, e são implantadas como uma Firebase Function.
A requisição de rede para a API inclui a resposta da pista, então, para manter a resposta escondida do cliente nos dados da mensagem, construímos um backend simples em Dart usando o pacote Dart Frog para deixar a experiência mais robusta. O backend Frog chama o Genkit para obter a dica e recupera a resposta do banco de dados. Assim, os jogadores não conseguem simplesmente inspecionar a chamada de rede para descobrir as respostas do jogo.
Você pode ler mais sobre como o fluxo do Genkit foi construído no blog de aprofundamento sobre Firebase.

Renderizando um tabuleiro de palavras cruzadas performático com Flutter
O tabuleiro é uma das peças centrais do jogo. Otimizamos a movimentação do jogador no quebra-cabeça para garantir bom desempenho e a melhor experiência possível para os jogadores.
Consideramos duas opções para construir o tabuleiro: Flutter puro ou aproveitar o Flame (motor de jogo). O recurso mais atraente do Flame para este jogo é a API de câmera, que permite que os mascotes se movam com facilidade e oferece suporte a controles de zoom. No entanto, como essa era realmente a única funcionalidade do Flame que usaríamos, decidimos que usar um motor de jogo completo como o Flame seria exagero para este cenário.
Buscando uma solução alternativa, exploramos o InteractiveViewer
widget, que permite renderizar as palavras em um canvas de tamanho personalizado e mover os mascotes livremente com transformações de matriz.
InteractiveViewer foi uma solução mais simples para nossas necessidades, com menos dependências e carga, o que nos permitiu mostrar melhor a flexibilidade e o desempenho do Flutter.
O poder e a flexibilidade do InteractiveViewer
O InteractiveViewer tem gestos de zoom integrados, mas queríamos adicionar botões mais intuitivos para a experiência em desktop. Aproveitando as transformações de matriz, implementamos os controles de zoom calculando primeiro a variação de escala e atualizando a nova viewport, usando o centro como ponto de referência constante:

Quando temos a nova viewport provisória, precisamos garantir que ela caiba dentro dos limites do tabuleiro. Precisamos considerar dois cenários: quando a viewport é maior que o tabuleiro ou quando está posicionada fora dos limites. Atualizamos tanto a variação de escala quanto a translação da viewport para garantir que ela caiba nos limites, ajustando o nível de zoom ou a posição da viewport, como mostrado no código a seguir:

Por fim, calcule a transformação e aplique-a ao controller do InteractiveViewer:

Com este código, estendemos os controles de zoom do InteractiveViewer e transformamos a viewport de acordo com nossas necessidades.
Melhorando o desempenho com WebAssembly no Flutter
O suporte a WebAssembly para apps web em Flutter foi um dos grandes anúncios para a comunidade Flutter este ano, no IO. Com jogadores do mundo todo jogando ao mesmo tempo, o desempenho era um fator crítico. Aproveitamos o WebAssembly (Wasm), integrado ao Flutter, para reduzir gargalos de desempenho e manter uma taxa de quadros fluida, principalmente nas animações de personagens e do tabuleiro no jogo.

Backend em Dart e Cloud Run: compartilhamento de código sem atrito entre backend e frontend
Para garantir uma experiência de jogo tranquila para todos os usuários, nosso backend em Dart é construído com o pacote Dart Frog e é hospedado no Google Cloud Run, para aproveitar os recursos de auto scaling. Isso ajuda a manter o desempenho ideal independentemente do número de jogadores ativos, já que o jogo faz várias chamadas, como sempre que um usuário é criado ou quando um jogador envia uma palavra ou pede uma dica.
Usar um backend para confirmar as respostas de cada pista também nos permitiu proteger o jogo de palavras cruzadas e evitar trapaças. Especificamente, o app lê informações com o SDK do Firestore para Flutter, mas o banco de dados só permite alterações a partir do backend em Dart. Isso também permitiu um desenvolvimento mais rápido, já que pudemos usar a mesma linguagem (Dart) no front-end e no backend.
Podemos ver esse padrão em ação no modelo de dados Player, por exemplo, que cria um jogador usando a API do Dart Frog.

O app acessa diretamente o ranking dos jogadores, reutilizando o mesmo modelo e evitando duplicação e dessincronização:

Comece a jogar: resolva o quebra-cabeça de palavras cruzadas do I/O!
Comece a jogar as palavras cruzadas por conta própria, em toda a sua glória de horizontal e vertical. Para quem quer se aprofundar nos detalhes, confira o seu código open-source e a Trilha de Aprendizado para Desenvolvedores para ver como o construímos. Veja o resumo do Google I/O para saber mais sobre tudo o que foi anunciado este ano!