class DeviceMapAccessController

(Niantic.Lightship.AR.Mapping.DeviceMapAccessController)

概要

デバイスマップの基本データと設定にアクセスするためのクラス。

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

		// メソッド
	
		void ClearDeviceMap();
		void StartUploadingMaps();
		void StopUploadingMaps();
		void StartDownloadingMaps();
		void StopDownloadingMaps();
		void StartGettingGraphData();
		void StopGettingGraphData();
		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
		);
	};

詳細なドキュメント

デバイスマップの基本データと設定にアクセスするためのクラス。

.. 注::

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

プロパティ

OutputEdgeType

OutputEdgeType OutputEdgeType

GetSubGraphs()によって出力されるエッジの種類を指定します。設定すると、即座に適用されます。

.. 注::

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

メソッド

ClearDeviceMap

void ClearDeviceMap()

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

.. 注::

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

StartUploadingMaps

void StartUploadingMaps()

この呼び出しによって生成された新しいマップのアップロードを開始します。

.. 注::

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

StopUploadingMaps

void StopUploadingMaps()

マップのアップロードを停止します。

.. 注::

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

StartDownloadingMaps

void StartDownloadingMaps()

ローカライズを行うために、周辺のマップのダウンロードを開始します。

.. 注::

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

StopDownloadingMaps

void StopDownloadingMaps()

マップのダウンロードを停止します。

.. 注::

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

StartGettingGraphData

void StartGettingGraphData()

クラウドグラフ取得開始

.. 注::

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

StopGettingGraphData

void StopGettingGraphData()

クラウドグラフの取得停止

.. 注::

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

MarkMapNodeForUpload

bool MarkMapNodeForUpload(TrackableId mapId)

アップロード対象としてマップノードにマークを付けます。 アップロードは、StartUploadingMapsによって開始されます。 処理が途中で失敗した場合は、falseを返します。

.. 注::

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

HasMapNodeBeenUploaded

bool HasMapNodeBeenUploaded(TrackableId mapId)

マップノードがアップロードされたかどうかを確認します。

.. 注::

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

AddMapNode

void AddMapNode(byte[] dataBytes)

ローカライザーにマップノードのデータを追加します。

.. 注::

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

    パラメーター:

    dataBytes - マップノードのブロブデータ（バイト配列）

AddSubGraph

void AddSubGraph(byte[] dataBytes)

ローカライザーにグラフのデータを追加します。

.. 注::

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

    パラメーター:

    dataBytes - グラフのブロブデータ（バイト配列）

GetMapNodeIds

bool GetMapNodeIds(out TrackableId[] mapIds)

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

.. 注::

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

    パラメーター:

    mapIds - マップIDの配列。

    戻り値:

     これまでにマップIDが生成されている場合はTrue、 生成されていない場合はFalseを返します。

GetSubGraphIds

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

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

.. 注::

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

    パラメーター:

    subgraphIds - サブグラフIDの配列。

    outputEdgeType - 出力されるエッジの種類を指定します。

    戻り値:

     これまでにマップIDが生成されている場合はTrue、 生成されていない場合はFalseを返します。

GetMapNodes

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

生成されたマップノードを取得します。

.. 注::

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

    パラメーター:

    maps - マップデータの配列。

    戻り値:

     これまでにマップが生成されている場合はTrueを返します。 生成されていない場合はFalseを返します。

GetSubGraphs

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

マップノードに関連するグラフデータを取得します。

.. 注::

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

    パラメーター:

    blobs - グラフの配列。

    戻り値:

     これまでにグラフが生成されている場合はTrue、 生成されていない場合はFalseを返します。

CreateAnchorFromMapNode

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

MapNodeからアンカーを生成し、ペイロードとして出力します。

.. 注::

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

    パラメーター:

    map - マップノード（デバイスマップ内）

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

    anchorPayload - アンカーペイロード（バイト配列）

    戻り値:

     アンカーを表すバイト配列が、名前空間 Niantic.Lightship.AR.PersistentAnchorsでラップ可能な場合はTrueを返します。

MergeSubGraphs

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

マップサブグラフを統合します。

.. 注::

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

    パラメーター:

    subgraphs - 統合するサブグラフの配列。

    onlyKeepLatestEdges - Trueの場合は、指定された2つのノード間の最新のエッジのみを保持します。

    mergedSubgraph - 統合されたサブグラフを出力します。

    戻り値:

     統合に成功した場合はTrueを返します。

ExtractMapMetaData

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

マップのブロブデータからメタデータを抽出します。

    パラメーター:

    mapBlob - マップのブロブデータ（バイト配列）

    points - マップ中心を基準とした特徴点

    errors - 各点の誤差

    center - マッピング座標系における中心点

    mapType - マップデータの種類を示す