ArVpsAvailabilityFuture

An asynchronous operation checking VPS availability.

Summary

The availability of VPS in a given location helps to improve the quality of Geospatial localization and tracking accuracy. See ArSession_checkVpsAvailabilityAsync for more details.

Enumerations
`ArVpsAvailability{ AR_VPS_AVAILABILITY_UNKNOWN = 0, AR_VPS_AVAILABILITY_AVAILABLE = 1, AR_VPS_AVAILABILITY_UNAVAILABLE = 2, AR_VPS_AVAILABILITY_ERROR_INTERNAL = -1, AR_VPS_AVAILABILITY_ERROR_NETWORK_CONNECTION = -2, AR_VPS_AVAILABILITY_ERROR_NOT_AUTHORIZED = -3, AR_VPS_AVAILABILITY_ERROR_RESOURCE_EXHAUSTED = -4 }`	enum The result of `ArSession_checkVpsAvailabilityAsync`, obtained by `ArVpsAvailabilityFuture_getResult` or from an invocation of an `ArVpsAvailabilityCallback`.

Typedefs
`ArCheckVpsAvailabilityCallback`	typedef `ArVpsAvailabilityCallback` Deprecated. Deprecated in release 1.37.0. Use `ArVpsAvailabilityCallback` instead. Deprecated alias of `ArVpsAvailabilityCallback`.
`ArVpsAvailabilityCallback)(void *context, ArVpsAvailability availability)`	typedef `void(*` Callback definition for `ArSession_checkVpsAvailabilityAsync`.
`ArVpsAvailabilityFuture`	typedef `struct ArVpsAvailabilityFuture_` Handle to an asynchronous operation launched by `ArSession_checkVpsAvailabilityAsync`.

Functions
`ArVpsAvailabilityFuture_cancel(const ArSession session, ArVpsAvailabilityFuture future, int32_t *out_was_cancelled)`	`void` Tries to cancel execution of this operation.
`ArVpsAvailabilityFuture_getResult(const ArSession session, const ArVpsAvailabilityFuture future, ArVpsAvailability *out_result_availability)`	`void` Returns the result of an asynchronous operation.
`ArVpsAvailabilityFuture_getState(const ArSession session, const ArVpsAvailabilityFuture future, ArFutureState *out_state)`	`void` Gets the state of an asynchronous operation.
`ArVpsAvailabilityFuture_release(ArVpsAvailabilityFuture *future)`	`void` Releases a reference to a future.

Enumerations

ArVpsAvailability

 ArVpsAvailability

The result of ArSession_checkVpsAvailabilityAsync, obtained by ArVpsAvailabilityFuture_getResult or from an invocation of an ArVpsAvailabilityCallback.

Properties
`AR_VPS_AVAILABILITY_AVAILABLE`	VPS is available at the requested location.
`AR_VPS_AVAILABILITY_ERROR_INTERNAL`	An internal error occurred while determining availability.
`AR_VPS_AVAILABILITY_ERROR_NETWORK_CONNECTION`	The external service could not be reached due to a network connection error.
`AR_VPS_AVAILABILITY_ERROR_NOT_AUTHORIZED`	An authorization error occurred when communicating with the Google Cloud ARCore API. See Enable the Geospatial API for troubleshooting steps.
`AR_VPS_AVAILABILITY_ERROR_RESOURCE_EXHAUSTED`	Too many requests were sent.
`AR_VPS_AVAILABILITY_UNAVAILABLE`	VPS is not available at the requested location.
`AR_VPS_AVAILABILITY_UNKNOWN`	The request to the remote service is not yet completed, so the availability is not yet known.

Typedefs

ArCheckVpsAvailabilityCallback

ArVpsAvailabilityCallback ArCheckVpsAvailabilityCallback

Deprecated alias of ArVpsAvailabilityCallback.

Deprecated. Deprecated in release 1.37.0. Use ArVpsAvailabilityCallback instead.

ArVpsAvailabilityCallback

void(* ArVpsAvailabilityCallback)(void *context, ArVpsAvailability availability)

Callback definition for ArSession_checkVpsAvailabilityAsync.

The context argument will be the same as that passed to ArSession_checkVpsAvailabilityAsync. The availability argument will be the same as the result obtained from the future returned by ArSession_checkVpsAvailabilityAsync.

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

ArVpsAvailabilityFuture

struct ArVpsAvailabilityFuture_ ArVpsAvailabilityFuture

Handle to an asynchronous operation launched by ArSession_checkVpsAvailabilityAsync.

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

Functions

ArVpsAvailabilityFuture_cancel

void ArVpsAvailabilityFuture_cancel(
  const ArSession *session,
  ArVpsAvailabilityFuture *future,
  int32_t *out_was_cancelled
)

Tries to cancel execution of this operation.

out_was_cancelled will be set to 1 if the operation was cancelled by this invocation, and in that case it is a best practice to free context memory provided to ArSession_checkVpsAvailabilityAsync.

Details

Parameters

`session`	The ARCore session.
`future`	The handle for the asynchronous operation.
`out_was_cancelled`	Set to 1 if this invocation successfully cancelled the operation, 0 otherwise. This may be null.

ArVpsAvailabilityFuture_getResult

void ArVpsAvailabilityFuture_getResult(
  const ArSession *session,
  const ArVpsAvailabilityFuture *future,
  ArVpsAvailability *out_result_availability
)

Returns the result of an asynchronous operation.

The returned result is only valid when ArFuture_getState returns AR_FUTURE_STATE_DONE.

Details

Parameters

`session`	The ARCore session.
`future`	The handle for the asynchronous operation.
`out_result_availability`	The result of the operation, if the Future's state is `AR_FUTURE_STATE_DONE`.

ArVpsAvailabilityFuture_getState

void ArVpsAvailabilityFuture_getState(
  const ArSession *session,
  const ArVpsAvailabilityFuture *future,
  ArFutureState *out_state
)

Gets the state of an asynchronous operation.

Details

Parameters

`session`	The ARCore session.
`future`	The handle for the asynchronous operation.
`out_state`	The state of the operation.

ArVpsAvailabilityFuture_release

void ArVpsAvailabilityFuture_release(
  ArVpsAvailabilityFuture *future
)

Releases a reference to a future.

This does not mean that the operation will be terminated - see ArFuture_cancel.

This function may safely be called with NULL - it will do nothing.