Exibir conteúdo ou imagens 3D em realidade misturada

Use o controle View in MR para colocar um modelo 3D de um objeto ou uma imagem em um espaço do mundo real. Por exemplo, visualize um quadro na parede antes de pendurá-lo, ou veja se uma prateleira de livros em 3D caberá onde você pretende colocá-la.

E se você não tiver um modelo 3D do objeto? Carregue uma imagem do objeto e defina suas dimensões para o tamanho do objeto. O controle aplica a imagem como o mostrador de um cubo virtual do tamanho desejado. Use-o como substituto do modelo 3D no seu espaço.

O controle View in MR adiciona um botão ao seu aplicativo. Quando um usuário seleciona o botão, o aplicativo sobrepõe um modelo 3D (nos formatos de arquivo .glb, .stl ou .obj) ou uma imagem (nos formatos de arquivo .jpg ou .png) selecionados no feed da câmera do dispositivo.

Você também pode tirar fotos usando o controle View in MR e carregá-las no OneDrive.

Importante

O conteúdo 3D deve estar nos formatos de arquivo .glb, .stl ou .obj. Você pode converter seus modelos 3D existentes no formato de arquivo .glb a partir de uma variedade de formatos 3D. O conteúdo 3D compactado com a compactação Draco não é compatível.

Dica

Certifique-se de que seus modelos 3D sejam otimizados para uso com o Power Apps de modo a minimizar os tempos de carregamento.

Dica

Os controles de MR (realidade misturada) funcionam melhor em ambientes bem iluminados com superfícies de textura plana. O acompanhamento é melhor em dispositivos habilitados para LIDAR.

Dica

Os controles de MR no Power Apps usam o Babylon e o Babylon React Native. O conteúdo de realidade misturada que funciona na área restrita do Babylon deve funcionar no Power Apps por meio dessa plataforma de MR compartilhada. Se o seu conteúdo funcionar no Babylon, mas não no Power Apps, faça uma pergunta no Fórum da Comunidade do Power Apps. (Marque-o com "realidade misturada".)

Adicionar um botão Exibir em MR a uma tela do aplicativo

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

1. Abra a guia Inserir e expanda Realidade Misturada.
2. Selecione Exibir em MR para colocar o controle na tela do aplicativo ou arraste o controle para a tela de modo a posicioná-lo com mais precisão.

O controle é um botão rotulado com um ícone de um cubo e o texto Exibir em MR. Altere o rótulo e oculte o ícone, se desejar, nas propriedades Text e Tipo de exibição.

Exibir vários modelos em uma única sessão

O controle View in MR oferece suporte à exibição de um único arquivo de mídia por vez ou à exibição de vários arquivos de mídia em uma única sessão de realidade misturada. Para exibir vários arquivos em uma única sessão, use a propriedade Lista de origens (Itens) para fornecer uma lista de arquivos que o usuário pode escolher na experiência de realidade misturada.

Ao usar a propriedade Lista de origens (Itens), você também precisa usar as seguintes propriedades adicionais para mapear as colunas da sua tabela de entrada:

• ItemsSource (obrigatório) - Especifique qual coluna na Lista de origens (Itens) fornece a imagem ou o modelo 3D para exibição em realidade misturada. Consulte Conectar modelos 3D ao Power Apps para saber mais sobre como trazer modelos para o Power Apps.
• ItemsLabel - A coluna que contém qual deve ser o rótulo para a galeria de mídia em realidade misturada. A propriedade Texto Alternativo será usada para itens que não tiverem um valor.
• ItemsThumbnail - A coluna que contém uma miniatura para exibição na galeria de mídia em realidade misturada. Uma miniatura padrão será fornecida na galeria para itens sem uma miniatura especificada.
• ItemsObjectWidth, ItemsObjectHeight, ItemsObjectDepth - Usadas para especificar um tamanho explícito para cada item de mídia na lista. Largura do objeto, Altura do objeto e Profundidade do objeto serão usadas como padrão para itens que não tiverem um valor.

Para testar isso, abra seu aplicativo para edição no Power Apps Studio:

1. Na guia Inserir, selecione Realidade Misturada > View in MR para colocar o controle na tela do aplicativo ou arraste o controle para a tela de modo a posicioná-lo com mais precisão.

2. Edite a propriedade Lista de origens (Itens) e insira esta fórmula:

   

   Table(
     {
        label: "Birds of Paradise",
        source: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/bird_of_paradise_blue.glb",
        thumbnail: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/bird_of_paradise_blue.png"
     },
     {
        label: "Fiddle Leaf Fig",
        source: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/flf_orange.glb",
        thumbnail: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/flf_orange.png"
     },
     {
        label: "Small Palm Tree",
        source: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/palm_green.glb",
        thumbnail: "https://raw.githubusercontent.com/microsoft/experimental-pcf-control-assets/master/palm_green.png"
     }
    )
   

3. Defina a propriedade ItemsLabel como "label".

4. Defina a propriedade ItemsSource como "source".

5. Defina a propriedade ItmesThumbnail como "thumbnail".

6. Salve e publique o aplicativo, em seguida, abra-o no seu dispositivo móvel.

   

Como os objetos são escalados se você redimensioná-los

Se você não especificar as dimensões ao inserir um modelo, o controle View in MR seguirá as dimensões fornecidas no arquivo do objeto. Você pode redimensionar o modelo inserindo um valor diferente de 0 em uma ou mais propriedades de largura, altura e profundidade do controle (Largura do objeto, Altura do objeto e Profundidade do objeto). A forma como o modelo é dimensionado depende de quantas dimensões você altera.

• Se todas as dimensões forem 0 (o padrão), o tamanho do modelo será deixado conforme definido no arquivo do objeto.

• Se uma dimensão for definida, o modelo será dimensionado igualmente com base na dimensão alterada, semelhante à configuração "manter taxa de proporção" ao redimensionar uma imagem.

• Se duas dimensões forem definidas, o modelo será dimensionado para as duas dimensões fornecidas e uma média das duas primeiras.
  Por exemplo, digamos que você tenha um modelo com 12 m de altura, 6 m de largura e 3 m de profundidade. Você define as propriedades do controle View in MR desta forma: Altura do objeto: 24, Largura do objeto: 9, Profundidade do objeto: 0 (inalterado). A altura aumenta por um fator de 2 e a largura aumenta por um fator de 1,5. O aumento na altura e largura é calculado para encontrar o fator pelo qual a profundidade deve ser aumentada: 2 + 1,5 = 3,5 / 2 = 1,75. As dimensões finais do modelo são Altura do objeto 24, Largura do objeto 9 e Profundidade do objeto 5,25 (3 x 1,75).

• Se as três dimensões forem definidas, o tamanho do modelo será alterado para o que você especificou.

Observação

Se as medidas não aderirem à taxa de proporção original, o modelo poderá ser esmagado ou distorcido quando exibido em MR.

Propriedades

Altere o comportamento e a aparência do botão Exibir em MR usando propriedades. Algumas propriedades estão disponíveis apenas na guia Avançado.

Propriedade	Descrição	Tipo	Localização
Texto	Define o texto do rótulo do botão.	Cadeia de caracteres	Propriedades; Avançado: Text
Texto alternativo	Especifica o texto a ser exibido se o modelo não puder ser carregado ou se o usuário passar o mouse sobre o modelo.	Cadeia de caracteres	Propriedades; Avançado: AltText
Tipo de exibição	Determina se o rótulo do botão mostra um ícone de um cubo, texto, ou ambos.	Seleção na lista suspensa	Propriedades; Avançado: DisplayType
Source	Identifica a fonte de dados (arquivo .glb, .stl ou .obj) a ser exibida.	Não aplicável	Propriedades; Avançado: Source
Lista de origens (Itens)	Fonte de dados (tabela) que lista vários arquivos de mídia a serem exibidos em uma única sessão de realidade misturada. Consulte Exibir vários modelos em uma única sessão para obter mais detalhes.	Tabela	Propriedades; Avançado: Items
Largura do objeto	Define a largura do modelo.	Inteiro	Propriedades; Avançado: ObjectWidth
Altura do objeto	Define a altura do modelo.	Inteiro	Propriedades; Avançado: ObjectHeight
Profundidade do objeto	Define a profundidade do modelo.	Inteiro	Propriedades; Avançado: ObjectDepth
Unidade de medida	Define a unidade de medida usada para a largura, altura e profundidade do modelo.	Seleção na lista suspensa	Propriedades; Avançado: Units
Habilitar Sombras	Determina se as sombras são usadas para aprimorar o efeito 3D quando o modelo é mostrado.	Booliano	Propriedades; Avançado: EnableShadows
Habilitar detecção de marcadores	Determina se a detecção de marcadores será usada para determinar a posição e a rotação do modelo. Consulte Usar detecção de marcadores com controles de realidade misturada	Booliano	Propriedades; Avançado: EnableMarkerDetection
Visível	Mostra ou oculta o botão.	Booliano	Propriedades; Avançado: Visible
Posição	Coloca o canto superior esquerdo do botão nas coordenadas da tela especificadas em x e y.	Número de ponto flutuante	Propriedades; Avançado: X, Y
Tamanho	Determina o tamanho do botão usando os valores de pixel fornecidos em Largura e Altura.	Inteiro	Propriedades; Avançado: Width, Height
Preenchimento superior	Define a distância entre o texto do rótulo do botão e a parte superior do botão.	Número de ponto flutuante	Propriedades; Avançado: PaddingTop
Preenchimento inferior	Define a distância entre o texto do rótulo do botão e a parte inferior do botão.	Número de ponto flutuante	Propriedades; Avançado: PaddingBottom
Preenchimento esquerdo	Define a distância entre o texto do rótulo do botão e a borda esquerda do botão.	Número de ponto flutuante	Propriedades; Avançado: PaddingLeft
Preenchimento direito	Define a distância entre o texto do rótulo do botão e a borda direita do botão.	Número de ponto flutuante	Propriedades; Avançado: PaddingRight
Fonte	Define o nome da família de fontes usada para o texto do rótulo do botão.	Lista suspensa	Propriedades; Avançado: Font
Tamanho da fonte	Define o tamanho do texto do rótulo do botão.	Número de ponto flutuante	Propriedades; Avançado: FontSize
Espessura da fonte	Define a espessura do texto do rótulo do botão, seja Negrito, Mais claro, Normal ou Seminegrito.	Lista suspensa	Propriedades; Avançado: FontWeight
Alinhamento do texto	Define o alinhamento horizontal do texto do rótulo no botão, seja Centro, Justificar, Esquerda ou Direita.	Não aplicável	Propriedades; Avançado: TextAlignment
Alinhamento vertical	Define o alinhamento vertical do texto do rótulo no botão, seja Inferior, Meio ou Superior.	Lista suspensa	Propriedades; Avançado: VerticalAlign
Estilo da fonte	Define o estilo do texto do rótulo do botão, seja Itálico, Sublinhado, Tachado ou nenhum.	Não aplicável	Propriedades; Avançado: Itálico, Sublinhado, Tachado
Raio da borda	Determina o raio do canto da borda do botão.	Número de ponto flutuante	Propriedades; Avançado: BorderRadius
Color	Define as cores do texto do rótulo do botão e o plano de fundo do botão.	Não aplicável	Propriedades; Avançado: FillColor, TextColor
Borda	Determina o estilo, a largura e a cor da borda do botão.	Não aplicável	Propriedades; Avançado: BorderStyle, BorderThickness, BorderFillColor
Desabilitado	Desativa o botão, mas o deixa visível.	Booliano	Propriedades; Avançado: Disabled
Cor desabilitada	Define as cores do texto do rótulo do botão, do plano de fundo do botão e da borda do botão se DisplayMode for Desabilitado.	Não aplicável	Propriedades; Avançado: DisabledContentColor, DisabledFillColor, DisabledBorderColor
Cor ao pressionar	Define as cores do texto do rótulo do botão, do plano de fundo do botão e da borda do botão quando o usuário seleciona o botão.	Não aplicável	Propriedades; Avançado: PressedContentColor, PressedFillColor, PressedBorderColor
Cor ao focalizar	Define as cores do texto do rótulo do botão, do plano de fundo do botão e da borda do botão quando o usuário passa o ponteiro do mouse sobre ele.	Não aplicável	Propriedades; Avançado: HoverContentColor, HoverFillColor, HoverBorderColor
OnMixedRealitySelect	Comportamento que é acionado quando o usuário seleciona o botão para iniciar a experiência de realidade misturada.	Ação definida	Avançado
OnChange	Comportamento que é disparado quando qualquer propriedade do botão é alterada. Esta é uma propriedade comum em vários controles.	Ação definida	Avançado
Tooltip	Determina o texto a ser exibido quando o usuário passa o mouse sobre o botão.	Cadeia de caracteres	Avançado
ContentLanguage	Determina o idioma de exibição do rótulo do botão, se for diferente do idioma usado no aplicativo.	Cadeia de caracteres	Avançado
DisplayMode	Determina se o botão permite a entrada de usuário (Editar), se haverá apenas exibição de dados (Exibir) ou se estará desabilitado (Desabilitado).	Enum	Avançado
TabIndex	Especifica a ordem em que o botão é selecionado se o usuário navegar no aplicativo usando a tecla Tab.	Inteiro	Propriedades; Avançado: TabIndex

Propriedades de saída

Seu aplicativo pode usar mais propriedades quando um usuário interage com o controle View in MR. Elas são conhecidas como propriedades de saída. Você pode usar essas propriedades em outros controles ou para personalizar a experiência do aplicativo.

Propriedade	Descrição	Tipo
Fotos	Coleta fotos capturadas durante a sessão de realidade misturada. Você pode carregar as fotos de realidade misturada no OneDrive e mostrá-las em uma galeria.	Não aplicável

Outros controles de realidade misturada

• Exibir conteúdo 3D com o controle 3D object.
• Medir distância, área e volume com o controle Measure in mixed reality.
• Criar e exibir formas 3D predefinidas com o controle View shape in mixed reality
• Pintar linhas 3D ou desenhar setas 3D para especificar uma área ou um ativo em seu ambiente com o controle Markup in MR.

Consulte também

• Criar um aplicativo com controles 3D e de realidade misturada
• Usar detecção de marcadores com controles de realidade misturada

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).