本文へスキップ

クラス DeviceMapAccessController

(Niantic.Lightship.AR.Mapping.DeviceMapAccessController)。

概要​

プリミティブ・デバイス・マップ・データとコンフィグにアクセスするためのクラス。

class DeviceMapAccessController {
	public：
		// プロパティ
	
		DeviceMapAccessController Instance;
		OutputEdgeType OutputEdgeType;

		// メソッド
	
		void ClearDeviceMap();
		void StartUploadingMaps();
		void StopUploadingMaps();
		void StartDownloadingMaps();
		void StopDownloadingMaps();
		bool MarkMapNodeForUpload(TrackableId mapId)；
		bool HasMapNodeBeenUploaded(TrackableId mapId);
		void AddMapNode(byte[] dataBytes);
		void AddSubGraph(byte[] dataBytes)；
		bool GetMapNodeIds(out TrackableId[] mapIds);
	
		bool GetSubGraphIds(
			out TrackableId[] subgraphIds,
			OutputEdgeType outputEdgeType = OutputEdgeType.All
		);
	
		bool GetMapNodes(TrackableId[] mapIds, out MapNode[] maps);
		bool GetSubGraphs(TrackableId[] subgraphIds, out MapSubGraph[] blobs)；
	
		bool GetLatestUpdates(
			out MapNode[] mapNodes,
			out MapSubGraph[] subGraphs,
			OutputEdgeType outputEdgeType = OutputEdgeType.All
		);
	
		bool CreateAnchorFromMapNode(
			MapNode map,
			Matrix4x4 pose,
			out byte[] anchorPayload
		);
	
		bool MergeSubGraphs(
			MapSubGraph[] subgraphs,
			bool onlyKeepLatestEdges,
			out MapSubGraph mergedSubgraph
		)；
	
		void ExtractMapMetaData(
			byte[] mapBlob,
			out Vector3[] points,
			out float[] errors,
			out Vector3 center,
			out string mapType
		);
}；

詳細資料​

プリミティブ・デバイス・マップ・データとコンフィグにアクセスするためのクラス。

.. 注::

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

Properties​

OutputEdgeType​

出力エッジタイプ OutputEdgeType

GetSubGraphs()](./index.mdx#GetSubGraphs)で出力されるエッジのタイプを指定します。

.. 注::

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

Methods​

ClearDeviceMap​

void ClearDeviceMap()

ローカライザーにローカルに登録されたマップ/グラフ・ノードをクリアする。

.. 注::

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

StartUploadingMaps​

void StartUploadingMaps()

このコールオンから生成された新しい地図のアップロードを開始する。

.. 注::

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

StopUploadingMaps​

void StopUploadingMaps()

地図のアップロード停止

.. 注::

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

StartDownloadingMaps​

void StartDownloadingMaps()

地図ダウンロード開始

.. 注::

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

StopDownloadingMaps​

void StopDownloadingMaps()

地図のダウンロードを停止する

.. 注::

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

MarkMapNodeForUpload​

bool MarkMapNodeForUpload(TrackableId mapId)

アップロードするマップノードをマークします。 ダウンロードはStartUploadingMapsによってトリガーされる。 opが早期に失敗した場合にfalseを返す。

.. 注::

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

HasMapNodeBeenUploaded​

bool HasMapNodeBeenUploaded(TrackableId mapId)

マップノードがアップロードされたかどうかをチェックする

.. 注::

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

AddMapNode​

void AddMapNode(byte[] dataBytes)

ローカライザーにマップノードを追加

.. 注::

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

    Parameters:

    dataBytes`` - バイト配列としてノード blob データをマップする。

AddSubGraph​

void AddSubGraph(byte[] dataBytes)

ローカライザーにグラフを追加

.. 注::

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

    Parameters:

    dataBytes`` - バイト配列としてブロブデータをグラフ化する。

GetMapNodeIds​

bool GetMapNodeIds(out TrackableId[] mapIds)

ネイティブ・マップ・ストレージ内の現在のマップ・ノードのリストを取得する。

.. 注::

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

    Parameters:

    mapIds`` - マップ ID の配列。

    戻り値

    生成されたIDがあれば真。 マップが生成されていない場合は False

GetSubGraphIds​

bool GetSubGraphIds(
		out TrackableId[] subgraphIds,
		OutputEdgeType outputEdgeType = OutputEdgeType.All
)

ネイティブ・マップ・ストレージ内の現在のマップ・ノードのリストを取得する。

.. 注::

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

    Parameters:

    subgraphIds - マップ ID の配列。

    outputEdgeType`` - 出力するエッジのタイプを指定する。

    戻り値

    生成されたIDがあれば真。 マップが生成されていない場合は False

GetMapNodes​

bool GetMapNodes(TrackableId[] mapIds, out MapNode[] maps)

生成された地図データを取得する

.. 注::

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

    Parameters:

    maps`` - マップデータの配列である。

    戻り値

    マップが生成された場合は真。 マップが生成されていない場合は False

GetSubGraphs​

bool GetSubGraphs(TrackableId[] subgraphIds, out MapSubGraph[] blobs)

マップノードのグラフデータを取得する

.. 注::

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

    Parameters:

    blobs - グラフの配列。

    戻り値

    グラフが生成されたら真。 これまでにグラフが生成されていない場合は偽

CreateAnchorFromMapNode​

bool CreateAnchorFromMapNode(
		MapNode map,
		Matrix4x4 pose,
		out byte[] anchorPayload
)

MapNodeからアンカーを（ペイロードとして）生成する。

.. 注::

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

    Parameters:

    map`` - マップノード、デバイスマップ

    pose`` - 作成するアンカーのローカルポーズ。

    anchorPayload`` - バイト配列のアンカーペイロード。

    戻り値

    名前空間Niantic.Lightship.AR.PersistentAnchorsでラップできるアンカーを表すバイト配列であれば真。

MergeSubGraphs​

bool MergeSubGraphs(
		MapSubGraph[] subgraphs,
		bool onlyKeepLatestEdges,
		out MapSubGraph mergedSubgraph
)

マップのサブグラフをマージする

.. 注::

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

    Parameters:

    subgraphs - 結合する部分グラフの配列。

    onlyKeepLatestEdges`` - true の場合、指定した2つのノード間の最新のエッジのみを保持する。

    mergedSubgraph`` - マージされたサブグラフを出力する。

    戻り値

    マージに成功すれば真

ExtractMapMetaData​

void ExtractMapMetaData(
		byte[] mapBlob,
		out Vector3[] points,
		out float[] errors,
		out Vector3 center,
		out string mapType
)

地図ブロブデータから地図メタデータを抽出する

    Parameters:

    mapBlob`` - blob データをバイト配列としてマップする。

    points`` - 地図の中心からの相対的な特徴点。

    エラー数 errors - 各ポイントのエラー数

    center`` - マッピング座標系におけるマップの中心。

    mapType`` - 地図データのタイプを示す。