Configurazione della fotocamera

ArCameraConfig descrive le proprietà dell'elemento sensore sottostante della fotocamera, tra cui:

  • ID fotocamera
  • Se disponibile, indica se verrà utilizzato un sensore di profondità
  • La direzione in cui è rivolta la fotocamera:
    • davanti (selfie)
    • rivolto all'indietro (mondo)
  • Intervallo f/s (frame al secondo)
  • Dimensioni immagine CPU
  • Dimensione texture GPU
  • Se presente, indica se verrà utilizzata la fotocamera stereo del dispositivo

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

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

  • Limitare la frequenza fotogrammi di acquisizione della fotocamera a 30 f/s. Sui dispositivi che supportano 60 f/s, ARCore darà la priorità alle configurazioni della fotocamera che supportano frequenza fotogrammi. Per filtrare tutte le configurazioni della fotocamera che supportano 60 f/s: applicare 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);

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

    ArCameraConfigFilter_setDepthSensorUsage(
    session, filter, AR_CAMERA_CONFIG_DEPTH_SENSOR_USAGE_DO_NOT_USE);

  • Selezione di una risoluzione di texture GPU alternativa. Attivato dispositivi supportati, ARCore potrebbe fornire risoluzioni di texture GPU aggiuntive. Selezione di una texture GPU a risoluzione più bassa può contribuire a migliorare le prestazioni dell'app riducendo il carico della GPU e riducendo la memoria requisiti di larghezza di banda, anche se non è garantito il miglioramento delle prestazioni per tutti i casi.

Utilizzare i filtri di configurazione della videocamera

Segui questi passaggi per consentire all'app di filtrare le configurazioni delle videocamere.

// 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. Lo stato attivo fisso è generalmente migliore per il monitoraggio (ed è l'impostazione predefinita di ARCore sulla maggior parte dei dispositivi). La messa a fuoco automatica è necessaria per le registrazioni, le foto, le riprese video e quando è necessario installare oggetti vicini per mettere a fuoco.

Consulta ArConfig_setFocusMode() per maggiori dettagli.