# Prova Virtual por IA para Shopware 6: guia

> Este módulo acrescenta um widget de prova virtual às páginas de produto do Shopware 6. O cliente adiciona uma fotografia sua e a IA do Google Vertex AI gera uma…

- Página: <https://www.datafirefly.com/pt/documentation/shopware-virtual-try-on/>
- Idioma: pt
- Atualizado em: 2026-09-02
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/shopware-virtual-try-on/index.md), [en](https://www.datafirefly.com/en/documentation/shopware-virtual-try-on/index.md), [es](https://www.datafirefly.com/es/documentation/shopware-virtual-try-on/index.md), [de](https://www.datafirefly.com/de/documentation/shopware-virtual-try-on/index.md), [it](https://www.datafirefly.com/it/documentation/shopware-virtual-try-on/index.md), [pl](https://www.datafirefly.com/pl/documentation/shopware-virtual-try-on/index.md), [nl](https://www.datafirefly.com/nl/documentation/shopware-virtual-try-on/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

Este módulo acrescenta um widget de prova virtual às páginas de produto do Shopware 6. O cliente adiciona uma fotografia sua e a IA do Google Vertex AI gera uma pré-visualização da peça vestida. Compatível com Shopware 6.5, 6.6 e 6.7.

## Como funciona

O widget aparece na página de produto, sob o botão de compra. O cliente carrega uma fotografia (ou tira-a com a câmara no telemóvel). A fotografia é reduzida do lado do navegador e depois enviada ao seu servidor. O servidor obtém a imagem do produto, chama a API Google Vertex AI (modelo virtual-try-on-001) e devolve a pré-visualização gerada.

Trata-se de uma renderização generativa, não de uma prova em realidade aumentada em tempo real. Cada pré-visualização é uma chamada à API que devolve uma imagem em poucos segundos.

## Pré-requisitos Google Cloud

O módulo assenta no Vertex AI. É necessária uma configuração única do lado do Google Cloud.

### 1. Criar um projeto e ativar a faturação

- Crie ou selecione um projeto na consola Google Cloud.
- Ative a faturação no projeto, obrigatória para o Vertex AI.

### 2. Ativar a API Vertex AI

Ative a API Vertex AI (aiplatform.googleapis.com) para o projeto.

### 3. Criar uma conta de serviço

- Crie uma conta de serviço.
- Atribua-lhe a função Vertex AI User (roles/aiplatform.user).
- Crie uma chave JSON para essa conta e transfira-a.

## Instalação

Instale o módulo como qualquer extensão Shopware (carregamento do ZIP em Extensões e depois As minhas extensões, ou colocação da pasta em custom/plugins/DfVirtualTryOn), e depois por linha de comandos:

```
bin/console plugin:refresh
bin/console plugin:install --activate DfVirtualTryOn
bin/console cache:clear
```

Não é necessária qualquer compilação do storefront: o widget é autónomo, com estilos e JavaScript incluídos.

## Configuração

Na administração do Shopware, abra a configuração do módulo e preencha:

- **ID do projeto Google Cloud**: o identificador do seu projeto.
- **Região**: uma região onde o modelo esteja disponível (us-central1 por predefinição).
- **Modelo**: virtual-try-on-001 (recomendado).
- **Chave JSON da conta de serviço**: cole a totalidade do ficheiro JSON transferido.
- **Número de imagens**: de 1 a 4 pré-visualizações por prova.
- **Exigir o consentimento**: ativo por predefinição, recomendado.
- **URL da política de privacidade**: apresentado na caixa de consentimento.
- **Etiqueta do botão**: opcional, substitui o texto traduzido por predefinição.

A região é importante: o modelo não está disponível em todo o lado. Se escolher uma região que não o aloja, as chamadas falham com um erro «modelo não encontrado». Em caso de dúvida, use us-central1.

## Privacidade e RGPD

As fotografias dos clientes são dados pessoais. Este módulo envia a fotografia apenas ao Google Vertex AI para gerar a pré-visualização, não conserva nem a fotografia nem o resultado no seu servidor, pode exigir um consentimento explícito antes de cada geração, e permite ligar a sua política de privacidade na caixa de consentimento.

Mantém-se responsável pelo tratamento. Lembre-se de atualizar a sua política de privacidade para indicar que as imagens de prova são tratadas pelo Google Cloud.

## Custos

O Vertex AI fatura cada imagem gerada (tarifário Imagen). Estes encargos ficam do lado do Google Cloud, independentes do preço do módulo. Regule o número de imagens para 1 para controlar o custo.

## Conselhos para bons resultados

- Use uma fotografia nítida, bem iluminada, de corpo inteiro.
- Privilegie imagens de produto claras (esticadas ou em manequim).
- As peças de cima, as de baixo e as peças únicas como os vestidos dão os melhores resultados.

## Resolução de problemas

- **Não autorizado**: a conta de serviço não tem a função Vertex AI User, ou a chave está incorreta.
- **Modelo não encontrado na região**: a região não disponibiliza o modelo. Use us-central1.
- **Não configurado**: o ID do projeto ou a chave JSON está vazio.
- **Limite de débito atingido**: quota do Vertex AI ultrapassada. Tente de novo mais tarde ou peça um aumento de quota.