本文へスキップ
バージョン： 3.1

クラス プロバイダ

(Niantic.Lightship.AR.XRSubsystems.XRSemanticsSubsystem.Provider)

概要​

XRSemanticsSubsystem](/docs/ja/ardk/3.1/apiref/Niantic/Lightship/AR/XRSubsystems/XRSemanticsSubsystem/)をサービスするプロバイダ。

    クラス Provider：SubsystemProvider< XRSemanticsSubsystem > {
    public：
        // フィールド
    
         ?uint LatestFrameId => throw new NotSupportedException("Getting the latest frame id is not supported by this implementation");
         bool IsMetadataAvailable => throw new NotSupportedException("Getting if metadata is available is not supported by this implementation")；

        // プロパティ
    
        uint TargetFrameRate;

        // メソッド
    
        virtual bool TryPrepareSubsystem();
    
        virtual bool TryGetSemanticChannel(
            string channelName,
            out XRTextureDescriptor semanticChannelDescriptor,
            out Matrix4x4 samplerMatrix,
            XRCameraParams?cameraParams = null
        );
    
        virtual bool TryAcquireSemanticChannelCpuImage(
            string channelName,
            out XRCpuImage cpuImage,
            out Matrix4x4 samplerMatrix,
            XRCameraParams?cameraParams = null
        );
    
        virtual bool TryGetPackedSemanticChannels(
            out XRTextureDescriptor packedSemanticsDescriptor,
            out Matrix4x4 samplerMatrix,
            XRCameraParams?cameraParams = null
        );
    
        virtual bool TryAcquirePackedSemanticChannelsCpuImage(
            out XRCpuImage cpuImage,
            out Matrix4x4 samplerMatrix,
            XRCameraParams?cameraParams = null
        );
    
        virtual bool TryGetChannelNames(out IReadOnlyList<string> names);
        virtual bool TrySetChannelConfidenceThresholds(Dictionary<string, float> channelConfidenceThresholds);
}；

詳細資料​

XRSemanticsSubsystem](/docs/ja/ardk/3.1/apiref/Niantic/Lightship/AR/XRSubsystems/XRSemanticsSubsystem/)をサービスするプロバイダ。

プロパティ​

TargetFrameRate​

uint ターゲットフレームレート

プラットフォームのセマンティックセグメンテーション機能のフレームレートを取得または設定するためにプロバイダが実装するプロパティ。

要求されたフレームレート（フレーム/秒）。

    **パラメーター

    System.NotSupportedException - 実装がサポートしていないフレームレートを要求したときにスローされます。

方法​

TryPrepareSubsystem​

仮想ブール TryPrepareSubsystem()

セマンティックセグメンテーションモデルの準備ができたら、サブシステムのデータ構造を準備する。

    **返品について

    セマンティックセグメンテーションモデルの準備が整い、サブシステムがデータ構造を準備した場合、true を返します。 False - それ以外

TryGetSemanticChannel​

virtual bool TryGetSemanticChannel(
        string channelName,
        out XRTextureDescriptor semanticChannelDescriptor,
        out Matrix4x4 samplerMatrix,
        XRCameraParams? cameraParams = null
)

セマンティックチャネルのテクスチャ記述子と、ビューポートからテクスチャの座標空間に変換する行列を取得するためにプロバイダによって実装されるメソッド。

    **パラメーター

    channelName`` - 必要なセマンティクスチャネルの文字列。

    semanticChannelDescriptor - セマンティックチャンネルのテクスチャ記述子。

    samplerMatrix - ビューポートからテクスチャに正規化された座標を変換します。

    cameraParams - ビューポートを記述する。

    System.NotSupportedException - 実装がセマンティックチャンネルテクスチャをサポートしていない場合にスローされます。

    **返品について

    セマンティックチャネルのテクスチャディスクリプタが利用可能で、返される場合はtrue。 False - それ以外

TryAcquireSemanticChannelCpuImage​

virtual bool TryAcquireSemanticChannelCpuImage(
        string channelName,
        out XRCpuImage cpuImage,
        out Matrix4x4 samplerMatrix,
        XRCameraParams? cameraParams = null
)

最新のセマンティックチャンネルCPU画像の取得を試みる。

    **パラメーター

    channelName`` - 必要なセマンティクスチャネルの文字列。

    cpuImage- このメソッドがtrue`` を返した場合、取得した XRCpuImage を返します。 XRCpuImageは呼び出し元が処分しなければなりません。

    samplerMatrix - ピクセル座標をサンプリングするための行列で、ディスプレイ行列とワープ行列から構成される。

    cameraParams - サンプリングするビューポートのパラメータ。

    System.NotSupportedException - 実装がセマンティックチャンネルCPUイメージをサポートしていない場合にスローされます。

    **返品について

    XRCpuImage の取得に成功した場合に true を返す。

TryGetPackedSemanticChannels​

virtual bool TryGetPackedSemanticChannels(
        out XRTextureDescriptor packedSemanticsDescriptor,
        out Matrix4x4 samplerMatrix,
        XRCameraParams? cameraParams = null
)

パックされたセマンティクス・テクスチャ記述子を取得します。

    **パラメーター

    packedSemanticsDescriptor - プロバイダから利用可能であれば、入力されるパックされたセマンティクス・テクスチャ記述子。

    samplerMatrix - ビューポートからテクスチャ座標に変換する行列。

    cameraParams - ビューポートを記述する。

    System.NotSupportedException - packed semantics texture をサポートしていない場合にスローされます。

    **返品について

    packed semantics texture descriptorが利用可能であればtrueを返す。 False - それ以外

TryAcquirePackedSemanticChannelsCpuImage​

virtual bool TryAcquirePackedSemanticChannelsCpuImage(
        out XRCpuImage cpuImage,
        out Matrix4x4 samplerMatrix,
        XRCameraParams? cameraParams = null
)

最新のパックされたセマンティックチャンネルXRCpuImageの取得を試みる。

    **パラメーター

    cpuImage- このメソッドがtrue`` を返した場合、取得した XRCpuImage を返します。 XRCpuImageは呼び出し元が処分しなければなりません。

    samplerMatrix - ビューポートからテクスチャ座標に変換する行列。

    cameraParams - ビューポートを記述する。

    **返品について

TryGetChannelNames​

virtual bool TryGetChannelNames(out IReadOnlyList<string> names)

現在のセマンティックモデルのセマンティックチャンネル名のリストを取得するためにプロバイダによって実装されるメソッド。

    **パラメーター

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

    System.NotSupportedException - チャネル名の読み込みが実装によってサポートされていない場合にスローされます。

    **返品について

    チャンネル名が利用可能であれば真。 そうでない場合は偽。

TrySetChannelConfidenceThresholds​

virtual bool TrySetChannelConfidenceThresholds(Dictionary<string, float> channelConfidenceThresholds)

パックされたセマンティックチャンネルバッファに、指定したセマンティックチャンネルを含めるための信頼度しきい値を設定します。

各意味チャネルは、ARセッション中にこの関数によって新しい値が設定されるまで、モデルによって選択されたデフォルトのしきい値を使用する。

    **パラメーター

    channelConfidenceThresholds - 必要とされるセマンティクスチャネルの名前を指定するキーと、プラットフォームが指定されたチャネルをパックされたセマンティクスバッファに含める閾値を設定する0から1までの値で構成される辞書。 キーは、TryGetChannelNamesが返すリストに存在するセマンティックチャネル名でなければなりません。

    System.NotSupportedException - 信頼度のしきい値の設定が実装によってサポートされていない場合にスローされます。

    **返品について

    閾値が設定されていれば真。 False - それ以外