ArHostCloudAnchorFuture

An asynchronous operation for hosting a Cloud Anchor launched by ArSession_hostCloudAnchorAsync.

See the Cloud Anchors developer guide for more information.

Summary

Typedefs
`ArHostCloudAnchorCallback)(void context, char cloud_anchor_id, ArCloudAnchorState cloud_anchor_state)`	typedef `void(*` Callback definition for `ArSession_hostCloudAnchorAsync`.
`ArHostCloudAnchorFuture`	typedef `struct ArHostCloudAnchorFuture_` Handle to an asynchronous operation launched by `ArSession_hostCloudAnchorAsync`.

Functions
`ArHostCloudAnchorFuture_acquireResultCloudAnchorId(const ArSession session, const ArHostCloudAnchorFuture future, char **out_cloud_anchor_id)`	`void` Gets the Cloud Anchor ID of the hosted anchor.
`ArHostCloudAnchorFuture_getResultCloudAnchorState(const ArSession session, const ArHostCloudAnchorFuture future, ArCloudAnchorState *out_cloud_anchor_state)`	`void` Gets the result status of the hosting operation, if the operation is done.

Typedefs

ArHostCloudAnchorCallback

void(* ArHostCloudAnchorCallback)(void *context, char *cloud_anchor_id, ArCloudAnchorState cloud_anchor_state)

Callback definition for ArSession_hostCloudAnchorAsync.

The context argument will be the same as that passed to ArSession_hostCloudAnchorAsync. The cloud_anchor_id argument will contain the same value as that returned by ArHostCloudAnchorFuture_acquireResultCloudAnchorId and must be released using ArString_release. The cloud_anchor_state argument will be the same as that returned by ArHostCloudAnchorFuture_getResultCloudAnchorState.

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

ArHostCloudAnchorFuture

struct ArHostCloudAnchorFuture_ ArHostCloudAnchorFuture

Handle to an asynchronous operation launched by ArSession_hostCloudAnchorAsync.

See the Cloud Anchors developer guide for more information.

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

Functions

ArHostCloudAnchorFuture_acquireResultCloudAnchorId

void ArHostCloudAnchorFuture_acquireResultCloudAnchorId(
  const ArSession *session,
  const ArHostCloudAnchorFuture *future,
  char **out_cloud_anchor_id
)

Gets the Cloud Anchor ID of the hosted anchor.

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

Details

Parameters

`session`	The ARCore session.
`future`	The handle for the asynchronous operation.
`out_cloud_anchor_id`	The Cloud Anchor ID.

ArHostCloudAnchorFuture_getResultCloudAnchorState

void ArHostCloudAnchorFuture_getResultCloudAnchorState(
  const ArSession *session,
  const ArHostCloudAnchorFuture *future,
  ArCloudAnchorState *out_cloud_anchor_state
)

Gets the result status of the hosting 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.