本文へスキップ

class XRObjectDetectionSubsystem

(Niantic.Lightship.AR.XRSubsystems.XRObjectDetectionSubsystem)

概要​

オブジェクト検出機能と相互作用するためのインターフェイスを定義します。

class XRObjectDetectionSubsystem:
	    SubsystemWithProvider< XRObjectDetectionSubsystem, XRObjectDetectionSubsystemDescriptor, XRObjectDetectionSubsystem.Provider >,
	    ISubsystemWithModelMetadata {
	public:
	
		class Provider;

		// properties
	
		uint TargetFrameRate;
		bool IsMetadataAvailable;
		uint? LatestFrameId;
		bool IsStabilizationEnabled;

		// メソッド
	
		bool TryGetCategoryNames(out IReadOnlyList<string> names);
		bool TryGetDetectedObjects(out XRDetectedObject[] results);
		XRObjectDetectionSubsystem();
		static bool Register(XRObjectDetectionSubsystemCinfo cinfo);
	};

詳細なドキュメント​

オブジェクト検出機能と相互作用するためのインターフェイスを定義します。

これは、実験的な機能です。 実験的な機能は変更される可能性があり、公式にはサポートされていません。

プロパティ​

TargetFrameRate​

uint TargetFrameRate

オブジェクト検出アルゴリズムを実行するプラットフォームの目標フレームレートを指定します。

目標フレームレート。

これは実験的なAPIです。 実験的な機能は変更される可能性があり、公式にはサポートされていません。

    パラメーター:

    System.NotSupportedException - フレームレートの設定がサポートされていない場合にスローされます。

IsMetadataAvailable​

bool IsMetadataAvailable

メタデータが現在のデバイスにダウンロードされており、復号されている場合はtrueが返ります。 オブジェクト検出のカテゴリー名や結果は、この値がtrueの場合にのみ取得できます。

メタデータが利用可能かどうかを確認します。

これは実験的なAPIです。 実験的な機能は変更される可能性があり、公式にはサポートされていません。

    パラメーター:

    System.NotSupportedException - スローされたフレームレート設定はサポートされていません。

LatestFrameId​

uint? LatestFrameId

最新のオブジェクト検出出力のフレームIDが返ります。

フレームid。

これは実験的なAPIです。 実験的な機能は変更される可能性があり、公式にはサポートされていません。

    パラメーター:

    System.NotSupportedException - フレーム ID の取得がサポートされていない場合にスローされます。

IsStabilizationEnabled​

bool IsStabilizationEnabled

有効にすると、オブジェクト検出アルゴリズムは、オブジェクトが連続して何フレーム見えたか、また以前に検出されたオブジェクトが何フレーム見えなくなったかを考慮して、どの検出を表面化するかを決定します。 これにより、誤検出の可能性が低下しますが、フレームレートが低く、各フレーム間でカメラの視野が大きく移動している場合には、検出漏れが増加する可能性があります。

安定化が有効になっている場合はtrueが返ります。

これは実験的なAPIです。 実験的な機能は変更される可能性があり、公式にはサポートされていません。

    パラメーター:

    System.NotSupportedException - 安定化の設定が実装でサポートされていない場合にスローされます。

メソッド​

TryGetCategoryNames​

bool TryGetCategoryNames(out IReadOnlyList<string> names)

現在のモデルのオブジェクト検出カテゴリー名のリストの取得を試みます。

これは実験的なAPIです。 実験的な機能は変更される可能性があり、公式にはサポートされていません。

    パラメーター:

    names - カテゴリー名のリスト。 メソッドがfalseを返した場合は空になります。

    System.NotSupportedException - カテゴリー名の読み取りが実装でサポートされていない場合にスローされます。

    戻り値:

    カテゴリー名が取得可能な場合はtrueが返ります。 そうでない場合はfalseです。

TryGetDetectedObjects​

bool TryGetDetectedObjects(out XRDetectedObject[] results)

カメラ画像から最新のオブジェクト検出結果の取得を試みます。

これは実験的なAPIです。 実験的な機能は変更される可能性があり、公式にはサポートされていません。

    パラメーター:

    results - オブジェクト検出インスタンスの配列。

    System.NotSupportedException - オブジェクト検出結果の取得が実装でサポートされていない場合にスローされます。

    戻り値:

    オブジェクト検出インスタンスを取得できたかどうかを示します。

XRObjectDetectionSubsystem​

XRObjectDetectionSubsystem()

機能プロバイダを作成してサブシステムを構築します。

Regiter​

static bool Register(XRObjectDetectionSubsystemCinfo cinfo)

オブジェクト検出サブシステムを実装するためのディスクリプタを登録します。

    パラメーター:

    cinfo - オブジェクト検出サブシステム実装の構築情報。

    戻り値:

    ディスクリプタが登録されていればtrue。 それ以外の場合、false。