Como foi feito: I/O FLIP
Textos e imagens gerados por IA dão um toque divertido a este jogo de cartas feito com Flutter, Firebase e Google Cloud
Como foi feito: I/O FLIP
Textos e imagens gerados por IA dão um toque divertido a este jogo de cartas feito com Flutter, Firebase e Google Cloud
I/O FLIP é um jogo de cartas projetado por IA, criado pelo Google e desenvolvido em Flutter. Ele reúne vários produtos e técnicas do Google. Isso inclui Flutter, Firebase, ferramentas de IA generativa, Dreambooth no Muse, PaLM API e MakerSuite. Os jogadores podem disputar várias partidas e compartilhar cartas da sua partida nas redes sociais.
Para jogar, acesse https://flip.withgoogle.com. Para começar e gerar seu baralho, responda a algumas perguntas. Para montar sua mão e entrar em uma partida, selecione três cartas. Você vai usá-las para enfrentar seu oponente em três rodadas, nas quais a carta mais alta vence a rodada. A diversão não precisa acabar quando a partida termina. Continue jogando partidas para aumentar sua sequência de vitórias e tente chegar ao placar de líderes!
Vamos mergulhar nos detalhes técnicos de como usamos Flutter e Firebase para criar o I/O FLIP.
Um jogo de cartas criado com Flutter
A interface do usuário, as animações, os efeitos de holograma e o backend do I/O FLIP foram todos criados com Flutter e Dart.
Para começar, aproveitamos o Flutter Casual Games Toolkit. Usamos, prontos para uso, a funcionalidade de áudio, o ciclo de vida do jogo e a navegação do app com o go_router como base. A partir daí, construímos a lógica e a interface do jogo. O I/O FLIP é um app web responsivo. Ele se ajusta à tela do jogador. O app também trata a entrada de acordo com o dispositivo usado pelo jogador. Ele recebe toques quando acessado em celular ou tablet e cliques do mouse no desktop.
As cartas são um elemento-chave do I/O FLIP. Milhares de cartas podem acabar no baralho de um jogador. Cada carta exibe uma mascote do Google, um elemento e um valor de poder. Os elementos entram em jogo quando se enfrentam. Por exemplo, quando alguém joga uma carta de fogo e o oponente joga uma carta de água, a carta de água recebe uma penalidade de 10 pontos. Também usamos records, um novo recurso do Dart 3, para renderizar a moldura de acordo com o elemento da carta.
…
(String, SvgPicture) _mapSuitNameToAssets() {
switch (suitName) {
case 'fire':
if (isRare) {
return (
Assets.images.cardFrames.holos.cardFire.keyName,
Assets.images.suits.card.fire.svg(),
);
}
return (
Assets.images.cardFrames.cardFire.keyName,
Assets.images.suits.card.fire.svg(),
);
…
Cartas criadas com imagens e descrições geradas por IA
Cada carta do I/O FLIP é única, porque contém uma imagem e uma descrição geradas por IA. No início do jogo, os jogadores respondem a duas perguntas. Essas respostas ajudam a montar um baralho de 12 cartas com imagens e descrições pré-geradas pelos modelos de IA.
A equipe do Google usou duas tecnologias para pré-gerar as imagens: Muse, um modelo Transformer de texto para imagem, e DreamBooth. O DreamBooth permite sintetizar um sujeito em diversas cenas, poses, ângulos e condições de iluminação. Cada carta contém uma de quatro mascotes do Google: Dash, Sparky, Android ou Dino, além de um local. A mascote também tem um item que identifica sua equipe. O prompt de "tipo de equipe" no início do jogo dá origem à criação desse item. Por exemplo, escolher "mago" pode resultar em um personagem com chapéu de mago, varinha mágica ou algo ainda mais mágico!
A equipe do Google usou a PaLM API para pré-gerar as descrições das cartas. A PaLM API acessa os grandes modelos de linguagem do Google. Os prompts no início do jogo incluíam o tipo de equipe e o tipo de poder da equipe. Digamos que você selecione a equipe "Mago" e o poder "Magnetismo". Quando suas cartas são geradas, a descrição de uma delas inclui um contexto para a imagem gerada, incluindo os superpoderes do personagem. Por exemplo: "Dash, o Mago, vive em um castelo com seu dragão de estimação. Ele adora lançar feitiços e fazer as pessoas rirem."
O Flutter compõe as cartas com o widget GameCard. Esse widget recebe os dados da carta: nome, descrição, imagem e poder. Depois de criar a carta, ele aplica uma borda que representa o elemento do naipe. Se a carta for especial, o Flutter aplica um efeito de shader foil.
Para saber mais sobre como os aspectos de IA generativa do jogo foram criados, confira este post do blog para desenvolvedores do Google.
Shaders adicionam efeito foil às cartas especiais
O Flutter oferece suporte a fragment shaders. Para gerar esses efeitos visuais por pixel, o Flutter executa a OpenGL Shading Language (GLSL) na GPU do dispositivo. Colecionadores de cartas talvez lembrem da sensação de abrir um pacote e encontrar uma carta especial com um brilho holográfico. O I/O FLIP também inclui cartas foil especiais. Elas valem 100 pontos. As cartas comuns têm valores que vão de 10 a 99. Usamos shaders personalizados para renderizar o efeito foil.
Implementamos o shader foil no arquivo foil.frag. O efeito usa as seguintes constantes:
-
STRENGTH. Isso mistura a cor original do pixel com a cor do efeito foil. Varia de 0.0, sem efeito, a 1.0, efeito total. -
SATURATION. Define a intensidade de uma cor. Varia de 0.0, escala de cinza, ou seja, ausência de cor, a 1.0, cor total ou ausência de preto. LIGHTNESS. Varia de 0.0, preto total, a 1.0, branco total.
O shader também recebe entradas por meio de uniforms, neste caso resolution e offset. O uniform sampler2d, chamado tSource,
representa a imagem da carta à qual o shader é aplicado. O resultado final é uma carta com efeito foil.
vec4 rainbowEffect(vec2 uv) {
vec4 srcColor = texture(tSource, uv);
float hue = uv.x / (1.75 + abs(offset.x)) + offset.x / 3.0;
float lightness = LIGHTNESS + 0.25 * (0.5 + offset.y * (0.5 - uv.y));
hue = fract(hue);
float c = (1.0 - abs(2.0 * lightness - 1.0)) * SATURATION;
float x = c * (1.0 - abs(mod(hue / (1.0 / 6.0), 2.0) - 1.0));
float m = LIGHTNESS - c / 2.0;
vec3 rainbowPrime;
if (hue < 1.0 / 6.0) {
rainbowPrime = vec3(c, x, 0.0);
} else if (hue < 1.0 / 3.0) {
rainbowPrime = vec3(x, c, 0.0);
} else if (hue < 0.5) {
rainbowPrime = vec3(0.0, c, x);
} else if (hue < 2.0 / 3.0) {
rainbowPrime = vec3(0.0, x, c);
} else if (hue < 5.0 / 6.0) {
rainbowPrime = vec3(x, 0.0, c);
} else {
rainbowPrime = vec3(c, 0.0, x);
}
vec3 rainbow = rainbowPrime + m;
return mix(srcColor, vec4(rainbow, srcColor.a), STRENGTH);
}
O Firebase permite hospedar o jogo e compartilhá-lo nas redes sociais
Toda a comunicação durante o jogo acontece em tempo real pelo Cloud Firestore do Firebase. O Firebase Storage hospeda os recursos das cartas que geram os baralhos dos jogadores. Também usamos o Cloud Firestore para registrar a "Maior sequência de vitórias" no placar de líderes. Quando alguém novo entra para o placar, o pacote
firedart o adiciona ao Firestore.
O Dart Frog permite compartilhar código entre o backend e o frontend
O I/O FLIP precisava de um backend para evitar trapaças. Essa lógica de jogo com autoridade no servidor impede que clientes maliciosos enviem requisições fabricadas. O Dart Frog mantém a lógica do jogo, como o vencedor de cada rodada, no backend. Ele também compartilha esse código entre o frontend em Flutter e o backend do Firestore. Compartilhar código tem algumas vantagens. Permite reutilizar a lógica. Por exemplo, se um jogador vencer uma rodada, o jogo pode exibir uma animação de vitória sem precisar consultar o Firebase toda vez. Compartilhar código também acelerou o desenvolvimento, já que a equipe podia escrever código de backend e de frontend na mesma linguagem: Dart. Implantamos o servidor Dart Frog do I/O FLIP no Cloud Run. Isso significa que o código do servidor roda no Google Cloud e pode escalar automaticamente, então o app consegue atender muitos jogadores ao mesmo tempo.
FutureOr<Response> onRequest(RequestContext context) async {
if (context.request.method == HttpMethod.post) {
final cardsRepository = context.read<CardsRepository>();
final promptRepository = context.read<PromptRepository>();
final body = await context.request.json() as Map<String, dynamic>;
final prompt = Prompt.fromJson(body);
if (!await promptRepository.isValidPrompt(prompt)) {
return Response(statusCode: HttpStatus.badRequest);
}
final characterClass = prompt.characterClass;
if (characterClass == null) {
return Response(statusCode: HttpStatus.badRequest);
}
final characterPower = prompt.power;
if (characterPower == null) {
return Response(statusCode: HttpStatus.badRequest);
}
final cards = await cardsRepository.generateCards(
characterClass: characterClass,
characterPower: characterPower,
);
return Response.json(
body: {'cards': cards.map((e) => e.toJson()).toList()},
);
}
return Response(statusCode: HttpStatus.methodNotAllowed);
}
O Dart Frog também facilita o compartilhamento nas redes sociais. Ao selecionar cartas, o jogador pode compartilhar uma carta individual no Twitter ou no Facebook. Ao enviar sua pontuação para o placar de líderes, você pode compartilhar sua mão no Twitter ou no Facebook. Quando o usuário clica em Compartilhar, o Dart Frog gera uma publicação pré-preenchida. Essa publicação contém um texto e um link para uma página web com sua mão ou carta correspondente, além de um botão para que os visitantes joguem o I/O FLIP por conta própria!
Próximos passos
O I/O FLIP mostra como combinar Flutter e Firebase, junto com ferramentas e técnicas de IA generativa do Google, em um jogo divertido que pessoas do mundo todo podem jogar.
Jogue uma partida e mostre sua mão, ou explore o código-fonte aberto!