# Wirtualna Przymierzalnia AI dla Shopware 6: przewodnik

> Ten moduł dodaje widget wirtualnej przymierzalni na kartach produktów Shopware 6. Klient dodaje swoje zdjęcie, a AI Google Vertex generuje podgląd noszonego ubrania. Zgodny z Shopware 6.5, 6.6 i 6.7.…

- Strona: <https://www.datafirefly.com/pl/documentation/shopware-virtual-try-on/>
- Język: pl
- Zaktualizowano: 2026-07-29
- Inne języki: [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), [nl](https://www.datafirefly.com/nl/documentation/shopware-virtual-try-on/index.md), [pt](https://www.datafirefly.com/pt/documentation/shopware-virtual-try-on/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

Ten moduł dodaje widget wirtualnej przymierzalni na kartach produktów Shopware 6. Klient dodaje swoje zdjęcie, a AI Google Vertex generuje podgląd noszonego ubrania. Zgodny z Shopware 6.5, 6.6 i 6.7.

## Jak to działa

Widget wyświetla się na karcie produktu, pod przyciskiem zakupu. Klient przesyła zdjęcie (albo robi je aparatem na telefonie). Zdjęcie jest zmniejszane po stronie przeglądarki, a następnie wysyłane na Twój serwer. Serwer pobiera obraz produktu, wywołuje API Google Vertex AI (model virtual-try-on-001) i zwraca wygenerowany podgląd.

To rendering generatywny, a nie przymierzanie w rozszerzonej rzeczywistości w czasie rzeczywistym. Każdy podgląd to wywołanie API, które zwraca obraz w kilka sekund.

## Wymagania Google Cloud

Moduł opiera się na Vertex AI. Konieczna jest jednorazowa konfiguracja po stronie Google Cloud.

### 1. Utworzenie projektu i włączenie płatności

- Utwórz albo wybierz projekt w konsoli Google Cloud.
- Włącz płatności w projekcie, jest to obowiązkowe dla Vertex AI.

### 2. Aktywacja API Vertex AI

Aktywuj API Vertex AI (aiplatform.googleapis.com) dla projektu.

### 3. Utworzenie konta serwisowego

- Utwórz konto serwisowe.
- Przypisz mu rolę Vertex AI User (roles/aiplatform.user).
- Utwórz klucz JSON dla tego konta i pobierz go.

## Instalacja

Zainstaluj moduł jak każde rozszerzenie Shopware (przesłanie ZIP w sekcji Rozszerzenia, potem Moje rozszerzenia, albo umieszczenie katalogu w custom/plugins/DfVirtualTryOn), a następnie z wiersza poleceń:

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

Nie jest potrzebna żadna kompilacja storefrontu: widget jest samodzielny, style i JavaScript są w zestawie.

## Konfiguracja

W administracji Shopware otwórz konfigurację modułu i uzupełnij:

- **ID projektu Google Cloud**: identyfikator Twojego projektu.
- **Region**: region, w którym model jest dostępny (domyślnie us-central1).
- **Model**: virtual-try-on-001 (zalecany).
- **Klucz JSON konta serwisowego**: wklej całą zawartość pobranego pliku JSON.
- **Liczba obrazów**: od 1 do 4 podglądów na jedno przymierzenie.
- **Wymagaj zgody**: domyślnie włączone, zalecane.
- **Adres URL polityki prywatności**: wyświetlany w polu zgody.
- **Etykieta przycisku**: opcjonalna, zastępuje domyślny przetłumaczony tekst.

Region ma znaczenie: model nie jest dostępny wszędzie. Jeśli wybierzesz region, który go nie hostuje, wywołania zakończą się błędem "nie znaleziono modelu". W razie wątpliwości użyj us-central1.

## Prywatność i RODO

Zdjęcia klientów są danymi osobowymi. Ten moduł wysyła zdjęcie wyłącznie do Google Vertex AI w celu wygenerowania podglądu, nie przechowuje ani zdjęcia, ani wyniku na Twoim serwerze, może wymagać wyraźnej zgody przed każdym generowaniem i pozwala podlinkować Twoją politykę prywatności w polu zgody.

Pozostajesz administratorem danych. Pamiętaj o zaktualizowaniu swojej polityki prywatności, aby wskazać, że obrazy przymierzania są przetwarzane przez Google Cloud.

## Koszty

Vertex AI nalicza opłatę za każdy wygenerowany obraz (cennik Imagen). Te koszty są po stronie Google Cloud, niezależnie od ceny modułu. Ustaw liczbę obrazów na 1, aby kontrolować koszt.

## Wskazówki na dobre wyniki

- Używaj ostrego, dobrze oświetlonego zdjęcia całej sylwetki.
- Preferuj czytelne zdjęcia produktu (na płasko albo na manekinie).
- Góry, doły i pojedyncze elementy jak sukienki dają najlepsze rezultaty.

## Rozwiązywanie problemów

- **Brak autoryzacji**: konto serwisowe nie ma roli Vertex AI User albo klucz jest nieprawidłowy.
- **Nie znaleziono modelu w regionie**: region nie udostępnia modelu. Użyj us-central1.
- **Nieskonfigurowane**: ID projektu albo klucz JSON jest pusty.
- **Osiągnięto limit przepustowości**: przekroczony limit Vertex AI. Spróbuj później albo poproś o zwiększenie limitu.