Mixed Reality ホームで 3D モデルの配置を有効にする

Windows Mixed Reality ホームはスタート ポイントであり、ユーザーはここに移動してからアプリケーションを起動します。 一部のシナリオでは、2D アプリ (ホログラム アプリなど) を使用して、装飾として、または完全な 3D でさらに検査するために、3D モデルを Mixed Reality ホームに直接配置できます。 "モデルの追加プロトコル" を使用すると、Web サイトまたはアプリケーションから Windows Mixed Reality ホームに 3D モデルを直接送信できます。この場合、モデルは、3D アプリ ランチャー、2D アプリ、ホログラムのように保持されます。

たとえば、スペースを設計するために 3D 家具のカタログを表示するアプリケーションを開発している場合は、"モデルの追加プロトコル" を使用して、ユーザーがカタログからそれらの 3D 家具モデルを配置できるようにします。 ワールドに配置されると、ユーザーは、ホーム内の他のホログラムと同じように、これらの 3D モデルを移動、サイズ変更、および削除できます。 この記事では、ユーザーがアプリや Web の 3D オブジェクトを使用して自分のワールドを装飾できるようにするための、"モデルの追加プロトコル" の実装について概説します。

デバイス サポート

基本

Windows Mixed Reality ホームで 3D モデルの配置を有効にするには 2 つの手順があります。

1. 3D モデルが Windows Mixed Reality ホームと互換性があることを確認します。
2. アプリケーションまたは Web ページ (この記事) で "モデルの追加プロトコル" を実装します。

"モデルの追加プロトコル" の実装

互換性のある 3D モデルを作成したら、任意の Web ページまたはアプリケーションから次の URI をアクティブ化することにより、"モデルの追加プロトコル" を実装できます。

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

URI がリモート リソースを指している場合、リソースは自動的にダウンロードされ、ホームに配置されます。 ローカル リソースは、Mixed Reality ホームのアプリ データ フォルダーにコピーされてから、ホームに配置されます。 ボタンを非表示にするか、可能であれば無効にして、ユーザーがこの機能をサポートしていない古いバージョンの Windows を実行しているシナリオを考慮したエクスペリエンスを設計することをお勧めします。

ユニバーサル Windows プラットフォーム アプリからの "モデルの追加プロトコル" の呼び出し:

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 ページからの "モデルの追加プロトコル" の呼び出し:

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

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

• イマーシブ (VR) ヘッドセットの場合、"モデルの追加プロトコル" を呼び出す前に Mixed Reality ポータルが実行されている必要はありません。 この場合は、"モデルの追加プロトコル" によって Mixed Reality ポータルが起動され、Mixed Reality ホームに着くと、ヘッドセットから見える場所に直接オブジェクトが配置されます。
• Mixed Reality ポータルが既に実行されているデスクトップから "モデルの追加プロトコル" を呼び出すときは、ヘッドセットが "起動" していることを確認してください。 そうでないと配置は成功しません。

関連項目

• Windows Mixed Reality ホームで使用する 3D モデルの作成
• Windows Mixed Reality ホームのナビゲーション