Configurare una sessione ARCore in Android NDK

Configura una sessione ARCore per creare esperienze AR per la tua app.

Che cos'è una sessione?

Tutti i processi AR, come il rilevamento del movimento, la comprensione dell'ambiente e la stima dell'illuminazione, avvengono all'interno di una sessione ARCore. ArSession è il punto di ingresso principale all'API ARCore. Gestisce lo stato del sistema AR e ne gestisce il ciclo di vita, consentendo all'app di creare, configurare, avviare o interrompere una sessione. Soprattutto, consente all'app di ricevere frame che permettono di accedere all'immagine della fotocamera e alla posa del dispositivo.

La sessione può essere utilizzata per configurare le seguenti funzionalità:

Verifica che ARCore sia installato e aggiornato

Prima di creare una ArSession, verifica che ARCore sia installato e aggiornato. Se ARCore non è installato, la creazione della sessione non va a buon fine e qualsiasi installazione o upgrade successivo di ARCore richiede il riavvio dell'app.

/*
 * Check if ARCore is currently usable, i.e. whether ARCore is supported and
 * up to date.
 */
int32_t is_arcore_supported_and_up_to_date(void* env, void* context) {
  ArAvailability availability;
  ArCoreApk_checkAvailability(env, context, &availability);
  switch (availability) {
    case AR_AVAILABILITY_SUPPORTED_INSTALLED:
      return true;
    case AR_AVAILABILITY_SUPPORTED_APK_TOO_OLD:
    case AR_AVAILABILITY_SUPPORTED_NOT_INSTALLED: {
      ArInstallStatus install_status;
      // ArCoreApk_requestInstall is processed asynchronously.
      CHECK(ArCoreApk_requestInstall(env, context, true, &install_status) ==
            AR_SUCCESS);
      return false;
    }
    case AR_AVAILABILITY_UNSUPPORTED_DEVICE_NOT_CAPABLE:
      // This device is not supported for AR.
      return false;
    case AR_AVAILABILITY_UNKNOWN_CHECKING:
      // ARCore is checking the availability with a remote query.
      // This function should be called again after waiting 200 ms
      // to determine the query result.
      handle_check_later();
      return false;
    case AR_AVAILABILITY_UNKNOWN_ERROR:
    case AR_AVAILABILITY_UNKNOWN_TIMED_OUT:
      // There was an error checking for AR availability.
      // This may be due to the device being offline.
      // Handle the error appropriately.
      handle_unknown_error();
      return false;

    default:  // All enum cases have been handled.
      return false;
  }
}

Crea una sessione

Crea e configura una sessione in ARCore.

// Create a new ARCore session.
ArSession* ar_session = NULL;
CHECK(ArSession_create(env, context, &ar_session) == AR_SUCCESS);

// Create a session config.
ArConfig* ar_config = NULL;
ArConfig_create(ar_session, &ar_config);

// Do feature-specific operations here, such as enabling depth or turning on
// support for Augmented Faces.

// Configure the session.
CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS);

Chiudere una sessione

ArSession possiede una quantità significativa di memoria heap nativa. La mancata chiusura esplicita della sessione può causare l'esaurimento della memoria nativa e un arresto anomalo dell'app. Quando la sessione AR non è più necessaria, chiama ArSession_destroy() per svincolare le risorse.

// Release memory used by the AR session.
ArSession_destroy(session);

Passaggi successivi