jendela bidik kamera

Tabel ini mencantumkan semua artefak dalam grup androidx.camera-viewfinder.

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada camera-viewfinder, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

dependencies {
    // Use to implement camera viewfinders
    
    implementation "androidx.camera.viewfinder:viewfinder-view:1.5.0-beta03"
    implementation "androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta03"
    implementation "androidx.camera.viewfinder:viewfinder-core:1.5.0-beta03"

}

dependencies {
    // Use to implement camera viewfinders
    implementation("androidx.camera.viewfinder:viewfinder-view:1.5.0-beta03")
    implementation("androidx.camera.viewfinder:viewfinder-core:1.5.0-beta03")
    implementation("androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta03")


}

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Versi 1.5

Versi 1.5.0-beta03

16 Juli 2025

androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta03, androidx.camera.viewfinder:viewfinder-core:1.5.0-beta03, dan androidx.camera.viewfinder:viewfinder-view:1.5.0-beta03 dirilis. Versi 1.5.0-beta03 berisi commit ini.

Perbaikan Bug

• ImplementationMode default untuk Viewfinder (berbasis Compose dan View) kini secara cerdas memilih antara EXTERNAL (untuk performa) dan EMBEDDED (untuk kompatibilitas pada API lama/perangkat yang tidak biasa). Perilaku ini masih dapat diganti dengan setelan eksplisit di ViewfinderSurfaceRequest atau atribut XML (di API berbasis View). (Iecd3a)
• Meningkatkan pengelolaan sesi Surface dengan memungkinkan ViewfinderSurfaceSession tetap aktif di seluruh siklus proses pembuatan/penghancuran permukaan saat menggunakan TextureView atau SurfaceView di API 29+. (I112d9)
• Viewfinder kini memastikan Surface dilepaskan pada waktu yang tepat, hanya saat tidak lagi digunakan oleh sesi, bukan selalu dilepaskan saat Composable dibuang. Untuk EXTERNAL (SurfaceView), perilaku ini saat ini hanya tersedia di API 29+. Untuk EMBEDDED (TextureView), perilaku ini ada di semua level API. (I9a03f)
• Viewfinder kini menangani penggantian permukaan dengan benar dalam skenario seperti saat jendela bidik EXTERNAL di API level 28 atau yang lebih rendah berpindah dari layar atau jika Viewfinder (dengan ImplementationMode apa pun) adalah bagian dari moveableContentOf(). (I79432)
• Composable Viewfinder kini berfungsi dengan benar dengan Pager Compose. Perubahan ini memastikan Composable dapat direset dengan berhasil dengan menerapkan callback onReset dari AndroidView, yang mendukung penerapan EMBEDDED dan EXTERNAL. (I0d9be)
• Memperbaiki masalah di Android 10/11 saat EXTERNAL Viewfinder dapat tampak meregang atau salah karena operasi transformasi (seperti penskalaan atau terjemahan) diterapkan terlalu awal. Sistem kini menunggu Surface dibuat sebelum menerapkan transformasi ini dalam fase tata letak, sehingga memastikan output yang benar. (Icc77c)

Versi 1.5.0-beta02

4 Juni 2025

androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta02, androidx.camera.viewfinder:viewfinder-core:1.5.0-beta02, dan androidx.camera.viewfinder:viewfinder-view:1.5.0-beta02 dirilis. Versi 1.5.0-beta02 berisi commit ini.

Versi 1.5.0-beta01

7 Mei 2025

androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta01, androidx.camera.viewfinder:viewfinder-core:1.5.0-beta01, dan androidx.camera.viewfinder:viewfinder-view:1.5.0-beta01 dirilis. Versi 1.5.0-beta01 berisi commit ini.

• Ini adalah rilis beta resmi pertama jendela bidik berbasis tampilan dan berbasis Compose yang cukup fleksibel untuk digunakan dengan Camera2. Jika Anda mencari View atau composable untuk digunakan dengan CameraX, lihat PreviewView dan CameraXViewfinder.

Fitur Baru

• ContentScale dan Alignment kini dapat digunakan di jendela bidik berbasis compose untuk menskalakan dan menempatkan permukaan yang ditampilkan dalam penampungnya, mirip dengan cara kerja androidx.compose.foundation.Image. (Ibcea3)

Perubahan API

• TransformationInfo kini memiliki nilai default untuk semua argumen. Hal ini akan memungkinkan Viewfinder dibuat tanpa TransformationInfo, yang secara default akan menggunakan rotasi sumber 0, tanpa pencerminan sumber, dan tanpa persegi panjang pangkas. (I2b1b2)
• Composable Viewfinder kini menggunakan lambda akhir untuk menerima sesi Surface, mirip dengan AndroidExternalSurface. Lambda yang disediakan menggunakan ViewfinderInitScope sebagai penerima, yang memungkinkan penginstalan callback untuk menerima sesi Surface baru. Sesi permukaan ini secara otomatis melepaskan resource yang dipegang oleh Viewfinder saat keluar dari cakupan. (Ib2b0d)
• ViewfinderSurfaceRequest.Builder.populateFromCharacteristics kini telah dihapus dan diganti dengan serangkaian API statis yang setara yang dapat digunakan untuk menghasilkan TransformationInfo yang akan menghasilkan transformasi yang sama dengan populateFromCharacteristics. Metode statis ini ditambahkan ke class Camera2TransformationInfo. (Idc6af)
• ViewfinderSurfaceRequest tidak lagi menyertakan API asinkron untuk mengambil permukaan. Sekarang menjadi jenis data yang tidak dapat diubah. API untuk mengambil Surface kini dipindahkan ke jendela bidik. (I30127)
• CameraViewfinder telah diganti namanya menjadi ViewfinderView agar penamaannya selaras dengan penamaan composable Jendela Bidik dan untuk menunjukkan bahwa composable ini dapat digunakan dengan lebih dari sekadar sumber kamera. (Id9e6b)
• Class dari viewfinder-view telah dipindahkan ke subpaket androidx.camera.viewfinder.view dari paket androidx.camera.viewfinder. (I6cb44)
• API baru ditambahkan ke Viewfinder berbasis tampilan yang memungkinkan setelan rotasi sumber, pencerminan, dan persegi panjang pangkas. Class TransformationInfo ini sama dengan class yang digunakan oleh Viewfinder berbasis compose. (I907c3)
• Viewfinder berbasis tampilan kini menggunakan API ViewfinderSurfaceRequest baru yang tidak lagi menangani respons Surface secara internal. Daripada menampilkan ListenableFuture<Surface>, API requestSurfaceSession() kini menampilkan ListenableFuture<ViewfinderSurfaceSession> yang menampilkan class AutoCloseable yang saat ditutup berperilaku sama seperti memanggil API lama ViewfinderSurfaceRequest.markSurfaceSafeToRelease(). Hal ini memberikan pemisahan tanggung jawab yang lebih jelas antara permintaan platform dan respons platform. (I19041)

Versi 1.4

Versi 1.4.0-alpha13

26 Februari 2025

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha13, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha13, dan androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha13 dirilis. Versi 1.4.0-alpha13 berisi commit ini.

Versi 1.4.0-alpha12

15 Januari 2025

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha12, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha12, dan androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha12 dirilis. Versi 1.4.0-alpha12 berisi commit ini.

Fitur Baru

• Mengupgrade compileSdk sebagai 35 untuk menggunakan API terkait Android 15. Aplikasi yang menggunakan library CameraX juga perlu mengupgrade setelan konfigurasi compileSdk. (Ic80cd)
• Library ini kini menggunakan anotasi nullability JSpecify, yang merupakan penggunaan jenis. Developer Kotlin harus menggunakan argumen compiler berikut untuk menerapkan penggunaan yang benar: -Xjspecify-annotations=strict (ini adalah nilai default yang dimulai dengan compiler Kotlin versi 2.1.0). (I7bcd7, b/326456246)

Versi 1.4.0-alpha11

11 Desember 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha11, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha11, dan androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha11 dirilis. Versi 1.4.0-alpha11 berisi commit ini.

Perubahan API

• Class viewfinder-core telah dipindahkan ke dalam paket yang konsisten dengan library tempat class tersebut berada. (I431c6)
• CameraViewfinder.ScaleType telah dipindahkan ke viewfinder-core sehingga dapat digunakan kembali dengan Compose (I87ef1)
• Class CameraViewfinder yang tidak digunakan lagi akan dihapus. Gunakan API baru yang menyediakan fungsi yang setara. (I6e59a)

Versi 1.4.0-alpha10

30 Oktober 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10, dan androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10 dirilis. Versi 1.4.0-alpha10 berisi commit ini.

Versi 1.4.0-alpha09

2 Oktober 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha09, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha09, dan androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha09 dirilis. Versi 1.4.0-alpha09 berisi commit ini.

Versi 1.4.0-alpha08

4 September 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha08, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha08, dan androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha08 dirilis. Versi 1.4.0-alpha08 berisi commit ini.

Fitur Baru

Dengan update ke 1.4.0-alpha08, artefak Viewfinder CameraX telah dipindahkan ke grup library-nya sendiri. Perubahan ini diperlukan untuk meningkatkan modularitas dan kemudahan pemeliharaan library CameraX.

Jika sebelumnya Anda bergantung pada androidx.camera:camera-viewfinder, androidx.camera:camera-viewfinder-compose, atau androidx.camera:camera-viewfinder-core, Anda harus mengalihkan dependensi ke berikut ini:

• androidx.camera:camera-viewfinder -> androidx.camera.viewfinder:viewfinder-view
• androidx.camera:camera-viewfinder-compose -> androidx.camera.viewfinder:viewfinder-compose
• androidx.camera:camera-viewfinder-core -> androidx.camera.viewfinder:viewfinder-core

Anda tidak perlu mengubah kode untuk melakukan transisi ini. Koordinat Maven Viewfinder lama tidak akan lagi menerima update.

Selain itu, jika Anda menggunakan Compose dengan CameraX, library baru yang mengutamakan Compose kini tersedia dalam versi alfa: androidx.camera:camera-compose. Hal ini menyediakan composable CameraXViewfinder, yang merupakan Jendela Bidik idiomatis Compose yang mengadaptasi SurfaceRequest CameraX ke Compose, mirip dengan cara kerja PreviewView untuk tampilan.