Adicionar marcadores a modelos 3D no Power Apps

Adicione marcadores (mostrados como marcadores circulares) a modelos 3D em seus aplicativos de tela. Os usuários podem adicionar seus próprios marcadores e exibir informações sobre os marcadores que selecionam.

Adicionar marcadores predefinidos a um modelo 3D de uma pasta de trabalho do Excel

A maneira mais fácil de adicionar marcadores a um modelo 3D é carregá-los de uma pasta de trabalho do Excel.

A fonte de dados dos marcadores deve ser uma tabela nomeada no Excel. A tabela deve ter quatro colunas. Cada coluna corresponde a uma propriedade do controle Objeto 3D. Cada linha é plotada como um marcador no modelo. As linhas determinam a colocação dos marcadores em um sistema de coordenadas tridimensional.

Importante

Os controles de MR (realidade misturada) no Power Apps usam um sistema de coordenadas canhoto.

Coluna	Corresponde a
Rótulo	ItemsLabels
X	PinsX
Y	PinsY
Z	PinsZ

Veja a seguir o exemplo de uma tabela chamada "TestPins" que contém coordenadas para colocar quatro marcadores em um modelo 3D:

Para testar este exemplo, comece criando uma tabela no Excel.

1. Copie os dados de exemplo a seguir e cole-os na célula A1 de uma nova planilha do Excel.

   Rótulo	Marcadores X	Marcadores Y	Marcadores Z
   Frente Esquerda	-0,2	0,01	0,2
   Frente Direita	0,2	0,01	0,2
   Zero	0	0	0
   Ponto X	0	0,72	-0,2

2. Selecione uma das células coladas. Na guia Página Inicial, selecione Formatar como Tabela, escolha um estilo e selecione OK.

3. Na guia Design da Tabela, em Nome da Tabela, informe um nome, por exemplo TestPins.

4. Salve a pasta de trabalho e feche-a.

Em seguida, adicione a tabela como uma fonte de dados para exibir os marcadores em um modelo 3D.

1. No Power Apps Studio, insira um modelo 3D ou selecione um modelo existente.
2. Defina a propriedade Source do controle Objeto 3D para https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/chair.glb (ou qualquer outro arquivo de modelo de sua escolha).

Observação

A primeira instância do controle Objeto 3D é chamada de 3DObject1, por padrão, e esse é o nome que usaremos nos exemplos a seguir. As instâncias adicionais do controle seriam mencionadas como ViewIn3D2, ViewIn3D3 e assim por diante.

1. Na guia Propriedades do modelo, selecione a lista suspensa Pins(Items).
2. Digite excel na caixa de pesquisa e, em seguida, selecione Importar do Excel.
3. Localize a pasta de trabalho do Excel que você salvou anteriormente e abra-a.
4. Selecione o nome que você deu à tabela no Excel e selecione Conectar.
5. Na guia Avançado, localize PinsX, PinsY e PinsZ e insira o nome da coluna correspondente na tabela. (Neste exemplo, digite Label em ItemsLabels, X em PinsX e assim por diante.) Coloque o nome da coluna entre aspas.

Os marcadores aparecem no modelo nos locais descritos pelas coordenadas.

Mostrar o rótulo e as coordenadas dos marcadores em um modelo 3D

Use uma tabela de dados para exibir o rótulo e as coordenadas dos marcadores selecionados em um aplicativo de tela.

Com o aplicativo aberto para edição no Power Apps Studio:

1. Abra a guia Inserir e expanda Layout.

2. Selecione Tabela de dados para colocar uma tabela na tela do aplicativo, ou arraste o controle para a tela de modo a posicioná-lo com mais precisão.

3. Escolha mostrar informações sobre todos os marcadores ou apenas do marcador selecionado. Com a tabela de dados selecionada:

   • Mostrar todos os marcadores: no painel Propriedades, selecione a lista suspensa Pins(Items) e selecione a tabela do Excel à qual você se conectou anteriormente.

   • Mostrar apenas o marcador selecionado: no editor de expressão do Power Apps Studio, digite 3DObject1.SelectedItems.

     

4. No painel Propriedades, selecione Editar campos e, em seguida, Adicionar campo.

5. Selecione as colunas a serem mostradas e selecione Adicionar.

   

Mostrar o rótulo de um marcador selecionado em um modelo 3D

Use uma caixa de texto para exibir apenas o rótulo do marcador selecionado em um aplicativo de tela.

Com o aplicativo aberto para edição no Power Apps Studio:

1. Abra a guia Inserir.
2. Selecione Rótulo do texto para colocar caixa de texto na tela do aplicativo, ou arraste o controle para a tela de modo a posicioná-lo com mais precisão.
3. No editor de expressão, insira 3DObject1.Selected.Label.

Criar uma coleção para permitir que os usuários adicionem seus próprios marcadores a um modelo 3D

Se você deseja permitir que os usuários coloquem marcadores em um modelo 3D, use uma coleção.

Com o aplicativo aberto para edição no Power Apps Studio:

1. Abra a guia Inserir.

2. Selecione Entrada de texto para colocar uma caixa de entrada de texto na tela do aplicativo.

3. Copie a caixa de texto e cole-a três vezes para criar quatro controles Entrada de texto.

4. Defina a propriedade Default de cada controle como X, Y, Z e Rótulo, respectivamente.

5. Abra a guia Exibição de árvore.

6. Renomeie cada controle, conforme apropriado, para XCoordinate, YCoordinate, ZCoordinate e RótuloInput.

   

Em seguida, adicione um botão para acrescentar os dados do usuário à coleção de marcadores.

1. Abra a guia Inserir.

2. Selecione Botão para colocar um botão na tela do aplicativo.

3. Defina a propriedade Text do botão como Adicionar pino.

4. Digite o seguinte código na propriedade OnSelect do botão, exatamente como mostrado:

   Collect( 
   PinsCollection,
     {
       X: XCoordinate.Text,
       Y: YCoordinate.Text,
       Z: ZCoordinate.Text,
       Label: LabelInput.Text
     }
   )
   

Agora você mudará a fonte de dados dos marcadores da tabela do Excel para a nova coleção.

1. Selecione o modelo 3D.

2. Na guia Propriedades, selecione a lista suspensa Pins(Items) e, em seguida, selecione PinsCollection.

   

3. Na guia Avançado, localize PinsX, PinsY e PinsZ e defina-os como X, Y, e Z, respectivamente.

Quando o usuário insere coordenadas e um rótulo e seleciona Adicionar marcador, um marcador rotulado é colocado no modelo nas coordenadas inseridas.

Mostrar informações sobre marcadores à medida que são adicionados a um modelo 3D

Por fim, combine os exemplos anteriores exibindo informações sobre os marcadores à medida que o usuário os adiciona.

Com o aplicativo aberto para edição no Power Apps Studio:

1. Adicione uma tabela de dados à tela.
2. Na guia Propriedades, selecione a lista suspensa Pins(Items) e selecione PinsCollection.
3. Selecione Editar campos e Adicionar campo.
4. Selecione as colunas a serem mostradas na tabela e selecione Adicionar.

Outros controles de realidade misturada

• Exibir conteúdo 3D em realidade misturada com o controle Exibir em MR.
• Medir distância, área e volume com o controle Câmera de medição.
• Crie e exiba formas 3D predefinidas com o controle Exibir forma em MR.
• Pinte linhas 3D ou desenhe setas 3D para especificar uma área ou um ativo em seu ambiente com o controle Markup in MR.

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).