檢視混合實境中的 3D 內容或圖像

使用以 MR 查看控制項將物件或圖像的 3D 模型放置在現實世界空間中。 例如，在懸掛前先預覽牆上的畫，或查看 3D 虛擬書櫃是否符合您想要的位置。

如果沒有物件的 3D 模型怎麼辦？ 載入物件的圖像，並將其尺寸設定為物件的大小。 該控制項會將圖像以所需大小套用為虛擬立方體的表面。 將其取代 3D 模型放置在空間中。

以 MR 查看控制項會將按鈕新增到您的應用程式。 當使用者選取該按鈕時，應用程式會將所選 3D 模型 (.glb、.stl 或 .obj 檔案格式) 或圖像 (.jpg 或 .png 檔案格式) 重疊到裝置相機摘要上。

您也可以使用以 MR 查看控制項拍照，並將它們上傳至 OneDrive。

將以 MR 查看 按鈕新增到應用程式畫面

在 Power Apps Studio 中開啟應用程式以進行編輯時：

1. 開啟插入索引標籤，然後展開混合實境。

2. 選取以 MR 查看將控制項放置在應用程式畫面中，或將控制項拖曳到畫面以更精確地定位。

控制項是一種具有立方體圖標和以 MR 查看文字的按鈕。 如果您想的話，可以在 Text 和 Display type 屬性中變更標籤並隱藏圖示。

在單一工作階段中查看其他模型

以 MR 查看控制項預設為顯示一個媒體檔案。 若要在 MR 體驗期間查看透過媒體庫選擇的不同媒體檔案，請使用控制項 Items 進階屬性。 此屬性會建立表格，其中列出使用者可從混合實境體驗中選擇的媒體檔案。

使用 Items 屬性時，您需要設定以下其他進階屬性的值來對應輸入表格中的資料行：

為了測試它，讓我們建立一個媒體庫，在房間環境中展示三種不同的植物。 我們的項目表格看起來會像這樣：

在 Power Apps Studio 中開啟應用程式以進行編輯時：

1. 開啟插入索引標籤，然後展開混合實境。

2. 選取以 MR 查看將控制項放置在應用程式畫面中，或將控制項拖曳到畫面以更精確地定位。

3. 在 Advanced 屬性索引標籤上，選取 Items 屬性，然後輸入或貼上以下程式碼：

   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"
   }
   )
   

4. 將 ItemsLabel 屬性設定為 "label"。

5. 將 ItemsSource 屬性設定為 "source"。

6. 將 ItemsThumbnail 屬性設定為 "thumbnail"。

   

7. 儲存並發佈應用程式，然後在行動裝置上開啟它進行試用。

調整物件大小時如何縮放物件

如果您在放置模型時未指定尺寸，則以 MR 查看控制項中將會遵循物件檔案中指定的尺寸。 您可以在一個或多個控制項的寬度、高度和深度屬性(Object width, Object height, and Object depth) 中輸入非 0 值來調整模型大小。 模型的縮放方式視您變更了多少尺寸而定。

• 如果所有尺寸均為 0 (預設值)，則模型的大小會維持在物件檔案中設定的大小。

• 如果設定一個尺寸，則模型會根據變更的尺寸等比例縮放，類似在調整圖像大小時設定「保持外觀比例」。

• 如果設定兩個尺寸，則模型會按照兩個指定尺寸和前兩個尺寸的平均值縮放。
  例如，假設模型為 12 公尺高、6 公尺寬和 3 公尺深。 將以 MR 查看控制項的屬性設定如下：Object height: 24、Object width: 9、Object depth: 0 (未變更). 高度會增加 2 倍，寬度增加 1.5 倍。 平均高度和寬度的增加數，以找到深度應增加的縮放比例：2 + 1.5 = 3.5 / 2 = 1.75。 模型的最終尺寸為 Object height 24、Object width 9 和 Object depth 5.25 (3 x 1.75)。

• 如果設定了全部三個尺寸，則模型的尺寸將變成您指定的尺寸。

屬性

使用屬性變更以 MR 查看按鈕的行為和外觀。 有些屬性只能在進階索引標籤上使用。

Output 屬性

當使用者與以 MR 查看控制項互動時，您的應用程式可使用更多屬性。 這些稱為輸出屬性。 您可以在其他控制項中使用輸出屬性，也可以自訂應用程式體驗。

其他混合實境控制項

• 使用**3D 物件** 控制項檢視 3D 內容。
• 使用**以混合實境測量** 控制項測量距離、面積和體積。
• 使用**以混合實境查看圖形** 控制項建立和檢視預先定義的 3D 形狀
• 使用**以 MR 標記** 控制項繪製 3D 線條或繪製 3D 箭頭以指定環境中的區域或資產。

另請參閱

• 建立包含 3D 和混合實境控制項的應用程式
• 將標記偵測與混合實境控制項一起使用