Como criar seu próprio quebra-cabeça deslizante com Flutter

Provavelmente você já leu o desafio Flutter Puzzle Hack e já está pensando em como levar sua criatividade a novos limites.

A essa altura, você provavelmente já leu o desafio Flutter Puzzle Hack e já está pensando em como levar sua criatividade a novos limites. Estamos aqui para dar mais informações sobre como a base de código de exemplo é estruturada e algumas ideias para criar sua submissão ao concurso.

Arquitetura do quebra-cabeça deslizante

O código-fonte fornecido implementa uma arquitetura em camadas com flutter_bloc para gerenciar o estado. Os blocs cuidam de tudo, desde a lógica do jogo até o tema. Todo o estado é gerenciado de forma consistente; para qualquer atualização na lógica do quebra-cabeça, você só precisará encontrar o bloc correspondente e atualizá-lo. Os botões de reiniciar e embaralhar o jogo, o timer e a contagem regressiva são todos blocs separados, então esses podem ser outros lugares onde você considera implementar algo criativo: talvez uma ampulheta para o timer? Ou uma sequência de embaralhamento vistosa?

Observe que toda a lógica do jogo está contida em um único bloc chamado PuzzleBloc. Ele será atualizado com eventos como tocar em uma peça para movê-la com o evento TileTapped ou reiniciar o tabuleiro do quebra-cabeça por completo com PuzzleReset. Sempre que um quebra-cabeça é atualizado, um novo estado do quebra-cabeça é emitido.

dart
class PuzzleBloc extends Bloc<PuzzleEvent, PuzzleState> {
  PuzzleBloc(this._size, {this.random}) : super(const PuzzleState() {
    on<PuzzleInitialized>(_onPuzzleInitialized);
    on<TileTapped>(_onTileTapped);
    on<PuzzleReset>(_onPuzzleReset);
  }
​
  void _onPuzzleInitialized(
    PuzzleInitialized event,
    Emitter<PuzzleState> emit,
  ) {...}
  void _onTileTapped(
    TileTapped event,
    Emitter<PuzzleState> emit,
  ) {...}
  void _onPuzzleReset(
    PuzzleReset event,
    Emitter<PuzzleState> emit,
  ) {...}
}

Personalizando o tema

O código de exemplo do quebra-cabeça contém os temas Simple e Dashatar. Eles podem servir como ponto de partida para suas próprias personalizações — use o que precisar ou comece do zero. A forma como você implementa seu quebra-cabeça fica a seu critério! Um lugar em que você pode considerar ser criativo é na temática do quebra-cabeça.

Toda a temática da demo acontece no topo do PuzzlePage. Ela é abstraída, então você só precisará atualizar os elementos do tema em um único lugar e as mudanças serão refletidas em todos os lugares. Tanto o tema Simple quanto o Dashatar definem uma série de opções, como plano de fundo da tela, menu, logo, botões, cores de texto, se o tema exibe um timer (presente no tema Dashatar, mas não no Simple) e mais. Você pode encontrá-las nos diretórios “dashatar” e “simple” na raiz do repositório.

dart
/// {@template simple_theme}
/// The simple puzzle theme.
/// {@endtemplate}
class SimpleTheme extends PuzzleTheme {
  /// {@macro simple_theme}
  const SimpleTheme() : super();
​
  @override
  Color get backgroundColor => PuzzleColors.white;
​
  @override
  Color get buttonColor => PuzzleColors.primary6;
​
  @override
  Color get hoverColor => PuzzleColors.primary3;
​
  @override
  Color get pressedColor => PuzzleColors.primary7;
​
  ...
}

Cada tema de quebra-cabeça tem um LayoutDelegate que calcula o layout desse tema. Você pode criar novos temas reutilizando os mesmos objetos de layout e ajustando apenas algumas opções do tema. Para designs mais avançados, todo o LayoutDelegate do tema pode ser personalizado. Por exemplo, você pode sobrescrever o backgroundBuilder para criar um plano de fundo personalizado, exibido apenas em telas grandes.

dart
@override
Widget backgroundBuilder(PuzzleState state) {
  return Positioned(
    bottom: 74,
    right: 50,
    child: ResponsiveLayoutBuilder(
      small: (_, child) => const SizedBox(),
      medium: (_, child) => const SizedBox(),
      large: (_, child) => const DashatarThemePicker(),
    ),
  );
}

Implementando animações

Animações são um ótimo elemento para explorar no seu quebra-cabeça deslizante. Embora o tema Simple não contenha nenhuma animação, o código do Dashatar implementa algumas animações, algumas das quais são escalonadas. Essas animações são controladas por um único animation controller ajustado com Interval para atrasar a animação e Tween para definir o intervalo de valores da animação. Isso pode ser visto no estado de sucesso do quebra-cabeça Dashatar, em que vários widgets aparecem sequencialmente animando seu offset e opacidade. Da mesma forma, cada tick da contagem regressiva do timer cresce lentamente e depois desaparece exatamente quando o próximo tick está prestes a aparecer, usando a mesma técnica.

A maioria das animações do tema Dashatar é implícita. Isso significa que não é preciso escrever a animação inteira por conta própria, pois os widgets animam mudanças nas propriedades sozinhos. Como exemplo, veja o widget DashatarPuzzleTile para saber como animar o movimento das peças quando o usuário toca em uma peça. Sempre que uma peça é tocada, sua posição atual é atualizada e transicionada durante a movementDuration informada, graças aos AnimatedAlign implicitamente animados.

dart
class DashatarPuzzleTile extends StatelessWidget {
  // ...
​
  final Tile tile;
​
  @override
  Widget build(BuildContext context) {
    return AnimatedAlign(
      alignment: FractionalOffset(
        (tile.currentPosition.x - 1) / (size - 1),
        (tile.currentPosition.y - 1) / (size - 1),
      ),
      duration: movementDuration,
      curve: Curves.easeInOut,
      child: ResponsiveLayoutBuilder(...),
    );
  }
}

Projetando para a web

O quebra-cabeça de exemplo foi construído para a web. Ele implementa design responsivo para três tamanhos de tela: pequeno, médio e grande. Além disso, há um ResponsiveLayoutBuilder que usa um wrapper em torno do widget LayoutBuilder do Flutter, o que permite especificar widgets diferentes para cada breakpoint.

Como tivemos a web como alvo, há algumas considerações adicionais a ter em mente. O app faz pré-cache de imagens e alguns áudios para ajudar a otimizar o desempenho durante o jogo. Quando um usuário chega ao jogo de quebra-cabeça Simple padrão, os assets da versão Dashatar são carregados em segundo plano (adotamos uma abordagem semelhante ao carregar todos os adereços do I/O Photo Booth). Isso garante que, quando o usuário navegar para o tema Dashatar, a maioria dos assets já esteja carregada, proporcionando uma experiência fluida.

Embora o app se sinta em casa na web, você pode se desafiar a explorar formas criativas de fazer o quebra-cabeça se estender a várias plataformas. Como seria seu quebra-cabeça no mobile e no desktop? Como você pode adaptar suas ideias para várias plataformas?

Acessibilidade

O quebra-cabeça deslizante foi construído com acessibilidade em mente. Os usuários podem usar o teclado para interagir com o quebra-cabeça. Isso é feito com o RawKeyboardListener, um widget que chama um callback sempre que o usuário pressiona ou solta uma tecla do teclado. Os usuários também podem interagir com o app usando leitores de tela. Isso é feito com rótulos semânticos. Também há tooltips que aparecem para algumas ações usando o widget Tooltip. Se você estiver construindo sua submissão de quebra-cabeça do zero, recomendamos fortemente tornar seu quebra-cabeça acessível a todos os usuários usando estratégias semelhantes às descritas acima.

Ideias adicionais

Sinta-se à vontade para usar o código de demonstração como base para sua submissão. Ou você pode implementar uma nova ideia do zero. O importante é que sua submissão seja um quebra-cabeça deslizante funcional — mas como você chega lá fica a seu critério!

Os exemplos Simple e Dashatar devem lhe dar algumas ideias sobre onde você pode personalizar ou sobre coisas legais que pode criar por conta própria. Uma ideia interessante que exploramos foi projetar o Flutter Plasma criado por Felix Blaschke sobre as peças do quebra-cabeça. O efeito plasma pode ser obtido usando o widget CustomPaint envolto em um widget Transform e animado com um AnimationController. Você pode encontrar um exemplo do renderizador plasma usado nas demos aqui.

Outra ideia seria buscar imagens ou outros dados de uma API. Por exemplo, você poderia usar a Google Photos API para criar um quebra-cabeça deslizante com fotos de um dos seus álbuns favoritos do Google Photos. O céu é o limite neste desafio!

Veja o código de exemplo do quebra-cabeça aqui. Compartilhe suas criações conosco no Twitter com a #FlutterPuzzleHack. Mal podemos esperar para ver o que você vai criar!

Mais do Flutter