Skip to main content
←API Reference ←NSDK ←NSDKVps2Session

createAnchor


Declaration​

func createAnchor(at pose: simd_float4x4) throws -> NSDKVpsAnchorId

Summary​

Requests to create an anchor at the specified pose.
Creates an anchor relative to the currently tracked location, and begins tracking (no
need to call trackAnchor(payload:)). The payload for the new anchor will not be
available immediately — the session polls for it each frame and fires
createdAnchorPayload once it becomes ready.
Anchors mark a place in the world that content should stay attached to. VPS2 must
localize to a map before anchors can be created for it: use localize(siteId:) or
localize(latitude:longitude:radiusMeters:). An anchor created here will only track
with the asset of the site that was active at the time of its creation.

Returns​

A unique identifier for the created anchor.

Throws​

  • NSDKError.invalidOperation if the localization is not in .precise state.
Notice

Attention: Anchors can only be created when the current localization's tracking state is .precise. Use $latestLocalization to observe tracking state.

Parameters​

NameTypeSummary
posesimd_float4x4
The 4x4 transformation matrix representing the anchor's position and
orientation in ARKit space.