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 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.

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

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.

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.