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.