Pular para o conteúdo principal
Docs
Acessar Studio
Roberty Studio
RPAReconhecimento de Imagem

Encontrar Imagem

Encontrar Imagem

Procura uma imagem específica na tela e retorna suas coordenadas e dimensões caso seja encontrada. Permite verificar a existência do elemento e obter sua localização exata para uso em outras ações.


Opções​

Caminho da imagem a ser identificada​

Informe o caminho completo do arquivo de imagem (screenshot de referência) que o robô irá procurar na tela.

Porcentagem de semelhança​

Informe o percentual mínimo de semelhança para que o reconhecimento seja considerado bem-sucedido.

Tempo de espera​

Informe o tempo máximo em segundos que o robô aguardará para localizar a imagem na tela.

Retornos​

Código Javascript​

js
actions["id-da-acao"].exists // retorna sim, caso o elemento seja encontrado (Booleano)
actions["id-da-acao"].x // coordenada X do elemento encontrado (Número)
actions["id-da-acao"].y // coordenada Y do elemento encontrado (Número)
actions["id-da-acao"].width // largura do elemento encontrado (Número)
actions["id-da-acao"].height // altura do elemento encontrado (Número)
actions["id-da-acao"].centerX // coordenada X do centro do elemento encontrado (Número)
actions["id-da-acao"].centerY // coordenada Y do centro do elemento encontrado (Número)

Seleção de campos​

  • exists — retorna sim, caso o elemento seja encontrado (Booleano)
  • x — coordenada X do elemento encontrado (Número)
  • y — coordenada Y do elemento encontrado (Número)
  • width — largura do elemento encontrado (Número)
  • height — altura do elemento encontrado (Número)
  • centerX — coordenada X do centro do elemento encontrado (Número)
  • centerY — coordenada Y do centro do elemento encontrado (Número)

Regras e Condições​

  • O campo Caminho da imagem a ser identificada é obrigatório.
  • A imagem de referência deve ser uma captura de tela do elemento a ser encontrado.
  • A resolução e escala da tela no ambiente de execução deve ser igual à utilizada durante a captura da imagem.
  • Se a imagem não for encontrada dentro do tempo de espera, a ação gera um erro e interrompe o fluxo.
  • As coordenadas retornadas podem ser utilizadas em ações de mouse para interagir com o elemento encontrado.