MRTK パッケージ

このMixed Reality Toolkit (MRTK) は、クロス プラットフォーム Mixed Reality アプリケーション開発を可能にするパッケージのコレクションであり、Mixed Reality ハードウェアとプラットフォームのサポートを提供します。

MRTK は、アセット (.unitypackage) パッケージとして、および Unityパッケージ マネージャー。

アセット パッケージ

MRTK 資産 (.unitypackage) は、 からダウンロードGitHub。

資産パッケージを使用する利点には、次のようなものがあります。

  • Unity 2018.4 以降で使用可能
  • MRTK に簡単に変更を加える
    • MRTK は Assets フォルダーにあります

たとえば、次のような課題があります。

  • MRTK はプロジェクトの Assets フォルダーの一部で、
    • 大規模なプロジェクト
    • コンパイル時間が遅い
  • 依存関係の管理なし
    • お客様はパッケージの依存関係を手動で解決する必要があります
  • 手動更新プロセス
    • 複数の手順
    • 大規模 (3000 以上のファイル) ソース管理の更新
    • MRTK に加えた変更を失うリスク
  • examples パッケージのインポートは、通常、すべての例を含むという意味です

使用可能なパッケージは次のとおりです。

これらのパッケージは、Microsoft がリリースおよびサポートしています。このパッケージは、microsoft の mrtk_releaseブランチのソース コードGitHub。

Foundation パッケージ

Mixed Reality Toolkit Foundation は、アプリケーションがプラットフォーム間で共通の機能を利用Mixed Realityです。

Pakage foundation MRTK Foundation パッケージ

MRTK Foundation パッケージには、次が含まれています。

Folder コンポーネント 説明
MRTK/Core インターフェイスと型の定義、基本クラス、標準シェーダー。
MRTK/Core/Providers プラットフォームに依存しないデータ プロバイダー
基本クラスのサポートと、手の追跡のためのサービス。
InputAnimation 頭の動きと手の追跡データを記録するサポート。
InputSimulation 手と目の入力のエディター内シミュレーションのサポート。
ObjectMeshObserver データとして 3D モデルを使用する空間認識オブザーバー。
UnityInput Unity の入力 API を介して実装される一般的な入力デバイス (マウスなど)。
MRTK/プロバイダー プラットフォーム固有のデータ プロバイダー
LeapMotion UltraLeap Leap Motion コントローラーのサポート。
OpenVR OpenVR デバイスのサポート。
Oculus Quest などの Oculus デバイスのサポート。
UnityAR (試験段階)MRTK をモバイル AR デバイスで使用できるカメラ設定プロバイダー。
WindowsMixedReality デバイスとイマーシブ Windows Mixed Realityなど、Microsoft HoloLensデバイスのサポート。
Windows 音声やディクテーションWindows特定の API に対する Microsoft サービスのサポート。
XR SDK (試験段階)Unity 2019.3 以降での Unity の新しい XR フレームワークのサポート。
MRTK/SDK
実験用 シェーダー、ユーザー インターフェイス コントロール、個々のシステム マネージャーなど、試験的な機能。
機能 Foundation パッケージに基付く機能。
Profiles Microsoft の既定のプロファイルは、Mixed Reality Toolkitサービスを提供します。
StandardAssets 一般的な資産モデル、テクスチャ、素材などです。
MRTK/SceneSystemResources シーン システムによって使用される資産とリソース
MRTK/サービス
BoundarySystem VR 境界のサポートを実装するシステム。
CameraSystem カメラの構成と管理を実装するシステム。
DiagnosticsSystem ビジュアル プロファイラーなど、アプリケーション診断でのシステム実装。
InputSystem ユーザー入力にアクセスして処理するためのサポートを提供するシステム。
SceneSystem マルチシーン アプリケーションのサポートを提供するシステム。
SpatialAwarenessSystem ユーザーの環境を認識するためのサポートを提供するシステム。
TeleportSystem テレポート (ジャンプでのエクスペリエンスの移動) のサポートを提供するシステム。
MRTK/StandardAssets MIXED Reality エクスペリエンス用の MRTK 標準シェーダー、基本マテリアル、その他の標準アセット

拡張機能パッケージ

オプションの Microsoft.MixedRealityToolkit.Unity.Extensions パッケージには、Microsoft Mixed Reality Toolkit の機能を拡張する追加のサービスが含まれています。

注意

拡張機能パッケージには、Microsoft.MixedRealityToolkit.Unity.Foundation が必要です。

Folder コンポーネント 説明
MRTK/拡張機能
HandPhysicsService 多関節手に物理サポートを追加するサービス。
LostTrackingService デバイスでの追跡損失の処理を簡略化するMicrosoft HoloLensサービス。
SceneTransitionService スムーズなシーン切り替えの追加を簡略化するサービス。

ツール パッケージ

オプションの Microsoft.MixedRealityToolkit.Unity.Tools パッケージには、Microsoft Mixed Reality Toolkit を使用して Mixed Reality 開発エクスペリエンスを強化する便利なツールが含まれています。 これらのツールは、Unity エディター の [Mixed Reality Toolkit > ユーティリティ] メニューに表示されます。

注意

ツール パッケージには、Microsoft.MixedRealityToolkit.Unity.Foundation が必要です。

Folder コンポーネント 説明
MRTK/Tools
BuildWindow UWP アプリケーションのビルドとデプロイのプロセスを簡略化するのに役立つツール。
DependencyWindow プロジェクト内の資産の依存関係グラフを作成するツール。
ExtensionServiceCreator 拡張機能サービスの作成を支援するウィザード。
MigrationWindow 非推奨の MRTK コンポーネントを使用するコードの更新を支援するツール。
OptimizeWindow Unity で最高のパフォーマンスを得る Mixed Reality プロジェクトの構成を自動化するのに役立つユーティリティ。
ReserializeAssetsUtility 特定の Unity ファイルの再初期化をサポートします。
RuntimeTools/Tools/ControllerMappingTool 開発者がハードウェア コントローラーの Unity マッピングをすばやく決定できるユーティリティ。
ScreenshotUtility Unity エディターでアプリケーション イメージをキャプチャできます。
TextureCombinerWindow グラフィックス テクスチャを結合するユーティリティ。
ツールボックス MRTK UX コンポーネントを簡単に検出して使用できる UI。

テスト ユーティリティ パッケージ

省略可能な Microsoft.MixedRealityToolkit.TestUtilities パッケージは、開発者が簡単にプレイ モード テスト を作成できるヘルパー スクリプトのコレクションです。 これらのユーティリティは、MRTK コンポーネントを作成する開発者に特に役立ちます。

Folder コンポーネント 説明
MRTK/テスト
TestUtilities ハンド シミュレーション ユーティリティを含む、プレイ モード テストの作成を簡略化するメソッド。

サンプル パッケージ

サンプル パッケージには、基礎パッケージの機能を実行するデモ、サンプル スクリプト、サンプル シーンが含まれています。 このパッケージには、さまざまな種類の手入力 (多関節および非多関節) に応答するサンプル オブジェクトが含まれている HandInteractionExample シーン (下図) が含まれています。

HandInteractionExample シーン

このパッケージには、ここに記載されている目の追跡デモ も含まれています

より一般的に、MRTK の新機能には、同じフォルダー構造と場所に従って、例パッケージに対応する例が含まれている必要があります。

注意

このサンプル パッケージには、Microsoft.MixedRealityToolkit.Unity.Foundation が必要です。

Folder コンポーネント 説明
MRTK/例
デモ 1 つまたは 2 つの関連する機能を示す単純なシーン。
実験用 試験的な機能を示すデモ シーン。
StandardAssets 複数のデモ シーンで共有される一般的な資産。

Unity パッケージ マネージャー

Unity 2019.4 以降を使用して作成されたエクスペリエンスの場合、MRTK はUnityパッケージ マネージャー。

資産パッケージを使用する利点には、次のようなものがあります。

  • 小規模なプロジェクト
    • よりクリーンVisual Studioソリューション
    • チェックインするファイルの数が少ない (MRTK はファイル内の単純な参照 Packages/manifest.json )
  • コンパイルの高速化
    • Unity では、構築中に MRTK を再コンパイルする必要が生じない
  • 依存関係の解決
    • 依存関係を持つパッケージを指定すると、必要な MRTK パッケージが自動的にインストールされます
  • 新しい MRTK バージョンへの簡単な更新
    • ファイルのバージョンを変更 Packages/manifest.json する

たとえば、次のような課題があります。

  • MRTK は変更できません
    • パッケージの解決中に削除せずに変更を加えすることはできません
  • MRTK では、Unity 2018.4 での UPM パッケージはサポートされていません

Foundation パッケージ

基本パッケージ ( com.microsoft.mixedreality.toolkit.foundation ) は、基本パッケージの基礎Mixed Reality Toolkit。

Folder コンポーネント 説明
MRTK/Core インターフェイスと型の定義、基本クラス、標準シェーダー。
MRTK/Core/Providers プラットフォームに依存しないデータ プロバイダー
基本クラスのサポートと、手の追跡のためのサービス。
InputAnimation 頭の動きと手の追跡データを記録するサポート。
InputSimulation 手と目の入力のエディター内シミュレーションのサポート。
ObjectMeshObserver データとして 3D モデルを使用する空間認識オブザーバー。
UnityInput Unity の入力 API を介して実装される一般的な入力デバイス (マウスなど)。
MRTK/プロバイダー プラットフォーム固有のデータ プロバイダー
LeapMotion UltraLeap Leap Motion コントローラーのサポート。
OpenVR OpenVR デバイスのサポート。
Oculus Oculus デバイス (Quest など) のサポート。
UnityAR 実験用Mobile AR デバイスでの MRTK の使用を有効にするカメラ設定プロバイダー。
WindowsMixedReality Microsoft HoloLens やイマーシブヘッドセットなどの Windows Mixed Reality デバイスのサポート。
Windows Microsoft Windows 固有の api (音声やディクテーションなど) のサポート。
XR SDK 実験用Unity 2019.3 以降の unity の NEW XR framework がサポートされています。
MRTK/SDK
実験用 シェーダー、ユーザーインターフェイスコントロール、および個々のシステムマネージャーなどの試験的な機能。
機能 Foundation パッケージに基づいて構築される機能。
Profiles Microsoft Mixed Reality Toolkit システムおよびサービスの既定のプロファイル。
StandardAssets 一般的な資産。モデル、テクスチャ、マテリアルなど
MRTK/サービス
BoundarySystem VR 境界サポートを実装するシステム。
CameraSystem カメラの構成と管理を実装するシステム。
DiagnosticsSystem Visual profiler など、アプリケーション診断でを実装するシステム。
InputSystem ユーザー入力にアクセスして処理するためのサポートを提供するシステム。
SceneSystem マルチシーンアプリケーションサポートを提供するシステム。
SpatialAwarenessSystem システムは、ユーザーの環境を認識するためのサポートを提供します。
受付ポートシステム (ジャンプでのエクスペリエンスについて)、受付移植のサポートを提供するシステム。

依存関係:

  • Standard アセット ( com.microsoft.mixedreality.toolkit.standardassets )

標準アセット

標準アセットパッケージ ( com.microsoft.mixedreality.toolkit.standardassets) は、次のようなすべての mixed reality エクスペリエンスに推奨されるコンポーネントのコレクションです。

  • MRTK 標準シェーダー
  • MRTK Standard shader を使用した基本資料
  • オーディオ ファイル
  • フォント
  • テクスチャ
  • アイコン

注意

アセンブリ定義に基づく重大な変更を回避するために、MRTK Standard shader の一部の機能を制御するために使用されるスクリプトは、標準の assets パッケージには含まれていません。 これらのスクリプトは、フォルダーの foundation パッケージに含ま MRTK/Core/Utilities/StandardShader れています。

依存関係: なし

拡張機能パッケージ

オプションの拡張機能パッケージ ( com.microsoft.mixedreality.toolkit.extensions) MRTK の機能を拡張する追加コンポーネントが含まれています)。

Folder コンポーネント 説明
MRTK/Extensions
HandPhysicsService 独自の手に物理的なサポートを追加するサービス。
LostTrackingService Microsoft HoloLens デバイスでの追跡損失の追跡を簡略化するサービス。
SceneTransitionService スムーズなシーン遷移の追加を簡略化するサービス。
サンプル ~ サンプルのシーンとアセットを含む非表示の (Unity エディターの) フォルダーです。

サンプルプロジェクトを含むパッケージを使用するプロセスの詳細については、「 Mixed Reality Toolkit と Unity パッケージマネージャー 」を参照してください。

依存関係:

  • Foundation ( com.microsoft.mixedreality.toolkit.foundation )

ツールパッケージ

オプションのツールパッケージ ( com.microsoft.mixedreality.toolkit.tools) mixed reality エクスペリエンスの作成に役立つツールが含まれています)。 一般に、これらのツールはエディターコンポーネントであり、そのコードはアプリケーションの一部として出荷されません。

Folder コンポーネント 説明
MRTK/ツール
BuildWindow UWP アプリケーションのビルドと配置のプロセスを簡略化するためのツールです。
DependencyWindow プロジェクトのアセットの依存関係グラフを作成するツール。
ExtensionServiceCreator 拡張サービスの作成を支援するウィザード。
MigrationWindow 非推奨の MRTK コンポーネントを使用するコードの更新を支援するツールです。
最適化ウィンドウ Unity で最適なパフォーマンスを得るために、混合の現実プロジェクトの構成を自動化するためのユーティリティ。
ReserializeAssetsUtility 特定の Unity ファイルを再シリアル化するためのサポートを提供します。
RuntimeTools/Tools/コントローラーマッピングツール ユーティリティを使用すると、開発者はハードウェアコントローラーの Unity マッピングをすばやく決定できます。
ScreenshotUtility Unity エディターでのアプリケーションイメージのキャプチャを有効にします。
TextureCombinerWindow グラフィックステクスチャを結合するユーティリティ。
ツールボックス MRTK UX コンポーネントの検出と使用を容易にする UI。

依存関係:

  • Foundation ( com.microsoft.mixedreality.toolkit.foundation )

テストユーティリティパッケージ

オプションのテストユーティリティパッケージ () には、 com.microsoft.mixedreality.toolkit.testutilities 開発者が再生モードテストを簡単に作成できるようにするヘルパースクリプトのコレクションが含まれています。 これらのユーティリティは、MRTK コンポーネントを作成する開発者に特に役立ちます。

Folder コンポーネント 説明
MRTK/テスト
TestUtilities ハンド シミュレーション ユーティリティを含む、プレイ モード テストの作成を簡略化するメソッド。

依存関係:

  • Foundation ( com.microsoft.mixedreality.toolkit.foundation )

サンプル パッケージ

examples パッケージ ( ) は、開発者が関心のある例のみをインポート com.microsoft.mixedreality.toolkit.examples するために構成されています。

サンプル プロジェクトを含むパッケージを使用するプロセスの詳細については、「Mixed Reality Toolkitおよび Unityパッケージ マネージャー参照してください。

Folder コンポーネント 説明
MRTK/例
サンプル~ サンプル シーンとアセットを含む非表示の (Unity エディター内の) フォルダー。
StandardAssets 複数のデモ シーンで共有される一般的な資産。

依存関係:

  • Foundation ( com.microsoft.mixedreality.toolkit.foundation )
  • 拡張機能 (com.microsoft.mixedreality.toolkit.extensions)

こちらもご覧ください