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

クラス XRPersistentAnchorSubsystem

(Niantic.Lightship.AR.XRSubsystems.XRPersistentAnchorSubsystem)

概要​

永続アンカー・サブシステムのベース・クラス。

    class XRPersistentAnchorSubsystem：TrackingSubsystem< XRPersistentAnchor, XRPersistentAnchorSubsystem, XRPersistentAnchorSubsystemDescriptor, XRPersistentAnchorSubsystem.Provider > {
    public：
    
        class Provider;

        // properties
    
        XRPersistentAnchorConfiguration CurrentConfiguration;

        // methods
    
        XRPersistentAnchorSubsystem();
        override TrackableChanges<XRPersistentAnchor> GetChanges(Allocator allocator);
        bool TryAddAnchor(Pose pose, out XRPersistentAnchor anchor);
        bool TryRemoveAnchor(TrackableId anchorId)；
    
        bool TryRestoreAnchor(
            XRPersistentAnchorPayload anchorPayload,
            out XRPersistentAnchor anchor
        );
    
        bool TryLocalize(
            XRPersistentAnchorPayload anchorPayload,
            out XRPersistentAnchor anchor
        );
    
        bool GetVpsSessionId(out string vpsSessionId);

    protected：
        // メソッド
    
        override void OnStart();
        override void OnStop();
}；

詳細資料​

永続アンカー・サブシステムのベース・クラス。

アンカーとは、XRデバイスによって追跡される物理的環境におけるポーズのことである。 デバイスが環境の理解を深めるにつれて、アンカーは更新され、バーチャル・コンテンツを現実世界の位置や方向と結びつけておくことができる。

この抽象クラスは、XR プロバイダによって実装され、SubsystemManager を使用してインスタンス化され、利用可能な XRPersistentAnchorSubsystemDescriptor s を列挙する必要があります。

プロパティ​

現在の設定​

XRPersistentAnchorConfiguration 現在のコンフィギュレーション

\XRPersistentAnchorConfiguration\で設定を取得または設定する。

方法​

XRPersistentAnchorSubsystem​

XRPersistentAnchorSubsystem()

コンストラクタ。 SubsystemManager を使用して利用可能な XRPersistentAnchorSubsystemDescriptor を列挙し、必要な記述子に対して Create を呼び出します。

GetChanges​

override TrackableChanges<XRPersistentAnchor> GetChanges(Allocator allocator)

GetChanges(Allocator)](/docs/ja/ardk/3.1/apiref/Niantic/Lightship/AR/XRSubsystems/XRPersistentAnchorSubsystem/#GetChanges)を最後にコールしてからのアンカーの変更点(追加、更新、削除)を取得する。

    パラメーター:

    allocator - TrackableChanges&lt;T&gt; の NativeArrays に使用するアロケータ。

    返品について:

    最後に GetChanges をコールしてからの変更。

TryAddAnchor​

bool TryAddAnchor(Pose pose, out XRPersistentAnchor anchor)

提供されたポーズで新しいアンカーの作成を試みる。

    パラメーター:

    pose - セッション空間における、新しいアンカーのポーズ。

    anchor`` - 新しいアンカー。 このメソッドがtrueを返した場合のみ有効。

    返品について:

    新しいアンカーが追加された場合はtrue、そうでない場合はfalse。

TryRemoveAnchor​

bool TryRemoveAnchor(TrackableId anchorId)

TrackableId anchorId を持つ既存のアンカーの削除を試みます。

    パラメーター:

    anchorId - 削除する既存のアンカーの ID。

    返品について:

    アンカーが削除された場合はtrue、そうでない場合はfalse。

TryRestoreAnchor​

bool TryRestoreAnchor(
        XRPersistentAnchorPayload anchorPayload,
        out XRPersistentAnchor anchor
    )

アンカーの復元を試みる

    パラメーター:

    anchorPayload - アンカーを復元するペイロード。

    anchor - 復元されたアンカー。

    返品について:

    修復の成否

GetVpsSessionId​

bool GetVpsSessionId(out string vpsSessionId)

もしあれば、vpsセッションIDを取得する。

    パラメーター:

    vpsSessionId - vpsセッションIDで、32文字の16進数大文字の文字列。

    返品について:

    vpsセッションIDが存在する場合はtrue、そうでない場合はfalse。