本文へスキップ

クラス 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);
}；

詳細資料​

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

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

Properties​

TargetFrameRate​

uint TargetFrameRate

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

目標フレームレート。

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

    Parameters:

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

IsMetadataAvailable​

bool IsMetadataAvailable

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

メタデータがあれば。

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

    Parameters:

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

LatestFrameId​

uint? LatestFrameId

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

フレームid。

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

    Parameters:

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

IsStabilizationEnabled​

ブール IsStabilizationEnabled

有効にすると、物体検出アルゴリズムは、表面化する検出を決定する際に、物体が何フレーム連続して見られたか、および以前に検出された物体が何フレーム未見であったかを考慮する。 これはスプリアス検出の可能性を減少させる効果がありますが、フレームレートが低く、カメラビューが各フレーム間で大きく移動している場合、見逃し検出が増加する可能性もあります。

安定化が有効なら真。

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

    Parameters:

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

方法​

TryGetCategoryNames​

bool TryGetCategoryNames(out IReadOnlyList<string> names)

現在のモデルのオブジェクト検出カテゴリ名のリストを取得しようとします。

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

    Parameters:

    name`` - カテゴリ名のリスト。 メソッドがfalseを返した場合は空になる。

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

    戻り値

    カテゴリー名が利用可能であれば真。 そうでない場合はfalseです。

TryGetDetectedObjects​

ブール TryGetDetectedObjects(out XRDetectedObject[] results)

カメラ画像から最新の物体検出結果の取得を試みる。

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

    Parameters:

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

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

    戻り値

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

XRObjectDetectionSubsystem​

XRObjectDetectionSubsystem()

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

Regiter​

静的 bool Register(XRObjectDetectionSubsystemCinfo cinfo)

オブジェクト検出サブシステム実装の記述子を登録する。

    Parameters:

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

    戻り値

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