ArResolveCloudAnchorFuture

An asynchronous operation for resolving a Cloud Anchor launched by ArSession_resolveCloudAnchorAsync.

See the Cloud Anchors developer guide for more information.

Summary

Typedefs
`ArResolveCloudAnchorCallback)(void context, ArAnchor anchor, ArCloudAnchorState cloud_anchor_state)`	typedef `void(*` Callback definition for `ArSession_resolveCloudAnchorAsync`.
`ArResolveCloudAnchorFuture`	typedef `struct ArResolveCloudAnchorFuture_` Handle to an asynchronous operation launched by `ArSession_resolveCloudAnchorAsync`.

Functions
`ArResolveCloudAnchorFuture_acquireResultAnchor(const ArSession session, const ArResolveCloudAnchorFuture future, ArAnchor **out_anchor)`	`void` Gets the resolved Cloud Anchor.
`ArResolveCloudAnchorFuture_getResultCloudAnchorState(const ArSession session, const ArResolveCloudAnchorFuture future, ArCloudAnchorState *out_cloud_anchor_state)`	`void` Gets the result status of the resolving operation, if the operation is done.

Typedefs

ArResolveCloudAnchorCallback

void(* ArResolveCloudAnchorCallback)(void *context, ArAnchor *anchor, ArCloudAnchorState cloud_anchor_state)

Callback definition for ArSession_resolveCloudAnchorAsync.

The context argument will be the same as that passed to ArSession_resolveCloudAnchorAsync. The anchor argument will be the same as that returned by ArResolveCloudAnchorFuture_acquireResultAnchor and must be released using ArAnchor_release. The cloud_anchor_state argument will be the same as that returned by ArResolveCloudAnchorFuture_getResultCloudAnchorState.

It is a best practice to free context memory provided to ArSession_resolveCloudAnchorAsync at the end of the callback implementation.

ArResolveCloudAnchorFuture

struct ArResolveCloudAnchorFuture_ ArResolveCloudAnchorFuture

Handle to an asynchronous operation launched by ArSession_resolveCloudAnchorAsync.

Release with ArFuture_release. (reference type, long-lived).

Functions

ArResolveCloudAnchorFuture_acquireResultAnchor

void ArResolveCloudAnchorFuture_acquireResultAnchor(
  const ArSession *session,
  const ArResolveCloudAnchorFuture *future,
  ArAnchor **out_anchor
)

Gets the resolved Cloud Anchor.

If the operation isn't done yet or the operation failed, this will be NULL. The caller must release the anchor using ArAnchor_release.

Details

Parameters

`session`	The ARCore session.
`future`	The handle for the asynchronous operation.
`out_anchor`	The anchor.

ArResolveCloudAnchorFuture_getResultCloudAnchorState

void ArResolveCloudAnchorFuture_getResultCloudAnchorState(
  const ArSession *session,
  const ArResolveCloudAnchorFuture *future,
  ArCloudAnchorState *out_cloud_anchor_state
)

Gets the result status of the resolving operation, if the operation is done.

Details

Parameters

`session`	The ARCore session.
`future`	The handle for the asynchronous operation.
`out_cloud_anchor_state`	The result status.