ホーム複合現実での 3D モデルの配置を有効にします。Enable placement of 3D models in the mixed reality home

注意

この機能は、の一部として追加された、 Windows 10 April 2018 Updateします。This feature was added as part of the Windows 10 April 2018 Update. Windows の以前のバージョンは、この機能と互換性がありません。Older versions of Windows are not compatible with this feature.

Windows Mixed Reality ホーム始めるユーザーがアプリケーションを起動する前に配置する場所です。The Windows Mixed Reality home is the starting point where users land before launching applications. 一部のシナリオでは、(ホログラム アプリ) のような 2D アプリは、装飾、またはフル 3D でさらなる調査用に 3D モデルの複合現実ホームに直接配置を有効にします。In some scenarios, 2D apps (like the Holograms app) enable placement of 3D models directly into the mixed reality home as decorations or for further inspection in full 3D. モデル プロトコルを追加3D モデルを web サイトや自宅、Windows Mixed Reality に直接アプリケーションから送信するために保持されますがなど3D アプリ ランチャー、2D のアプリ、およびホログラム。The add model protocol allows you to send a 3D model from your website or application directly into the Windows Mixed Reality home, where it will persist like 3D app launchers, 2D apps, and holograms.

たとえば、3 D の家具、領域をデザインするためのカタログを表示するアプリケーションを開発している場合、ことができますを使用する、モデル プロトコルを追加カタログからこれらの家具を 3D モデルを配置するユーザーを許可します。For example, if you're developing an application that surfaces a catalog of 3D furniture for designing a space, you can use the add model protocol to allow users to place those 3D furniture models from the catalog. ユーザーが移動できる、世界では、配置し、サイズを変更すると、自宅で他のホログラムと同じようにこれらの 3D モデルを削除します。Once placed in the world, users can move, resize, and remove these 3D models just like other holograms in the home. この記事では実装の概要、モデル プロトコルを追加アプリまたは web から 3D オブジェクトは、自分の世界を修飾するためのユーザーの有効化を開始できるようにします。This article provides an overview of implementing the add model protocol so that you can start enabling users to decorate their world with 3D objects from your app or the web.

デバイスのサポートDevice support

機能Feature HoloLensHoloLens イマーシブ ヘッドセットImmersive headsets
モデルのプロトコルを追加します。Add model protocol ✔️✔️ ✔️✔️

概要Overview

Windows Mixed Reality ホームの 3D モデルの配置を有効にする 2 つの手順があります。There are 2 steps to enabling the placement of 3D models in the Windows Mixed Reality home:

  1. 3D モデルが Windows Mixed Reality ホームと互換性のあることを確認してします。Ensure your 3D model is compatible with the Windows Mixed Reality home.
  2. 実装、モデル プロトコルを追加アプリケーションまたは web ページ (この記事)。Implement the add model protocol in your application or webpage (this article).

実装する、 model プロトコルの追加Implementing the add model protocol

作成したら、 3D モデルを互換性のある、実装することができます、モデル プロトコルを追加で任意の web ページまたはアプリケーションから次の URI をアクティブ化します。Once you have a compatible 3D model, you can implement the add model protocol by activating the following URI from any webpage or application:

ms-mixedreality:addmodel?uri=<Path to a .glb 3D model either local or remote>

URI は、リモート リソースをポイントしている場合が自動的にダウンロードされ家庭内に配置します。If the URI points to a remote resource, then it will automatically be downloaded and placed in the home. ローカル リソースは、家庭内に配置する前に、複合現実ホームのアプリのデータ フォルダーにコピーされます。Local resources will be copied to the mixed reality home's app data folder before being placed in the home. アカウントのユーザー可能性がありますが実行されている以前のバージョンの Windows ボタンを非表示または可能であれば無効にすることによってこの機能をサポートしないシナリオのエクスペリエンスを設計することをお勧めします。We recommend designing your experience to account for scenarios where the user might be running an older version of Windows that doesn't support this feature by hiding the button or disabling it if possible.

呼び出す、モデル プロトコルを追加ユニバーサル Windows プラットフォーム アプリから。Invoking the add model protocol from a Universal Windows Platform app:

private async void launchURI_Click(object sender, RoutedEventArgs e)
{
   // Define the add model URI
   var uriAddModel = new Uri(@"ms-mixedreality:addModel?uri=sample.glb");

   // Launch the URI to invoke the placement
   var success = await Windows.System.Launcher.LaunchUriAsync(uriAddModel);

   if (success)
   {
      // URI launched
   }
   else
   {
      // URI launch failed
   }
}

呼び出す、モデル プロトコルを追加web ページから。Invoking the add model protocol from a webpage:

<a class="btn btn-default" href="ms-mixedreality:addModel?uri=sample.glb"> Place 3D Model </a>

(VR) のイマーシブ ヘッドセットに関する考慮事項Considerations for immersive (VR) headsets

  • 呼び出す前に実行されているがない混合現実ポータル没入型の (VR) ヘッドセット場合、モデル プロトコルを追加します。For immersive (VR) headsets, the Mixed Reality Portal does not have to be running before invoking the add model protocol. ここで、モデル プロトコルを追加が Mixed Reality ポータルを起動し、直接、ヘッドセットは検索ホーム複合現実で到着すると、オブジェクトします。In this case, the add model protocol will launch the Mixed Reality Portal and place the object directly where the headset is looking once you arrive in the mixed reality home.
  • 呼び出すときに、モデル プロトコルを追加既に実行されている混合現実ポータルを使用したデスクトップで、ヘッドセットが「起動」ことを確認します。When invoking the add model protocol from the desktop with the Mixed Reality Portal already running, ensure that the headset is "awake". それ以外の場合は、配置は成功しません。If not, the placement will not succeed.

関連項目See also