Configurazione della fotocamera

ArCameraConfig descrive le proprietà del sensore della fotocamera sottostante, tra cui:

  • L'ID della videocamera
  • Se disponibile, se verrà utilizzato un sensore di profondità
  • La direzione in cui è rivolta la fotocamera:
    • frontale (selfie)
    • all'indietro (mondo)
  • Intervallo di FPS (frame al secondo)
  • Dimensioni immagine CPU
  • Dimensione texture GPU
  • Se presente, se verrà utilizzata la multicamera stereo del dispositivo

Quando crea una nuova sessione ARCore, ARCore utilizza ArSession_setCameraConfig() per impostare la configurazione della videocamera che meglio corrisponde all'elenco di configurazioni disponibili restituite da ArSession_getSupportedCameraConfigsWithFilter(). La tua app può utilizzare ArCameraConfigFilter per restringere le configurazioni della fotocamera disponibili per un determinato dispositivo in fase di runtime filtrando in base alle esigenze dell'app.

I casi d'uso comuni per l'applicazione di filtri includono:

  • Limitazione della frequenza fotogrammi dell'acquisizione della fotocamera a 30 f/s. Sui dispositivi che supportano la frequenza fotogrammi a 60 f/s, ARCore dà la priorità alle configurazioni delle videocamere che supportano quella frequenza fotogrammi. Per filtrare tutte le configurazioni della fotocamera che supportano 60 f/s, applica un filtro con ArCameraConfigFilter_setTargetFps() utilizzando AR_CAMERA_CONFIG_TARGET_FPS_30.

    // Return only camera configs that target 30 FPS camera capture frame
// rate.
ArCameraConfigFilter_setTargetFps(session, filter,
                                  AR_CAMERA_CONFIG_TARGET_FPS_30);

  • Impedire ad ARCore di utilizzare il sensore di profondità. Sui dispositivi che dispongono di un sensore di profondità supportato, ARCore dà la priorità alle configurazioni delle videocamere che utilizzano il sensore di profondità. Per filtrare tutte le configurazioni della fotocamera che utilizzano il sensore di profondità, applica il filtro ArCameraConfigFilter_setDepthSensorUsage() utilizzando AR_CAMERA_CONFIG_DEPTH_SENSOR_USAGE_DO_NOT_USE.

    ArCameraConfigFilter_setDepthSensorUsage(
    session, filter, AR_CAMERA_CONFIG_DEPTH_SENSOR_USAGE_DO_NOT_USE);

  • Seleziona una risoluzione alternativa della trama della GPU. Sui dispositivi supportati, ARCore può fornire risoluzioni aggiuntive delle texture GPU. La selezione di una texture GPU a risoluzione inferiore può aiutare a migliorare le prestazioni dell'app riducendo il carico della GPU e riducendo i requisiti di larghezza di banda della memoria, ma non è garantito che le prestazioni migliorino in tutti i casi.

Utilizzo dei filtri di configurazione della fotocamera

Segui questi passaggi per consentire alla tua app di filtrare le configurazioni della videocamera.

// Create an ARCore session.
ArSession* session;
ArSession_create(env, context, &session);

// Create a camera config list and filter for the session.
ArCameraConfig* selected_config;
ArCameraConfigList* configs;
ArCameraConfigFilter* filter;
ArCameraConfig_create(session, &selected_config);
ArCameraConfigList_create(session, &configs);
ArCameraConfigFilter_create(session, &filter);

// Return only camera configs that target 30 fps camera capture frame rate.
ArCameraConfigFilter_setTargetFps(session, filter,
                                  AR_CAMERA_CONFIG_TARGET_FPS_30);

// Return only camera configs that will not use the depth sensor.
ArCameraConfigFilter_setDepthSensorUsage(
    session, filter, AR_CAMERA_CONFIG_DEPTH_SENSOR_USAGE_DO_NOT_USE);

// Get list of configs that match filter settings.
// In this case, this list is guaranteed to contain at least one element,
// because both TargetFps.TARGET_FPS_30 and DepthSensorUsage.DO_NOT_USE
// are supported on all ARCore supported devices.
ArSession_getSupportedCameraConfigsWithFilter(session, filter, configs);

// Use element 0 from the list of returned camera configs. This is because
// it contains the camera config that best matches the specified filter
// settings.
ArCameraConfigList_getItem(session, configs, 0, selected_config);

// Set the camera config to use selected_config.
ArSession_setCameraConfig(session, selected_config);

// Free memory.
ArCameraConfigFilter_destroy(filter);
ArCameraConfigList_destroy(configs);

Niente distrazioni

Puoi anche impostare la modalità focus nella configurazione della sessione. La messa a fuoco fissa è in genere la migliore per il tracciamento (ed è l'impostazione predefinita di ARCore sulla maggior parte dei dispositivi). La messa a fuoco automatica è necessaria per la registrazione, la fotografia, la videografia e quando gli oggetti vicini devono essere a fuoco.

Per informazioni dettagliate, visita la pagina ArConfig_setFocusMode().