class IModelPreloader
(Niantic.Lightship.AR.Utilities.Preloading.IModelPreloader)
概要
ARDK クラスのインターフェイスで、認識特徴に必要なニューラルネットワーク モデル ファイルを事前にダウンロードします。 ファイルがプリロードされていない場合、これらの機能を使用するように設定された AR セッションが実行されると、ファイルのダウンロードに時間がかかります。
クラス IModelPreloader：IDisposable {
public：
// methods
virtual abstract PreloaderStatusCode DownloadModel(DepthMode depthMode) = 0;
virtual abstract PreloaderStatusCode DownloadModel(SemanticsMode semanticsMode) = 0;
virtual abstract PreloaderStatusCode RegisterModel(
DepthMode depthMode,
string filepath
) = 0；
virtual abstract PreloaderStatusCode RegisterModel(
SemanticsMode semanticsMode,
string filepath
) = 0;
virtual abstract PreloaderStatusCode CurrentProgress(
DepthMode depthMode,
out float progress
) = 0；
virtual abstract PreloaderStatusCode CurrentProgress(
SemanticsMode semanticsMode,
out float progress
) = 0;
virtual abstract bool ExistsInCache(DepthMode depthMode) = 0;
virtual abstract bool ExistsInCache(SemanticsMode semanticsMode) = 0；
virtual abstract bool ClearFromCache(DepthMode depthMode) = 0;
virtual abstract bool ClearFromCache(SemanticsMode semanticsMode) = 0;
virtual abstract void Dispose() = 0;
}；
詳細資料
ARDK クラスのインターフェイスで、認識特徴に必要なニュ ーラルネットワーク モデル ファイルを事前にダウンロードします。 ファイルがプリロードされていない場合、これらの機能を使用するように設定された AR セッションが実行されると、ファイルのダウンロードに時間がかかります。
各アウェアネス機能には、性能-品質曲線上に1つ以上のモードがあり、各モードは異なるモデルファイルに対応している。 Niantic.Lightship.AR.Utilities.Preloading](./../index.mdx)の機能を参照してください。
方法
ダウンロードモデル
virtual abstract PreloaderStatusCode DownloadModel(DepthMode depthMode) = 0
要求されたモデルファイルがまだ存在しなければ、キャッシュへのダウンロードを開始する。 リクエストステータスは、CurrentProgress(DepthMode, float)またはExistsInCache(DepthMode)でポーリングできます。
**返品について
リクエストの初期ステータスを示すPreloaderStatusCodeを返す。 リクエストの最終結果は、非同期ネットワーク操作のために延期される可能性があるため、このリクエストがPreloaderStatusCode.SuccessまたはPreloaderStatusCode.RequestInProgressを返す場合、ユーザーは、ネットワークリクエストが正常に完了したことを確認するために、フレームごとにCurrentProgress(DepthMode, out float)を問い合わせ続ける必要があります。
ダウンロードモデル
virtual abstract PreloaderStatusCode DownloadModel(SemanticsMode semanticsMode) = 0
要求されたモデルファイルがまだ存在しなければ、キャッシュへのダウンロードを開始する。 リクエストステータスは、CurrentProgress(SemanticsMode, float)またはExistsInCache(SemanticsMode)でポーリングできます。
**返品について
リクエストの初期ステータスを示すPreloaderStatusCodeを返す。 リクエストの最終結果は、非同期ネットワーク操作のために延期される可能性があるため、このリクエストがPreloaderStatusCode.SuccessまたはPreloaderStatusCode.RequestInProgressを返す場合、ユーザーは、ネットワークリクエストが正常に完了したことを確認するために、フレームごとにCurrentProgress(SemanticsMode, out float)を問い合わせ続ける必要があります。
登録モデル
virtual abstract PreloaderStatusCode RegisterModel(
DepthMode depthMode,
string filepath
) = 0
特定のフィーチャーのローカルニューラルネットワークモデルファイルを登録します。 こ れは、指定された機能モードに対する Lightship の URI を上書きし、Lightship が初期化されるまで有効です。 このファイルは、アプリケーションからアクセス可能な場所にあり、ARセッションの間、そのままでなければならない。
**返品について
リクエストの結果を示すPreloaderStatusCodeを返す。
登録モデル
virtual abstract PreloaderStatusCode RegisterModel(
SemanticsMode semanticsMode,
string filepath
) = 0
特定のフィーチャーのローカルニューラルネットワークモデルファイルを登録します。 これは、指定された機能モードに対する Lightship の URI を上書きし、Lightship が初期化されるまで有効です。 このファイルは、アプリケーションからアクセス可能な場所にあり、ARセッションの間、そのままでなければならない。
**返品について
リクエストの結果を示すPreloaderStatusCodeを返す。
現在の進行状況
virtual abstract PreloaderStatusCode CurrentProgress(
DepthMode depthMode,
out float progress
) = 0
モードファイル要求の現在のステータスを読む。 DownloadModel の結果は非同期であるため、HTTP リクエストが正常に完了したことを確認するために、呼び出し元は CurrentProgress(DepthMode, float) をポーリングしてリクエストのステータスを確認する必要があります。
**パラメーター
progress - [0.0, 1.0] の範囲の値で、指定したフィーチャーモードのモデルファイルのダウンロードがどれだけ進んでいるかを表します。 進捗が1.0であれば、ファイルがキャッシュに存在することを意味する。 ダウンロードの進行状況はサーバーに依存するため、常に進行状況のインクリメンタルな更新をサポートするとは限りません。
**返品について
リクエストのステータスを示すPreloaderStatusCodeを返す。
現在の進行状況
virtual abstract PreloaderStatusCode CurrentProgress(
SemanticsMode semanticsMode,
out float progress
) = 0
モードファイル要求の現在のステータスを読む。 DownloadModel の結果は非同期であるため、呼び出し元は HTTP リクエストが正常に完了したことを確認するために、CurrentProgress(SemanticsMode, float)をポーリングしてリクエストのステータスを確認する必要があります。
**パラメーター
progress - [0.0, 1.0] の範囲の値で、指定したフィーチャーモードのモデルファイルのダウンロードがどれだけ進んでいるかを表します。 進捗が1.0であれば、ファイルがキャッシュに存在することを意味する。 ダウンロードの進行状況はサーバーに依存するため、常に進行状況のインクリメンタルな更新をサポートするとは限りません。
**返品について
リクエストのステータスを示すPreloaderStatusCodeを返す。
ExistsInCache
virtual abstract bool ExistsInCache(DepthMode depthMode) = 0
指定されたDepthModeに関連付けられたモデルがキャッシュに存在するかどうかをチェックします。
**返品について
指定されたモデルがアプリケーションのキャッシュで見つかった場合は真。
ExistsInCache
virtual abstract bool ExistsInCache(SemanticsMode semanticsMode) = 0
指定されたSemanticsModeに関連付けられたモデルがキャッシュに存在するかどうかをチェックします。
**返品について
指定されたモデルがアプリケーションのキャッシュで見つかった場合は真。
ClearFromCache
virtual abstract bool ClearFromCache(DepthMode depthMode) = 0
このモデル・ファイルをアプリケーションのキャ ッシュから消去します。 この関数は、ダウンロードが現在進行中であるか、ファイルがキャッシュに存在しない場合に失敗する。 指定されたモデルが Lightship AR セッションに現在ロードされているときにこれを呼び出すことは無効であり、未定義の動作になります。
**返品について
指定された機能がアプリケーションのキャッシュに存在し、正常に削除された場合は真。
ClearFromCache
仮想抽象bool ClearFromCache(SemanticsMode semanticsMode) = 0
このモデル・ファイルをアプリケーションのキャッシュから消去します。 この関数は、ダウンロードが現在進行中であるか、ファイルがキャッシュに存在しない場合に失敗する。 指定されたモデルが Lightship AR セッションに現在ロードされているときにこれを呼び出すことは無効であり、未定義の動作になります。
**返品について
指定された機能がアプリケーションのキャッシュに存在し、正常に削除された場合は真。
廃棄
virtual abstract void Dispose() = 0
ネイティブモデルプリローダーのハンドルを破棄します。