Wirtualna Przymierzalnia AI dla Shopware 6: przewodnik
Instalacja i konfiguracja modułu wirtualnej przymierzalni AI dla Shopware 6: Google Cloud, Vertex AI, RODO i rozwiązywanie problemów.
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:clearNie 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.