MixedRealityServiceRegistry と IMixedRealityServiceRegistrar とは何か?

Mixed Reality Toolkit には、関連するタスクを行う2つの非常に似た名前のコンポーネントがあります。 MixedRealityServiceRegistry と IMixedRealityServiceRegistrar です。

MixedRealityServiceRegistry

MixedRealityServiceRegistry は登録されたサービス（コアシステムとエクステンションサービス）のそれぞれのインスタンスを含むコンポーネントです。

Note

MixedRealityServiceRegistry は、IMixedRealityExtensionService を含む IMixedRealityService インターフェイスを実装したオブジェクトのインスタンスを含んでいます。

IMixedRealityDataProvider (IMixedRealityService のサブクラス) を実装しているオブジェクトは、明示的には MixedRealityServiceRegistry に登録されていません。これらのオブジェクトは、個々のサービス（例えば、Spatial Awareness）によって管理されています。

MixedRealityServiceRegistry は静的な C# クラスとして実装されており、アプリケーションコードでサービスのインスタンスを取得するのに使われる推奨パターンです。

以下のスニペットは、IMixedRealityInputSystem のインスタンスを取得するデモです。

IMixedRealityInputSystem inputSystem = null;

if (!MixedRealityServiceRegistry.TryGetService<IMixedRealityInputSystem>(out inputSystem))
{
    // input system の取得に失敗。登録されていないかもしれない。
}

IMixedRealityServiceRegistrar

IMixedRealityServiceRegistrar は、1つまたは複数のサービスの登録を管理するコンポーネントで実装される機能を定義したインターフェイスです。 IMixedRealityServiceRegistrar を実装したコンポーネントは、MixedRealityServiceRegistry 内のデータの追加と削除を行う責務があります。 MixedRealityToolkit オブジェクトはそのようなコンポーネントの一つです。

その他の registrars は MRTK/SDK/Experimental/Features フォルダーにて見つけることができます。これらのコンポーネントは、単一のサービス（例えば、Spatial Awareness）のサポートをアプリケーションに追加するのに使うことができます。これらの、単一サービスのマネージャーは以下の通りです。

上記コンポーネントの内 InputSystemManager 以外のものは、単一のサービスタイプの登録と状態を管理する責務があります。 InputSystem はいくつかの追加のサポートサービス（例えば、FocusProvider）を必要とし、それらもまた InputSystemManager によって管理されます。

一般的に、IMixedRealityServiceRegistrar によって定義されたメソッドはサービスマネジメントコンポーネントによって内部的に呼ばれる、もしくは、正しく機能するために追加のサービスコンポーネントを必要とするサービスによって呼ばれます。アプリケーションコードは、一般的に、これらのメソッドを呼ぶべきではありません。アプリケーションが予想外の動きをする（例えば、キャッシュされたサービスインスタンスが無効になるかもしれない）可能性があるためです。

日本語翻訳ドキュメントはサポートを終了しました

MixedRealityServiceRegistry と IMixedRealityServiceRegistrar とは何か?