Arbeiten mit Widgets > 3D > Produkt
Produkt
* 
Dieses Widget ist nur mit Vuforia Studio und Experience Service 10.0.0 und höher verfügbar.
Was macht dieses Widget?
Das Produkt-Widget ermöglicht es Ihnen, wiederverwendbare Assets, wie Modelle und Modellziele, abzurufen, ohne Code schreiben zu müssen. Produktspezifische Daten, die zuvor in den Experience Service hochgeladen bzw. auf ihm generiert wurden, werden automatisch mithilfe der Produkt-API abgerufen, sodass Sie dynamische Inhalte ganz einfach in Ihre Erlebnisse integrieren können. Weitere Informationen finden Sie unter Vuforia Studio Produkt-API.
Wann sollte ich dieses Widget verwenden?
Verwenden Sie ein Produkt-Widget in jedem Erlebnis, in dem Sie Modelle und Modellziele dynamisch aus Ihrem Experience Service laden möchten. Verbinden Sie das Produkt-Widget einfach mit dem Modell-Widget und dem Widget Dynamisches Ziel, um sicherzustellen, dass die abgerufenen Assets zur Laufzeit nahtlos geladen werden. Es muss kein Skript erstellt werden..
Bei Verwendung dieses Widgets folgt das Erlebnis einer definierten Logik:
• Wenn das Modell vereinfacht wurde, ruft das Erlebnis automatisch die Version mit mittlerer Qualität ab.
• Sind mehrere Modellziele verfügbar, so lädt das Erlebnis die beste verfügbare Qualität in der folgenden Reihenfolge: Erweitert, erweitert (vor Ort), gefolgt von Standard. Wenn mehrere Versionen mit derselben Qualität vorhanden sind, wird automatisch die neueste Version ausgewählt.
Eine schrittweise Anleitung finden Sie unter Anwendungsfall: Assets dynamisch laden und vergleichen.
Gibt es besondere Eigenschaften, Dienste, Ereignisse oder Aktionen?
Eine Liste von allgemeinen Widget-Eigenschaften, -Diensten und -Ereignissen finden Sie unter Allgemeine Widget-Eigenschaften, -Dienste und -Ereignisse.
* 
Sollten Sie sich nicht sicher sein, welche Version von Experience Service Sie ausführen, so wenden Sie sich an Ihren Administrator.
Eigenschaftsname
JavaScript
Typ
Beschreibung
Produkt-ID
productID
string
Produkt-ID des Produkts
Version
version
string
Gibt die Version des Produkts an. Ein Produkt kann mehrere Versionen haben. Wenn keine Version angegeben wird, wird standardmäßig die neueste verfügbare Version verwendet.
* 
"Neueste Version" bezieht sich auf die zuletzt erstellte Version, nicht notwendigerweise auf die Version mit der höchsten Versionsnummer.
Modell
modelUri
string
Modellressourcen-URL des Produkts (.pvz-Datei)
Ziel
targetUri
string
Zielressourcen-URL des Produkts (.dat-Datei)
* 
Das Produkt-Widget wird verwendet, um Produktdaten basierend auf einer Produkt-ID und einer optionalen Version zu laden und anzuzeigen. Wenn Sie sowohl eine Produkt-ID als auch eine Version angeben, lädt das Widget diese bestimmte Version des Produkts. Wenn Sie nur eine Produkt-ID angeben und die Version leer lassen, lädt das Widget automatisch die neueste Version des Produkts.
Ereignis
JavaScript
Beschreibung
Produkt geladen
productLoaded
Wird ausgelöst, sobald die produktbezogenen URLs erfolgreich abgerufen wurden. Verwenden Sie das modelLoaded-Ereignis des Modellziel-Widgets, um zu sehen, wann das Modell vollständig geladen ist.
Laden des Produkts fehlgeschlagen
productFailed
Wird ausgelöst, wenn das Laden des Produkts fehlschlägt.
* 
Wenn die von Ihnen angegebene Kombination aus Produkt-ID oder Produkt-ID-Version nicht gefunden werden kann, wird das Product Failed-Ereignis ausgelöst. Dieses Ereignis zeigt nicht automatisch eine Fehlermeldung in der Benutzeroberfläche an. Als Autor des Erlebnisses liegt es in Ihrer Verantwortung, dieses Ereignis zu verwenden, um alle erforderlichen Fehlerbenachrichtigungen oder Fallback-Verhaltensweisen für Ihr Erlebnis zu erstellen. So haben Sie die vollständige Kontrolle darüber, wie fehlende Produktdaten an Ihre Benutzer kommuniziert werden.
Beispiel-Anwendungsfall
Sehen Sie sich die folgenden Anwendungsfälle an:
War dies hilfreich?