本文へスキップ

class ARDeviceMap

(Niantic.Lightship.AR.Mapping.ARDeviceMap)

概要​

ARDeviceMapは、マッピングプロセスで生成されたデバイスマップデータを管理し、永続化や共有のためにシリアライズおよびデシリアライズを行う機能を提供します。

class ARDeviceMap {
	public:
	
		struct SerializableDeviceMap;
		struct SerializeableDeviceMapGraph;
		struct SerializeableDeviceMapNode;

		// プロパティ
	
		List<SerializeableDeviceMapNode> DeviceMapNodes;
		SerializeableDeviceMapGraph DeviceMapGraph;
		int DefaultAnchorIndex;

		// メソッド
	
		ARDeviceMap();
	
		void AddDeviceMapNode(
			ulong subId1,
			ulong subId2,
			byte[] mapData,
			byte[] anchorPayload,
			string mapType
		);
	
		bool HasMapNode(TrackableId mapId);
		void SetDeviceMapGraph(byte[] graphData);
		virtual byte[] Serialize();
		byte[] GetAnchorPayload();
		bool HasValidMap();
		static ARDeviceMap CreateFromSerializedData(byte[] serializedDeviceMap);

	protected:
		// フィールド
	
		 List<SerializeableDeviceMapNode> _deviceMapNodes = new();
		 SerializeableDeviceMapGraph _deviceMapGraph = new();
		 int _defaultAnchorIndex = 0;
		 HashSet<TrackableId> _addedMapIds = new HashSet<TrackableId>();
	};

詳細なドキュメント​

ARDeviceMapは、マッピングプロセスで生成されたデバイスマップデータを管理し、永続化や共有のためにシリアライズおよびデシリアライズを行う機能を提供します。

.. 注::

これは実験的な機能であり、予告なく変更または廃止されることがあります

プロパティ​

DeviceMapNodes​

List<SerializeableDeviceMapNode> DeviceMapNodes

デバイスにマッピングされた、またはデシリアライズされたSerializeableDeviceMapNodeのリストを取得します。

.. 注::

これは実験的な機能であり、予告なく変更または廃止されることがあります

DeviceMapGraph​

SerializeableDeviceMapGraph DeviceMapGraph

このデバイスマップ内のSerializeableDeviceMapGraphを取得します。

.. 注::

これは実験的な機能であり、予告なく変更または廃止されることがあります

メソッド​

AddDeviceMapNode​

void AddDeviceMapNode(
		ulong subId1,
		ulong subId2,
		byte[] mapData,
		byte[] anchorPayload,
		string mapType
	)

デバイスマップノードを追加します。 このメソッドは、デバイスマップが生成される際に ARDeviceMappingManagerから呼び出されることを想定しています。

.. 注::

これは実験的な機能であり、予告なく変更または廃止されることがあります

    パラメーター:

    subId1 -

    subId2 -

    mapData -

    anchorPayload -

HasMapNode​

bool HasMapNode(TrackableId mapId)

指定したIDのノードがマップ内に存在するかを確認します。

.. 注::

これは実験的な機能であり、予告なく変更または廃止されることがあります

    パラメーター:

    mapId -

SetDeviceMapGraph​

void SetDeviceMapGraph(byte[] graphData)

グラフのブロブデータを設定します。 このメソッドは、デバイスマップおよびグラフが生成される際に ARDeviceMappingManagerから呼び出されることを想定しています。

.. 注::

これは実験的な機能であり、予告なく変更または廃止されることがあります

    パラメーター:

    graphData -

Serialize​

virtual byte[] Serialize()

シリアライズ済みのデバイスマップを取得します。

.. 注::

これは実験的な機能であり、予告なく変更または廃止されることがあります

    戻り値:

     シリアライズされたデバイスマップ（バイト配列）。

GetAnchorPayload​

byte[] GetAnchorPayload()

このデバイスマップのアンカーペイロードを取得します。

.. 注::

これは実験的な機能であり、予告なく変更または廃止されることがあります

    戻り値:

     永続的なアンカーペイロード（バイト配列）。

HasValidMap​

bool HasValidMap()

このARDeviceMapに有効なデバイスマップデータがあるかを確認します。 有効なマップデータがない場合、このARDviceMapはシリアライズに使用しないでください。

    戻り値:

     有効なデバイスマップデータがある場合はTrue、 それ以外の場合false。

CreateFromSerializedData​

static ARDeviceMap CreateFromSerializedData(byte[] serializedDeviceMap)

シリアライズされたデバイスマップデータからARDeviceMapのインスタンスを作成します。

.. 注::

これは実験的な機能であり、予告なく変更または廃止されることがあります

    パラメーター:

    serializedDeviceMap - シリアライズされたデバイスマップ（バイト配列）

    戻り値:

     ARDeviceMapのインスタンス