Termo do glossário

Como testar controles no iOS e Android

Veja como preparar um teste de controle no iPhone, iPad ou Android. Confira o pareamento, o reconhecimento pelo navegador e os sinais disponíveis antes de interpretar os resultados de botões e analógicos. A compatibilidade depende da combinação de sistema, navegador e controle.

Definição

O que significa Como testar controles no iOS e Android

Como testar controles no iOS e Android: Teste móvel de controle usa a Gamepad API através do iOS Safari (16.4 e posterior) ou Chrome para Android para ler dados de botão e eixo de controles Bluetooth pareados, acessórios certificados MFi ou controles com fio conectados por USB-C.

Também chamado detestar controle navegador iPhonetestar controle navegador Androiddiagnóstico gamepad móvel

Funcionamento

A configuração móvel que funciona

O suporte a controles no navegador mobile chegou tarde - o Safari do iOS só implementou a Gamepad API em março de 2023 (Safari 16.4). O Android teve antes via Chrome. Ambos funcionam para testes básicos de controle hoje, com compromissos reais de confiabilidade comparados ao desktop.

01
Confirme a versão do seu navegador
No iPhone ou iPad, Ajustes → Geral → Sobre mostra a versão do iOS. iOS 16.4 ou posterior é necessário para a Gamepad API no Safari. No Android, o Chrome suporta a Gamepad API no Android 8 e posterior. Celulares mais antigos podem instalar um Chrome ou Firefox moderno, mas ainda podem ter suporte reduzido ao controle no nível do sistema operacional.
02
Pareie um controle Bluetooth
iPhone/iPad: Ajustes → Bluetooth → toque no nome do controle quando aparecer. Android: Configurações → Dispositivos conectados → Parear novo dispositivo. Ambas as plataformas aceitam DualSense, Xbox Wireless Controller, 8BitDo Pro 2 e qualquer controle Bluetooth moderno. Coloque o controle em modo de pareamento primeiro - geralmente um pequeno botão de pareamento pressionado até um LED piscar rápido.
03
Use USB-C para controles MFi e com fio
iPhone 15 e posterior, todos os modelos de iPad Pro/Air e todo celular Android moderno usam USB-C. Controles com fio certificados MFi como Backbone One (variante USB-C), Razer Kishi V2 e GameSir X2 Pro conectam direto na porta USB-C do celular. O controle é detectado assim que é conectado - sem necessidade de pareamento Bluetooth.
04
Abra o navegador e pressione um botão
Mesma regra do desktop - o navegador esconde o controle até você interagir com ele. Abra a página de teste, toque nela para focar a página e pressione qualquer botão no controle. O testador deve mostrar imediatamente o ID do controle e começar a ler botões e eixos.
05
Orientação paisagem para a melhor visualização do teste
A maioria dos testadores de controle mostra eixos e estado dos botões em um layout amplo que fica melhor em paisagem. Gire o celular ou tablet antes de iniciar o teste para evitar que a interface fique apertada. No iPad, isso é especialmente valioso - o espaço extra na tela permite ver todos os eixos e todos os botões de uma vez.

Diagnóstico

Teste de Como testar controles no iOS e Android

Diagnóstico completo do controle

Teste de drift do analógico

Teste de botões do controle online

Teste de zona morta

Teste de latência do controle: intervalos no navegador

Soluções

Soluções Como testar controles no iOS e Android

Gamepad Não Detectado no PC

Controle Bluetooth Fica Desconectando

Controles relacionados

Controles relacionados a Como testar controles no iOS e Android

PS5 DualSense

Xbox Elite Series 2

8BitDo Ultimate

GuliKit KingKong 3 Max

Veja também

Outros termos do glossário

Protocolo sem fio

Atraso de entrada

Modo de pareamento

Perguntas frequentes

perguntas Como testar controles no iOS e Android

Três causas mais comuns. Primeiro, verifique sua versão do iOS - 16.4 ou posterior é necessário para suporte à Gamepad API. Segundo, confirme que o controle está pareado em Ajustes → Bluetooth e mostra Conectado, não apenas Não conectado. Terceiro, toque na página do navegador para dar foco a ela e então pressione qualquer botão - o navegador esconde o controle até detectar interação do usuário com a página enquanto o controle reporta entrada.

Não. Bluetooth no mobile adiciona latência significativa comparado ao com fio no desktop - tipicamente 15-30ms de base versus 3-6ms com fio. Para testes funcionais básicos (esse botão registra, esse analógico se move) funciona bem. Para medição séria de latência ou comparação de taxa de polling, use uma configuração desktop com fio. Teste mobile é conveniência primeiro, precisão depois.

Para a Gamepad API no Safari, ambos os tipos funcionam pela mesma interface - botões e eixos reportam de forma idêntica. Onde eles diferem é no nível do app e para vibração: certificação MFi garante compatibilidade com o framework Game Controller da Apple e frequentemente libera recursos adicionais. Para testes no navegador especificamente, um controle MFi e um controle Xbox Bluetooth produzem resultados equivalentes.

Sim - são controles com fio USB-C que conectam direto no seu celular. Eles aparecem como controles de jogo padrão para a Gamepad API do navegador imediatamente após a conexão. Este é um dos caminhos de teste mobile mais confiáveis porque não há pilha Bluetooth no meio. Note que Backbone e Kishi não têm seus próprios analógicos ou botões que diferem do seu celular - eles envolvem o celular em um encaixe de controle.

Pilhas Bluetooth mobile são menos estáveis que desktop sob condições de RF congestionado. Causas comuns: outro dispositivo Bluetooth (fones, relógio) competindo por largura de banda, bateria baixa do controle drenando mais rápido que o esperado em controles novos que consomem mais energia, ou o celular em modo de economia agressivamente suspendendo atividade Bluetooth em segundo plano. Tente desabilitar outros dispositivos Bluetooth durante o teste e confirme que a bateria do controle está acima de 30%.

Versões recentes do Safari adicionaram suporte a GamepadHapticActuator para vibração dual, mas a cobertura é irregular entre controles. Controles certificados MFi variam - alguns modelos oficialmente não suportam vibração mesmo quando conectados. A forma mais segura de verificar: rode o teste de vibração do testador do navegador e veja o que acontece. Se nada vibra, pode ser o controle ou a versão específica do Safari em vez de uma limitação fundamental.

Joy-Cons pareiam via Bluetooth no iOS 16 e Android 10 e posterior, mas aparecem como controles separados 'esquerdo' e 'direito' em vez de um controle unificado. A maioria dos testadores de Gamepad API no navegador não lida bem com esse pareamento - você verá dois controles cada um reportando um subconjunto de entradas em vez de um controle combinado. O pareamento nativo do Switch é o uso pretendido; testes no navegador funcionam mas são desajeitados.

Abra o navegador, toque na página e pressione qualquer botão no controle. Se o testador mostra o nome do controle e começa a ler entradas em um segundo, está tudo certo. Se continuar em 'nenhum controle detectado' após 10-15 segundos pressionando botões, a plataforma não suporta aquele controle no navegador - tente um controle diferente ou volte para desktop.

Fontes