クラス 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`` - 地図データのタイプを示す。