kamera vizörü

Bu tabloda, androidx.camera-viewfinder grubundaki tüm yapı taşları listelenir.

Bağımlılıkları beyan etme

camera-viewfinder bağımlılığı eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu inceleyin.

Uygulamanızın veya modülünüzün build.gradle dosyasına ihtiyacınız olan yapıların bağımlılıklarını ekleyin:

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

}

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


}

Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.

Geri bildirim

Geri bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa lütfen bize bildirin. Yeni bir kitaplık oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oy verebilirsiniz.

Yeni bir sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerine bakın.

Sürüm 1.5

Sürüm 1.5.0-beta01

7 Mayıs 2025

androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta01, androidx.camera.viewfinder:viewfinder-core:1.5.0-beta01 ve androidx.camera.viewfinder:viewfinder-view:1.5.0-beta01 yayınlandı. 1.5.0-beta01 sürümü bu taahhütleri içerir.

• Bu, Camera2 ile kullanılabilecek kadar esnek olan görünüme dayalı ve kompozisyona dayalı vizörlerin ilk resmi beta sürümüdür. CameraX ile kullanılacak bir görünüm veya kompozisyon arıyorsanız PreviewView ve CameraXViewfinder bölümlerine bakın.

Yeni Özellikler

• ContentScale ve Alignment artık, androidx.compose.foundation.Image'in davranışına benzer şekilde, görüntülenen yüzeyi ölçeklendirmek ve kapsayıcısının içine yerleştirmek için oluşturmaya dayalı vizörde kullanılabilir. (Ibcea3)

API Değişiklikleri

• TransformationInfo artık tüm args için varsayılan değerlere sahip. Bu sayede, TransformationInfo olmadan vizörler oluşturulabilir. Bu durumda, varsayılan olarak kaynak rotasyonu 0 olur, kaynak yansıtılmaz ve kırpma dikdörtgeni olmaz. (I2b1b2)
• Composable Viewfinder, artık AndroidExternalSurface'e benzer şekilde bir Surface oturumu almak için sona gelen bir lambda alıyor. Sağlanan lambda, alıcı olarak ViewfinderInitScope kullanır. Bu, yeni Surface oturumlarını almak için geri çağırma işlevi yüklemenize olanak tanır. Bu yüzey oturumları, kapsamın dışına çıktıklarında Vizör tarafından tutulan kaynakları otomatik olarak serbest bırakır. (Ib2b0d)
• ViewfinderSurfaceRequest.Builder.populateFromCharacteristics kaldırıldı ve populateFromCharacteristics ile aynı dönüşümü sağlayacak TransformationInfo oluşturmak için kullanılabilecek eşdeğer bir statik API grubuyla değiştirildi. Bu statik yöntemler Camera2TransformationInfo sınıfına eklenir. (Idc6af)
• ViewfinderSurfaceRequest artık yüzeyi almak için eşzamansız API'leri içermiyor. Artık değişmez bir veri türüdür. Yüzeyi alma API'leri artık vizöre taşındı. (I30127)
• CameraViewfinder, adlandırmanın Vizör bileşiğinin adlandırmasıyla uyumlu olması ve yalnızca kamera kaynaklarından daha fazlasıyla kullanılabileceğini belirtmek için ViewfinderView olarak yeniden adlandırıldı. (Id9e6b)
• viewfinder-view sınıfları, androidx.camera.viewfinder paketinden androidx.camera.viewfinder.view alt paketine taşındı. (I6cb44)
• Görüntülemeye dayalı Vizör'e, kaynak döndürme, yansıtma ve kırpma dikdörtgenini ayarlamanıza olanak tanıyan yeni API'ler eklendi. Bu TransformationInfo sınıfı, oluşturmaya dayalı Vizör tarafından kullanılan sınıfla aynıdır. (I907c3)
• Görüntü tabanlı Vizör artık Surface yanıtını dahili olarak işlemeyen yeni ViewfinderSurfaceRequest API'leri kullanıyor. requestSurfaceSession() API'leri artık ListenableFuture<Surface> yerine ListenableFuture<ViewfinderSurfaceSession> döndürüyor. ListenableFuture<ViewfinderSurfaceSession>, kapatıldığında ViewfinderSurfaceRequest.markSurfaceSafeToRelease() API'sinin eski sürümünü çağırırken olduğu gibi davranan bir AutoCloseable sınıfı döndürür. Bu sayede, yüzey isteği ile yüzey yanıtı arasındaki sorumluluklar daha net bir şekilde ayrılır. (I19041)

Sürüm 1.4

Sürüm 1.4.0-alpha13

26 Şubat 2025

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha13, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha13 ve androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha13 yayınlandı. 1.4.0-alpha13 sürümü bu taahhütleri içerir.

Sürüm 1.4.0-alpha12

15 Ocak 2025

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha12, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha12 ve androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha12 yayınlandı. 1.4.0-alpha12 sürümü bu taahhütleri içerir.

Yeni Özellikler

• Android 15 ile ilgili API'yi kullanmak için compileSdk 35 olarak yükseltildi. CameraX kitaplıklarını kullanan uygulamaların compileSdk yapılandırma ayarlarını da yükseltmesi gerekir. (Ic80cd)
• Bu kitaplıkta artık tür kullanımı olan JSpecify nullness ek açıklamaları kullanılmaktadır. Kotlin geliştiricileri, doğru kullanımı zorunlu kılmak için aşağıdaki derleyici bağımsız değişkenini kullanmalıdır: -Xjspecify-annotations=strict (Kotlin derleyicisinin 2.1.0 sürümünden itibaren varsayılan olarak bu kullanılır). (I7bcd7, b/326456246)

Sürüm 1.4.0-alpha11

11 Aralık 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha11, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha11 ve androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha11 yayınlandı. 1.4.0-alpha11 sürümü bu taahhütleri içerir.

API Değişiklikleri

• viewfinder-core sınıfları, ait oldukları kitaplıkla tutarlı paketlere taşındı. (I431c6)
• CameraViewfinder.ScaleType, oluşturma (I87ef1) ile yeniden kullanılabilmesi için viewfinder-core adlı kuruluş birimine taşındı
• Desteği sonlandırılan CameraViewfinder sınıfları kaldırılır. Lütfen eşdeğer işlevler sunan yeni API'leri kullanın. (I6e59a)

Sürüm 1.4.0-alpha10

30 Ekim 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10 ve androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10 yayınlandı. 1.4.0-alpha10 sürümü bu taahhütleri içerir.

Sürüm 1.4.0-alpha09

2 Ekim 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha09, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha09 ve androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha09 yayınlandı. 1.4.0-alpha09 sürümü bu taahhütleri içerir.

Sürüm 1.4.0-alpha08

4 Eylül 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha08, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha08 ve androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha08 yayınlandı. 1.4.0-alpha08 sürümü bu taahhütleri içerir.

Yeni Özellikler

1.4.0-alpha08 sürümüne yapılan güncellemeyle CameraX Vizör yapıları kendi kitaplık gruplarına taşındı. Bu değişiklik, CameraX kitaplığının modülerliğini ve sürdürülebilirliğini iyileştirmek için gereklidir.

Daha önce androidx.camera:camera-viewfinder, androidx.camera:camera-viewfinder-compose veya androidx.camera:camera-viewfinder-core'e bağımlıysanız bağımlılıkları aşağıdakilere geçirmeniz gerekir:

• 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

Bu geçiş için kod değişikliği yapmanız gerekmez. Eski Viewfinder maven koordinatları artık güncellenmeyecektir.

Ayrıca, Compose'u CameraX ile kullanıyorsanız artık alfa sürümünde yeni bir Compose öncelikli kitaplık mevcuttur: androidx.camera:camera-compose. Bu, PreviewView'nin görünümler için işleyiş şekline benzer şekilde CameraX'in SurfaceRequest'unu Compose'a uyarlayan, Compose-idiomatik bir vizör olan CameraXViewfinder kompozisyonunu sağlar.