Escanear pilotos

5Escanear um piloto

O fluxo completo de uma leitura, o que significa cada campo da tela de confirmação, o que acontece quando você toca em Confirmar, e no que a categoria Register é diferente de todas as outras.

Misto, ver o capítulo

O fluxo, do começo ao fim#

Uma leitura são sempre as mesmas quatro telas, e quando você as conhece atravessa em poucos segundos.

  1. Toque em Escanear QR. A câmera abre na tela Escanear QR do piloto.
  2. Aponte para o QR do piloto. Ele é lido sozinho, não há botão de disparo. O ícone de câmera no canto superior direito alterna entre a traseira e a frontal.
  3. Preparando leitura aparece enquanto o app procura o piloto. É aqui que ele fala com o servidor, ou recorre ao cache do celular.
  4. Confirmar leitura mostra quem você está prestes a registrar. Confira o rosto e o nome e toque em Confirmar ou Cancelar.
  5. Uma mensagem embaixo diz o que aconteceu, e Próximo piloto oferece reabrir a câmera na hora.
Fig. 5.1A tela Escanear QR do piloto, segurada sobre o celular de um piloto. Não há botão de disparo: mantenha firme e ele lê. O ícone no canto superior direito troca de câmera.

Dica

Próximo na caixa Próximo piloto mantém o ciclo da câmera sem voltar para a aba, que é o que você quer com uma fila de pilotos na sua frente. Fechar leva você de volta.

Se a lista de pilotos nunca foi carregada para esta competição, o app vai buscá-la antes de abrir a câmera, então a primeira leitura do dia pode demorar um pouco mais do que as outras.

A tela de confirmação#

Esta tela existe para que nada seja registrado na pessoa errada. É o único lugar onde um erro ainda sai de graça.

Foto e nome
A foto de inscrição do piloto, em cache no celular e por isso visível também offline. Compare com a pessoa na sua frente, não com o nome no QR.
ID do piloto na comp.
O número de competição, o da asa e o do placar. O mais rápido de ler em voz alta na hora de registrar alguém.
País e status
Dois selos. O status é o status de inscrição vindo do servidor, por exemplo Confirmed ou Pending, e fica destacado quando diz confirmado.
Asa e Selete
O equipamento registrado, se a inscrição tiver. Útil nas checagens de material.

O cartão de baixo repete como a leitura será registrada: Competição, Categoria, Fase e Fonte.

Pré-visualização online
O servidor acabou de ser consultado sobre este piloto. Tudo o que está na tela está atual, inclusive o histórico de leituras dele.
Cache offline
O servidor não estava acessível, então o piloto foi resolvido pela lista em cache no celular. A identidade é confiável, o histórico não é mostrado, e a leitura vai para a fila.

Atenção

Cancelar descarta a leitura por completo. Nada é registrado e nada é enfileirado. Use sempre que a foto não bater.

O histórico de leituras na tela de confirmação#

Numa pré-visualização online de qualquer categoria exceto Register, a tela também lista o que já foi registrado para este piloto, da mais recente para a mais antiga. Cada linha dá a categoria, a fase quando a categoria tem uma, e embaixo a hora, quem escaneou e o status.

A linha de resumo se lê como Total de 6 leituras confirmadas. Limite 50. e, quando há mais do que cabe, Mais leituras estão disponíveis no servidor.

Essa é a sua checagem de duplicados. Se a categoria que você vai escanear já estiver nessa lista, o piloto já passou por esse portão, e você pode decidir se é o esperado antes de tocar em Confirmar.

Nota

Escanear a mesma categoria duas vezes não é perigoso. O servidor reconhece e responde ... já confirmado para ..., que o app trata como sucesso e não como erro. Nada é duplicado.

A categoria Register#

Register é a categoria que você escaneia na inscrição, quando o piloto chega ao evento. Ela se comporta de forma diferente de todas as outras em três pontos.

  • Sempre precisa de internet. Não existe alternativa offline, porque a ficha de inscrição é importante demais para ser adivinhada a partir de um cache. Offline aparece O registro requer internet para carregar os detalhes completos.
  • Mostra a ficha de inscrição inteira, e não um histórico de leituras. Veja abaixo.
  • Offline, ela condiciona as outras categorias. Enquanto este celular não tiver visto uma leitura Register confirmada para um piloto, ele se recusa a enfileirar qualquer outra categoria para ele.

No lugar do cartão de histórico, uma leitura Register mostra Detalhes do registro, agrupados em seções que seguem o formulário de inscrição do site:

Identidade
Nome, e-mail, país, status, ID de competição, ID de registro e de usuário, asa e selete.
Registro
A própria ficha de inscrição, do jeito que o site a guarda.
Inscrição personalizada
As respostas às perguntas de inscrição próprias da competição, resolvidas com os rótulos delas quando o site fornece.
Documentos obrigatórios
O que esta competição exige, se os documentos são exigidos antes de um certo ponto, e o estado de cada um.
Documentos
Cada documento enviado com o tipo, o nome do arquivo e o status de verificação.
Detalhes adicionais
Todo o resto que o servidor mandou e não cabe nas seções acima.

Bem no fim, Raw payload JSON pode ser expandido para ver exatamente o que o servidor devolveu. Está ali para os casos de suporte: se algo parecer errado, é esse texto que os desenvolvedores precisam.

Nota

Se o registro do piloto já estiver confirmado, o app diz Registro já confirmado para este piloto. e não registra nada de novo. É uma resposta normal, não uma falha.

O que Confirmar faz de verdade#

Tocar em Confirmar dá à leitura um identificador único e a envia. Qual dos quatro desfechos acontece depende da conexão e da resposta do servidor.

Mensagem Significado
Decolagem confirmado para Anna Muller. Registrada no servidor. Feito.
Decolagem já confirmado para Anna Muller. O servidor já tinha. Nada foi duplicado, e isso conta como sucesso.
Decolagem enfileirado para Anna Muller. Sem conexão. Guardada no celular, ela vai se enviar sozinha. Veja Escanear offline e a fila.
Falha ao enviar a leitura. O servidor recusou. A leitura não foi registrada nem enfileirada. O motivo está no aviso de erro da aba.

É esse identificador único que torna segura uma nova tentativa. Se a conexão cair bem na hora do envio, mais tarde o mesmo identificador é usado, e o servidor reconhece a segunda tentativa como a mesma leitura e não como uma nova.

Atenção

Não existe desfazer. Uma leitura registrada no piloto errado ou na categoria errada só pode ser removida pelo organizador no site. Anote o piloto e a hora e avise, em vez de tentar consertar escaneando de novo.

QR codes que não funcionam#

O leitor só lê QR codes e espera um token de piloto do SkyTrackPro. Duas falhas são frequentes.

Não foi possível ler um token SkyTrack válido deste QR code.
É um QR code, mas não um token de piloto. Normalmente um código de wifi, um cartão de embarque, um ingresso, ou o código de um sistema totalmente diferente.
Piloto não encontrado no cache local. Atualize o cache quando estiver online e tente novamente.
Um token válido, mas ninguém com ele está na lista deste celular. Quase sempre um piloto inscrito depois da sua última sincronização. Arranje conexão e use Atualizar cache de pilotos.

Dica

O token de um piloto também funciona a partir de uma captura de tela ou de uma impressão, então uma bateria acabada não trava a inscrição. O app do piloto consegue mostrar o código, e o perfil do piloto no site também.