Afegir marcadors a models en 3D al Power Apps

Pots afegir pins (que es mostren com a marcadors circulars) a punts concrets dels models 3D que mostris amb el control Visualitza en 3D.

Aquest tema us guiarà per mitjà de la creació d'una aplicació de prova amb un model 3D al qual podeu inserir els perns. Us mostrarà com:

  • Utilitzeu una llista predefinida de perns d'un llibre d'exercicis d'Excel per col·locar els perns a un model 3D.
  • Visualitzar informació sobre cadascun dels perns de l'aplicació.
  • Crear una col·lecció per permetre que els usuaris de l'aplicació creïn els seus propis perns.

Inserir i connectar els perns a un model 3D

Amb una aplicació oberta per editar al Power Apps Studio, podeu inserir un model 3D i connectar una llista de perns.

En primer lloc, inseriu un model 3D:

  1. Obre la pestanya Insereix.

  2. Amplieu Elements multimèdia.

  3. Selecciona el control Visualitza en 3D per col·locar-lo al centre de la pantalla de l'aplicació o arrossega'l per col·locar-lo en qualsevol lloc de la pantalla.

    Insereix la visualització al control 3D a l'aplicació.

    S'inclou una forma per defecte al control. Podeu canviar aquesta forma a una altra alterant la propietat d'Origen. Per obtenir més informació, vegeu com es defineix on s'emmagatzema el contingut en 3D. En aquest exemple, farem servir l'adreça URL https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/chair.glb.

Nota

Aquest control s'anomenarà ViewIn3D1 per defecte, i és com es farà referència al llarg d'aquesta guia. Si afegiu diverses versions d'aquest control, haureu d'ajustar les referències.

Per exemple, si inseriu una segona còpia del control, per defecte es cridarà ViewIn3D1_1 i s'hauran de canviar les referències de codi per referir-s'hi.

Ara haureu de connectar un conjunt de perns predefinits al model.

Podeu connectar els perns predefinits de diverses maneres, però el més fàcil és utilitzar una taula en un llibre d'exercicis d'Excel.

El llibre de treball ha de contenir una taula amb nom amb les columnes següents que, a continuació, s'ha d'assignar a la propietat associada a la subfinestra Avançada del control.

Descripció de la columna S'assigna a la propietat
Etiqueta per al marcador ItemsLabels
Dimensió X del pern PernsX
Dimensió Y del pern PernsY
Dimensió Z (profunditat) del pern PernsZ

Important

Els controls de realitat mixta (MR) utilitzen un sistema de coordenades esquerrà.

El següent és un exemple d'una taula de l'Excel amb les columnes necessàries:

Fitxer d'Excel d'exemple amb una taula anomenada Taula1 i que conté les columnes d'etiqueta, de marcadors X, de marcadors Y i de marcadors Z

Podeu copiar les següents dades d'exemple per provar aquesta funcionalitat:

Etiqueta Perns X Perns Y Perns Z
Frontal esquerra -0.20 0.01 0.20
Frontal dreta 0.20 0.01 0.20
Zero 0.00 0.00 0.00
Punt X 0.00 0.72 -0.20
  1. Copieu i enganxeu la taula en un nou llibre de treball de l'Excel.

  2. Seleccioneu una de les cel·les i, a continuació, a la pestanya Inici de la franja, seleccioneu Formata com a taula i trieu qualsevol estil i, a continuació, D'acord.

    Captura de pantalla que ressalta l'opció de format com a taula a l'Excel

  3. Seleccioneu la taula i, a continuació, aneu a la pestanya Disseny de la taula a la franja. Introduïu un nom per a la taula a Nom de la taula:, per exemple TestData.

    Captura de pantalla que ressalta el camp de nom de la taula a l'Excel

  4. Deseu el llibre.

  5. A la vostra aplicació oberta, aneu a la subfinestra Propietats, seleccioneu el camp Perns(elements), a continuació, cerqueu l'excel i seleccioneu Importa des de l'Excel.

    Al camp dels marcadors(elements), escriure a l'Excel mostra l'opció d'importar des de l'Excel.

  6. Localitzeu el llibre de l'Excel i, a continuació, seleccioneu Obre. Seleccioneu la taula que conté la informació, TestData i, a continuació, Connecta.

    A la opció Trieu una taula, s'ha seleccionat la taula anomenada TestData.

  7. A la subfinestra Propietats, aneu a la pestanya Avançat i seleccioneu Més opcions.

  8. Definiu les propietats següents:

    • PinsX com a "Marcadors X"
    • PinsY com a "Marcadors Y"
    • PinsZ com a "Marcadors Z"
  9. El control 3D ara mostrarà cada fila de la taula com un pin.

Visualitzar l'etiqueta i altres dades sobre cada pern

Podeu mostrar l'etiqueta associada amb el pern seleccionat actualment introduint un control de taula de dades i configurant-lo per mostrar tots els perns o el pern seleccionat actualment.

Exemple que mostra el model principal amb tres marcadors, un dels quals està seleccionat i la informació sobre ell (les coordenades d'etiqueta, d'X, d'Y i de Z) es mostra a la taula següent.

  1. Obre la pestanya Insereix.

  2. Expandiu Disposició.

  3. Seleccioneu el control Taula de dades i col·loqueu-lo a la pantalla de l'aplicació.

  4. Trieu mostrar tots els perns o només el pern seleccionat:

    1. Mostra tots els perns: a la subfinestra Propietats, definiu la propietat Font de dades a la taula de l'Excel que heu afegit.

      Sota Font de dades, seleccioneu l'opció de la taula d'Excel.

    2. Només els perns seleccionats: a l'editor d'expressions de la part superior, definiu la propietat d'elements a ViewIn3D1.SelectedItems.

      El codi es mostra a l'editor d'expressions.

  5. A la subfinestra Propietats, seleccioneu Editar els camps i, a continuació, Afegiu un camp. Seleccioneu cadascun dels camps i, a continuació, Afegiu.

    A la subfinestra de camps, se seleccionen totes les opcions (d'etiqueta, de marcadors X, de marcadors Y i de marcadors Z).

També podeu afegir una única etiqueta del quadre de text per mostrar el pern seleccionat:

  1. Obre la pestanya Insereix.
  2. Seleccioneu el control Etiqueta de text i col·loqueu-lo a la pantalla de l'aplicació.
  3. Canviar la propietat Text a ViewIn3D1.Selected.Label.

Crear una col·lecció per permetre als usuaris definir els seus propis perns a l'aplicació.

Podeu crear una col·lecció dins de l'aplicació per tal que els usuaris puguin crear els seus propis perns que es mostraran al model 3D:

  1. Obre la pestanya Insereix.

  2. Seleccioneu el control d'Entrada de text i col·loqueu-lo a la pantalla de l'aplicació. Copieu-lo i enganxeu-lo per tenir quatre controls d'entrada de text.

  3. Canvieu la propietat Per defecte de cada control a X, Y, Z i Label.

  4. A la Visualització d'arbre, canvieu el nom d'un control a:

    1. CoordenadaX
    2. CoordenadaY
    3. CoordenadaZ
    4. LabelInput

    A la visualització d'arbre, es mostren alguns controls, amb cadascun dels controls d'entrada de text mencionats.

  5. Obriu la pestanya Insereix i seleccioneu el control de Botó. Poseu-la en una zona lliure a la pantalla de l'aplicació. Definiu la propietat Text a Add pin.

  6. Definiu la propietat OnSelect a:

    Collect( 
    PinsCollection,
      {
        X: XCoordinate.Text,
        Y: YCoordinate.Text,
        Z: ZCoordinate.Text,
        Label: LabelInput.Text
      }
    )
    
  7. Seleccioneu la visualització al control 3D i canvieu la propietat Pins(Elements) a PinsCollection.

    Al camp dels marcadors(elements), seleccioneu l'opció de PinsCollection.

  8. A la subfinestra Propietats, aneu a la pestanya Avançat i seleccioneu Més opcions.

  9. Definiu les propietats següents:

    • PinsX com a "X"
    • PinsY com a "Y"
    • PinsZ com a "Z"

Ara, quan un usuari introdueix les coordenades en cadascun dels camps i una etiqueta, i selecciona el botó Afegeix un pern, les coordenades es converteixen en un pern i es col·loca al model.

Podeu visualitzar cadascun dels perns a mesura que s'afegeixen:

  1. Obre la pestanya Insereix.

  2. Expandiu Disposició.

  3. Seleccioneu el control Taula de dades i col·loqueu-lo a la pantalla de l'aplicació.

  4. A la subfinestra Propietats, definiu la propietat Font de dades a la col·lecció que heu creat, PinsCollection.

  5. A la subfinestra Propietats, seleccioneu Editar els camps i, a continuació, Afegiu un camp. Seleccioneu cadascun dels camps i, a continuació, Afegiu.

    A la subfinestra de camps, se seleccionen totes les opcions (d'etiqueta, de marcadors X, de marcadors Y i de marcadors Z).

A mesura que els usuaris afegeixen perns al botó Afegeix un pern, es mostraran a la taula sota el botó.

Altres controls de MR