Windows Mixed Reality 用の新しい Unity プロジェクトを構成するConfigure a New Unity Project for Windows Mixed Reality

(Unity プロジェクトに MRTK v2 が既にインポートされている場合はスキップします)(skip if you have already imported MRTK v2 into your Unity Project)

混合 Reality ツールキットをインポートせずに新しい Unity プロジェクトを作成する場合は、Windows Mixed Reality に対して手動で変更する必要がある Unity 設定の小さなセットがあります。これは、プロジェクトごととシーン単位の2つのカテゴリに分類されます。If you'd like to created a new Unity project without importing Mixed Reality Toolkit, there are a small set of Unity settings you'll need to manually change for Windows Mixed Reality, broken down into two categories: per-project and per-scene.

プロジェクトごとの設定Per-project settings

Windows Mixed Reality をターゲットにするには、最初に Unity プロジェクトをユニバーサル Windows プラットフォームアプリとしてエクスポートするように設定する必要があります。To target Windows Mixed Reality, you first need to set your Unity project to export as a Universal Windows Platform app:

  1. ファイル > ビルド設定を選択してください...Select File > Build Settings...
  2. プラットフォーム ボックスの一覧の ユニバーサル Windows プラットフォームを選択し、プラットフォームの切り替え をクリックします。Select Universal Windows Platform in the Platform list and click Switch Platform
  3. SDKUniversal 10に設定するSet SDK to Universal 10
  4. イマーシブヘッドセットまたはHoloLensへの切り替えをサポートするために、ターゲットデバイス任意のデバイスに設定するSet Target device to Any Device to support immersive headsets or switch to HoloLens
  5. ビルドの種類D3Dに設定Set Build Type to D3D
  6. UWP SDK最新のインストールに設定するSet UWP SDK to Latest installed

次に、エクスポートしようとしているアプリが2D ビューではなくイマーシブビューを作成する必要があることを Unity に知らせる必要があります。We then need to let Unity know that the app we are trying to export should create an immersive view instead of a 2D view. これを行うには、"Virtual Reality がサポートされている" を有効にします。We do that by enabling "Virtual Reality Supported":

  1. [ビルドの設定... ] ウィンドウで、[プレーヤーの設定] を開きます。From the Build Settings... window, open Player Settings...
  2. [ユニバーサル Windows プラットフォーム] タブの設定を選択します。Select the Settings for Universal Windows Platform tab
  3. [ XR Settings ] グループを展開します。Expand the XR Settings group
  4. [ XR の設定] セクションで、[仮想現実のサポート] チェックボックスをオンにして、[仮想現実のデバイス] の一覧を追加します。In the XR Settings section, check the Virtual Reality Supported checkbox to add the Virtual Reality Devices list.
  5. [ XR 設定] グループで、 "Windows Mixed Reality" がサポートされているデバイスとして表示されていることを確認します。In the XR Settings group, confirm that "Windows Mixed Reality" is listed as a supported device. (以前のバージョンの Unity では、"Windows Holographic" として表示される場合があります)(this may appear as "Windows Holographic" in older versions of Unity)

Unity の品質設定Unity quality settings
Unity xr の設定Unity xr settings

これで、アプリで基本的な holographic のレンダリングと空間入力を行うことができるようになりました。Your app can now do basic holographic rendering and spatial input. 特定の機能を利用するには、アプリでマニフェスト内の適切な機能を宣言する必要があります。To go further and take advantage of certain functionality, your app must declare the appropriate capabilities in its manifest. マニフェスト宣言は Unity で作成できるため、後続のすべてのプロジェクトエクスポートに含まれます。The manifest declarations can be made in Unity so they are included in every subsequent project export. この設定はユニバーサル Windows プラットフォーム > の発行設定 > 機能の [プレーヤーの設定 > 設定] にあります。The setting are found in Player Settings > Settings for Universal Windows Platform > Publishing Settings > Capabilities. 一般的に使用される Unity Api を混合現実に対して有効にするための適用可能な機能は次のとおりです。The applicable capabilities for enabling commonly-used Unity APIs for Mixed Reality are:

機能Capability 機能を必要とする ApiAPIs requiring capability
SpatialPerceptionSpatialPerception SurfaceObserver (HoloLens 上の空間マッピングメッシュへの—アクセス)ヘッドセットの一般的な空間追跡に必要な機能はありませんSurfaceObserver (access to spatial mapping meshes on HoloLens)—No capability needed for general spatial tracking of the headset
WebCamWebCam PhotoCapture と VideoCapturePhotoCapture and VideoCapture
PicturesLibrary / VideosLibraryPicturesLibrary / VideosLibrary PhotoCapture または VideoCapture (キャプチャされたコンテンツを格納する場合)PhotoCapture or VideoCapture, respectively (when storing the captured content)
マイクMicrophone VideoCapture (オーディオをキャプチャする場合)、DictationRecognizer、GrammarRecognizer、および KeywordRecognizerVideoCapture (when capturing audio), DictationRecognizer, GrammarRecognizer, and KeywordRecognizer
InternetClientInternetClient DictationRecognizer (および Unity Profiler の使用)DictationRecognizer (and to use the Unity Profiler)

Unity の品質設定Unity quality settings

Unity の品質設定Unity quality settings
Unity の品質設定Unity quality settings

HoloLens には、モバイルクラスの GPU があります。HoloLens has a mobile-class GPU. アプリが HoloLens を対象としている場合は、完全なフレームレートを維持するために、品質設定のパフォーマンスを最速に調整することをお勧めします。If your app is targeting HoloLens, you'll want the quality settings tuned for fastest performance to ensure we maintain full framerate:

  1. [プロジェクト設定の編集 > の > 品質] を選択します。Select Edit > Project Settings > Quality
  2. Windows ストアのロゴの下にあるドロップダウンを選択し、[非常に低い] を選択します。Select the dropdown under the Windows Store logo and select Very Low. Windows ストアの列のボックスと非常に少ない行が緑色になっている場合は、設定が正しく適用されていることがわかります。You'll know the setting is applied correctly when the box in the Windows Store column and Very Low row is green.

シーンごとの設定Per-scene settings

Unity カメラの設定Unity camera settings

Unity カメラの設定Unity camera settings
Unity カメラの設定Unity camera settings

"Virtual Reality がサポートされています" チェックボックスをオンにすると、 Unity カメラコンポーネントはヘッドトラッキングとステレオスコピックレンダリングを処理します。Once you enable the "Virtual Reality Supported" checkbox, the Unity Camera component handles head tracking and stereoscopic rendering. これを行うには、カスタムカメラで置き換える必要はありません。There is no need to replace it with a custom camera to do this.

アプリが HoloLens を対象としている場合は、デバイスの透明なディスプレイを最適化するために変更する必要がある設定がいくつかあります。そのため、アプリは物理的な世界に表示されます。If your app is targeting HoloLens specifically, there are a few settings that need to be changed to optimize for the device's transparent displays, so your app will show through to the physical world:

  1. 階層で、メインカメラを選択します。In the Hierarchy, select the Main Camera
  2. [インスペクター ] パネルで、[変換位置] を0、0、0に設定します。これにより、ユーザーの位置が Unity の元の場所で開始されます。In the Inspector panel, set the transform position to 0, 0, 0 so the location of the users head starts at the Unity world origin.
  3. クリアフラグ純色に変更します。Change Clear Flags to Solid Color.
  4. 背景色をRGBA 0、0、0、0に変更します。Change the Background color to RGBA 0,0,0,0. ブラックは HoloLens では透明としてレンダリングされます。Black renders as transparent in HoloLens.
  5. クリッププレーンHoloLens の推奨0.85 (メーター) に近い場所に変更します。Change Clipping Planes - Near to the HoloLens recommended 0.85 (meters).

新しいカメラを削除して作成する場合は、カメラがmaincameraとしてタグ付けされていることを確認してください。If you delete and create a new camera, make sure your camera is Tagged as MainCamera.

関連項目See also