Mengonfigurasi kamera

CameraConfig mendeskripsikan properti sensor kamera yang mendasarinya, termasuk:

ID kamera
Jika tersedia, apakah sensor kedalaman akan digunakan atau tidak
Arah menghadap kamera:
- menghadap ke depan (selfie)
- menghadap ke belakang (dunia)
Rentang FPS (frame per detik)
Dimensi image CPU
Dimensi tekstur GPU
Jika ada, apakah multi-kamera stereo perangkat akan digunakan atau tidak

Saat membuat sesi ARCore baru, ARCore menggunakan setCameraConfig untuk menetapkan konfigurasi kamera yang paling cocok dengan daftar konfigurasi yang tersedia yang ditampilkan oleh getSupportedCameraConfigs(CameraConfigFilter). Aplikasi Anda dapat menggunakan CameraConfigFilter untuk mempersempit konfigurasi kamera yang tersedia untuk perangkat tertentu pada saat {i>runtime<i} dengan pemfilteran berdasarkan kebutuhan aplikasi Anda.

Kasus penggunaan umum pemfilteran mencakup:

Membatasi kecepatan frame pengambilan gambar kamera hingga 30 fps. Pada perangkat yang mendukung 60 fps, ARCore akan memprioritaskan konfigurasi kamera yang mendukung kecepatan frame. Untuk memfilter semua konfigurasi kamera yang mendukung 60 fps, menerapkan filter dengan setTargetFps menggunakan TargetFps.TARGET_FPS_30.
Java
```
// Return only camera configs that target 30 FPS camera capture frame rate.
filter.setTargetFps(EnumSet.of(CameraConfig.TargetFps.TARGET_FPS_30));
```
Kotlin
```
// Return only camera configs that target 30 FPS camera capture frame rate.
filter.targetFps = EnumSet.of(CameraConfig.TargetFps.TARGET_FPS_30)
```
Cegah ARCore menggunakan sensor kedalaman. Pada perangkat yang memiliki sensor kedalaman yang didukung, ARCore memprioritaskan konfigurasi kamera yang menggunakan kedalaman sensor. Untuk memfilter semua konfigurasi kamera yang menggunakan sensor kedalaman, terapkan metode setDepthSensorUsage filter menggunakan DepthSensorUsage.DO_NOT_USE.
Java
```
// Return only camera configs that will not use the depth sensor.
filter.setDepthSensorUsage(EnumSet.of(CameraConfig.DepthSensorUsage.DO_NOT_USE));
```
Kotlin
```
// Return only camera configs that will not use the depth sensor.
filter.depthSensorUsage = EnumSet.of(CameraConfig.DepthSensorUsage.DO_NOT_USE)
```
Memilih resolusi tekstur GPU alternatif. Aktif perangkat yang didukung, ARCore dapat menyediakan resolusi tekstur GPU tambahan. Memilih tekstur GPU resolusi lebih rendah dapat membantu meningkatkan performa aplikasi dengan mengurangi beban GPU dan menurunkan memori persyaratan bandwidth, meskipun tidak dijamin akan meningkatkan untuk semua kasus.

Menggunakan filter konfigurasi kamera

Ikuti langkah-langkah ini untuk mengaktifkan aplikasi Anda guna memfilter konfigurasi kamera.

Java

// Create a camera config filter for the session.
CameraConfigFilter filter = new CameraConfigFilter(session);

// Return only camera configs that target 30 fps camera capture frame rate.
filter.setTargetFps(EnumSet.of(CameraConfig.TargetFps.TARGET_FPS_30));

// Return only camera configs that will not use the depth sensor.
filter.setDepthSensorUsage(EnumSet.of(CameraConfig.DepthSensorUsage.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.
List<CameraConfig> cameraConfigList = session.getSupportedCameraConfigs(filter);

// 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.
session.setCameraConfig(cameraConfigList.get(0));

Kotlin

// Create a camera config filter for the session.
val filter = CameraConfigFilter(session)

// Return only camera configs that target 30 fps camera capture frame rate.
filter.targetFps = EnumSet.of(CameraConfig.TargetFps.TARGET_FPS_30)

// Return only camera configs that will not use the depth sensor.
filter.depthSensorUsage = EnumSet.of(CameraConfig.DepthSensorUsage.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.
val cameraConfigList = session.getSupportedCameraConfigs(filter)

// 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.
session.cameraConfig = cameraConfigList[0]

Mode fokus

Anda juga dapat menetapkan mode fokus dalam konfigurasi sesi. Fokus tetap umumnya lebih baik untuk pelacakan (dan merupakan setelan default ARCore di sebagian besar perangkat). Fokus otomatis diperlukan untuk perekaman, fotografi, videografi, dan saat objek di sekitar perlu menjadi fokus.

Lihat Config.FocusMode untuk mengetahui detailnya.