Zum Hauptinhalt springen

Interactions

Interactions sind vordefinierte Funktionen, die im Backend (Unity) definiert sind. Mit diesen können Änderungen an einem Produkt/Visualisierung vorgenommen werden.

Anlegen von Interactions​

Mit dem Button “Erstellen“, innerhalb der CRUD-Komponente kann hier eine neue Interaction erstellt werden. Mit den “Inline-Icons“ kann eine vorhandene Interaction editiert oder betrachtet werden.

Hiermit können Backendfunktionen (im Unity) aufgerufen/ausgeführt werden. → z.B. Ändern der Materialfarbe eines 3D-Objektes

  • Code (obligatorisch) → techn. Name der Interactions. Dieser kann frei gewählt werden, soll aber der allgem. Nomenklatur entsprechen und muss innerhalb der Interactions einmalig sein.

  • ActionName (obligatorisch) → Definition einer Action. Actions sind Funktionen im Backend, die an verschiedenen Stellen im 3D-Customizing angewendet werden können. → z.B. “ChangeColor“

  • Descriptions (optional) → Beschreibung der Interaction, in “n“ Sprachen

    • de_de = Farbe wechseln
    • en_en = Change Color
    • ...

Mit “Erstellen” öffnet sich der Erfassungsdialog für eine neue Interaction. Alternativ kann eine bereits definierte Interaction betrachtet oder editiert werden.

  1. “Code” definieren
  2. “ActionName“ zuweisen
  3. Die “Description“ kann bei Bedarf mehrsprachig erfasst werden
  4. Speichern → Erstellen der neuen Interaction
  5. Speichern → Speichern der Änderungen

Interaction-Parameters​

Mit den InteractionParameters können den Backendfunktionen (Unity) zusätzliche Parameter mitgegeben werden. → z.B. den Namen einer fix hinterlegten Textur, die immer bei der Ausführung zugewiesen werden soll

Wichtig: Die InteractionParameter, die direkt in einer Interaction gepflegt werden, sind global gültig und werden bei jedem Aufruf der Interaction gesetzt. Hingegen sind kontextbezogene InteractionParameter (z.B. CharacteristicInteractionParameter) kontextbezogen und werden nur gesetzt, wenn die Interaction in Bezug zu der entsprechenden Characteristic ausgeführt wird.

  • Code (obligatorisch) → techn. Name des InteractionsParameters. Dieser kann frei gewählt werden, soll aber der allgem. Nomenklatur entsprechen und muss innerhalb der InteractionsParameters einmalig sein.

  • Type (obligatorisch)

    • Choice → Aktuell gibt es nur den Type Choice, der einen Wert in einer BackendFunktion setzt

  • Parameter (obligatorisch) → Hier wird der Wert mitgegeben, der in der betreffenden Backendfunktion gesetzt werden soll (z.B. “Logo“)

  • Description (optional) → Beschreibung des InteractionParameters, in “n“ Sprachen

    • de_de = Reference 01
    • en_en = Reference 01
    • ...

Hier können den Interaction, InteractionParameters zugewiesen werden.

  1. Mit “Erstellen” öffnet sich der Erfassungsdialog für einen neuen InteractionParameter. Alternativ kann ein bereits definierter InteractionParameter betrachtet oder editiert werden.
  2. “Type” definieren
  3. Parameter zuweisen
  4. Die “Description“ kann bei Bedarf mehrsprachig erfasst werden
  5. Speichern → Erstellen der neuen InteractionParameters
  6. Speichern → Speichern der Änderungen

Einer Interaction können “n” InteractionParameters zugewiesen werden.

Interactions Typen

ChangeColor​

Die Farbe eines GameObjects wird geändert. Die spezifische Farbe wird durch die entsprechende Choice bestimmt.

  • Wichtig: Der Wert muss derzeit als HEX-Code ausgeführt werden (z.B. “#FF00FF”).
  • Es ist auch möglich, die Transparenz des Alpha-Kanals zu definieren, indem zwei zusätzliche Stellen zum HEX-Code hinzugefügt werden (z.B. “#FF00FF71”).
    • “00” (entspricht vollständig transparent) - “FF” (nicht transparent).

Notwendige InteractionParameter Typen:​

  • Choice
    • Dieser Parameter gibt an, auf welche Characteristic/Choice diese Interaktion reagieren soll. Wichtig: Der Wert muss genau mit dem Namen eines Prefabs in den relevanten Addressables übereinstimmen.
  • GameObjectName
    • Dieser Parameter gibt an, welchem Mesh innerhalb der relevanten ObjectInformation die Interaktion zugewiesen werden soll oder welches Mesh die Farbe übernehmen soll. Wichtig: Der Pfad zum relevanten Mesh (relativ zur relevanten ObjectInformation) muss angegeben werden.
      • z.B., → Folder01/Sub-Folder02/MeshName

ChangePrefab​

Lädt und spawnt GameObjects aus den Addressables, bei denen der Name mit der aktuellen Choice übereinstimmt.

Notwendige InteractionParameter Typen:​

  • Choice
    • Dieser Parameter gibt an, auf welche Characteristic/Choice diese Interaktion reagieren soll.
      Wichtig: Der Wert muss genau mit dem Namen eines Prefabs in den relevanten Addressables übereinstimmen.
  • CodeParameterPair
    • Code: PrefabContainerPath
      • Dieser Parameter gibt den Pfad an, wo der leere Container erstellt werden soll, in dem die GameObjects gespawnt werden sollen (relativ zur relevanten ObjectInformation).
    • Code: DefaultPrefab (OPTIONAL)
      • Dieser Parameter gibt den Namen des Prefabs an, das angezeigt werden soll, wenn keine Choice vorhanden ist.
    • Code: PrefabContainerPosition (OPTIONAL | Standard = “0;0;0;”)
      • Dieser Parameter gibt die Position für den Container im Format “x;y;z” an.
        Wichtig: Verwenden Sie den “Punkt als Dezimaltrennzeichen”.
    • Code: PrefabContainerRotation (OPTIONAL | Standard = “0;0;0;”)
      • Dieser Parameter gibt die Rotation für den Container im Format “x;y;z” an.
        Wichtig: Verwenden Sie den “Punkt als Dezimaltrennzeichen”.
    • Code: PrefabContainerScale (OPTIONAL | Standard = “1;1;1;”)
      • Dieser Parameter gibt die Skalierung für den Container im Format “x;y;z” an.
        Wichtig: Verwenden Sie den “Punkt als Dezimaltrennzeichen”.

ChangeVisibility​

Eine Interaktion, die ein GameObject ein- oder ausblendet (innerhalb der relevanten ObjectInformation), wenn der Name mit der aktuellen Choice übereinstimmt. Wenn die Choice vom Namen abweicht, wird das GameObject ausgeblendet.

Notwendige InteractionParameter Typen:​

  • Choice
    • Dieser Parameter gibt an, auf welche Characteristic/Choice diese Interaktion reagieren soll.
      Wichtig: Der Wert muss genau mit dem Namen eines GameObjects in der relevanten ObjectInformation übereinstimmen.
  • GameObjectName
    • Dieser Parameter gibt an, welchem GameObject innerhalb der relevanten ObjectInformation die Interaktion zugewiesen werden soll.
      Wichtig: Der Pfad zum relevanten Mesh (relativ zur relevanten ObjectInformation) muss angegeben werden.
      • z.B., → Folder01/Sub-Folder02/MeshName