ช่องมองภาพของกล้อง

ตารางนี้จะแสดงรายการอาร์ติแฟกต์ทั้งหมดในกลุ่ม androidx.camera-viewfinder

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มทรัพยากร Dependency ของ camera-viewfinder คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมในที่เก็บ Maven ของ Google

เพิ่มการอ้างอิงสำหรับอาร์ติแฟกต์ที่คุณต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูล

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")


}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพึ่งพาได้ที่เพิ่มการพึ่งพิงบิวด์

ความคิดเห็น

ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ได้ โปรดแจ้งให้เราทราบหากพบปัญหาใหม่หรือมีแนวคิดในการปรับปรุงคลังนี้ โปรดดูปัญหาที่มีอยู่ในคลังนี้ก่อนสร้างปัญหาใหม่ คุณสามารถเพิ่มการโหวตให้กับปัญหาที่มีอยู่ได้โดยคลิกปุ่มดาว

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของเครื่องมือติดตามปัญหา

รุ่น 1.5

เวอร์ชัน 1.5.0-beta01

7 พฤษภาคม 2025

androidx.camera.viewfinder:viewfinder-compose:1.5.0-beta01, androidx.camera.viewfinder:viewfinder-core:1.5.0-beta01 และ androidx.camera.viewfinder:viewfinder-view:1.5.0-beta01 เผยแพร่แล้ว เวอร์ชัน 1.5.0-beta01 มีการคอมมิตเหล่านี้

• นี่เป็นเวอร์ชันเบต้าอย่างเป็นทางการครั้งแรกของช่องมองภาพตามมุมมองและตามการคอมโพสที่มีความยืดหยุ่นพอที่จะใช้กับ Camera2 หากกำลังมองหา View หรือคอมโพสิเบิลที่จะใช้กับ CameraX โปรดดู PreviewView และ CameraXViewfinder

ฟีเจอร์ใหม่

• ตอนนี้คุณใช้ ContentScale และ Alignment ในช่องมองภาพแบบคอมโพสเพื่อปรับขนาดและวางพื้นผิวที่แสดงภายในคอนเทนเนอร์ได้แล้ว ซึ่งคล้ายกับลักษณะการทำงานของ androidx.compose.foundation.Image (Ibcea3)

การเปลี่ยนแปลง API

• ตอนนี้ TransformationInfo มีค่าเริ่มต้นสำหรับ args ทั้งหมดแล้ว ซึ่งจะช่วยให้สร้างช่องมองภาพได้โดยไม่ต้องมี TransformationInfo ซึ่งจะตั้งค่าเริ่มต้นเป็นการหมุนแหล่งที่มาเป็น 0, ไม่มีการมิเรอร์แหล่งที่มา และไม่มีสี่เหลี่ยมผืนผ้าครอบตัด (I2b1b2)
• ตอนนี้ Viewfinder แบบคอมโพสได้นํา Lambda ต่อท้ายเพื่อรับเซสชัน Surface เช่นเดียวกับ AndroidExternalSurface Lambda ที่ระบุใช้ ViewfinderInitScope เป็นตัวรับ ซึ่งช่วยให้ติดตั้งการเรียกกลับเพื่อรับเซสชัน Surface ใหม่ได้ เซสชันของแพลตฟอร์มเหล่านี้จะปล่อยทรัพยากรที่ Viewfinder ถือครองไว้โดยอัตโนมัติเมื่ออยู่นอกขอบเขต (Ib2b0d)
• เราได้นํา ViewfinderSurfaceRequest.Builder.populateFromCharacteristics ออกแล้วและแทนที่ด้วยชุด API แบบคงที่ที่เทียบเท่าซึ่งสามารถใช้สร้าง TransformationInfo ที่จะทําการเปลี่ยนรูปแบบแบบเดียวกับ populateFromCharacteristics ระบบจะเพิ่มเมธอดแบบคงที่เหล่านี้ลงในคลาส Camera2TransformationInfo (Idc6af)
• ViewfinderSurfaceRequest ไม่มี Async API สําหรับการเรียกข้อมูลแพลตฟอร์มอีกต่อไป ตอนนี้เป็นประเภทข้อมูลที่เปลี่ยนแปลงไม่ได้ ตอนนี้ API สำหรับการดึงข้อมูลพื้นผิวได้ย้ายไปยังช่องมองภาพแล้ว (I30127)
• CameraViewfinder ได้เปลี่ยนชื่อเป็น ViewfinderView เพื่อให้ชื่อสอดคล้องกับชื่อของคอมโพสิตช่องมองภาพ และเพื่อระบุว่าสามารถใช้กับแหล่งที่มาอื่นๆ นอกเหนือจากกล้อง (Id9e6b)
• ย้ายคลาสจาก viewfinder-view ไปยังแพ็กเกจย่อย androidx.camera.viewfinder.view จากแพ็กเกจ androidx.camera.viewfinder แล้ว (I6cb44)
• มีการเพิ่ม API ใหม่ลงในช่องมองภาพตามมุมมอง ซึ่งช่วยให้คุณตั้งค่าการหมุนแหล่งที่มา การมิเรอร์ และการครอบตัดสี่เหลี่ยมผืนผ้าได้ คลาส TransformationInfo นี้เป็นคลาสเดียวกับที่เครื่องมือดูตัวอย่างแบบคอมโพสใช้ (I907c3)
• ตอนนี้ Viewfinder ตามมุมมองใช้ ViewfinderSurfaceRequest API ใหม่ซึ่งไม่จัดการการตอบกลับของ Surface ภายในอีกต่อไป ตอนนี้ API requestSurfaceSession() จะแสดงผล ListenableFuture<ViewfinderSurfaceSession> แทนที่จะเป็น ListenableFuture<Surface> ซึ่งจะแสดงผลคลาส AutoCloseable ที่เมื่อปิดแล้วจะทํางานเหมือนกับการเรียก API เก่าของ ViewfinderSurfaceRequest.markSurfaceSafeToRelease() วิธีนี้ช่วยให้แยกความรับผิดชอบระหว่างคำขอแพลตฟอร์มและการตอบสนองของแพลตฟอร์มได้ชัดเจนยิ่งขึ้น (I19041)

เวอร์ชัน 1.4

เวอร์ชัน 1.4.0-alpha13

26 กุมภาพันธ์ 2025

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha13, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha13 และ androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha13 เผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha13 มีการคอมมิตเหล่านี้

เวอร์ชัน 1.4.0-alpha12

15 มกราคม 2025

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha12, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha12 และ androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha12 เผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha12 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• อัปเกรด compileSdk เป็น 35 เพื่อใช้ API ที่เกี่ยวข้องกับ Android 15 แอปที่ใช้ไลบรารี CameraX จะต้องอัปเกรดการตั้งค่า compileSdk ด้วย (Ic80cd)
• ตอนนี้ไลบรารีนี้ใช้แอตทริบิวต์ JSpecify nullness ซึ่งเป็นการใช้ประเภท นักพัฒนาซอฟต์แวร์ Kotlin ควรใช้อาร์กิวเมนต์คอมไพเลอร์ต่อไปนี้เพื่อบังคับใช้การใช้งานที่ถูกต้อง -Xjspecify-annotations=strict (นี่เป็นค่าเริ่มต้นที่เริ่มตั้งแต่คอมไพเลอร์ Kotlin เวอร์ชัน 2.1.0) (I7bcd7, b/326456246)

เวอร์ชัน 1.4.0-alpha11

11 ธันวาคม 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha11, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha11 และ androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha11 เผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha11 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

• ย้ายคลาส viewfinder-core ไปยังแพ็กเกจที่สอดคล้องกับไลบรารีที่คลาสนั้นอยู่ (I431c6)
• ย้าย CameraViewfinder.ScaleType ไปที่ viewfinder-core แล้วเพื่อให้นํากลับมาใช้กับคอมโพซ (I87ef1) ได้
• ระบบจะนำคลาส CameraViewfinder ที่เลิกใช้งานแล้วออก โปรดใช้ API ใหม่ที่ให้ฟังก์ชันการทำงานเทียบเท่า (I6e59a)

เวอร์ชัน 1.4.0-alpha10

30 ตุลาคม 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10 และ androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10 เผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha10 มีการคอมมิตเหล่านี้

เวอร์ชัน 1.4.0-alpha09

2 ตุลาคม 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha09, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha09 และ androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha09 เผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha09 มีการคอมมิตเหล่านี้

เวอร์ชัน 1.4.0-alpha08

4 กันยายน 2024

androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha08, androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha08 และ androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha08 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

เมื่ออัปเดตเป็น 1.4.0-alpha08 ระบบได้ย้ายอาร์ติแฟกต์ช่องมองภาพของ CameraX ไปยังกลุ่มไลบรารีของตัวเอง การเปลี่ยนแปลงนี้จำเป็นต่อการปรับปรุงความเป็นโมดูลและการบำรุงรักษาของไลบรารี CameraX

หากก่อนหน้านี้คุณใช้ androidx.camera:camera-viewfinder, androidx.camera:camera-viewfinder-compose หรือ androidx.camera:camera-viewfinder-core คุณจะต้องเปลี่ยนการอ้างอิงเป็นรายการต่อไปนี้

• 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

คุณไม่จำเป็นต้องเปลี่ยนแปลงโค้ดเพื่อทําการเปลี่ยนแปลงนี้ พิกัด Maven ของโปรแกรมดูตัวอย่างแบบเก่าจะไม่ได้รับการอัปเดตอีกต่อไป

นอกจากนี้ หากคุณใช้ Compose กับ CameraX ขณะนี้ไลบรารี Compose เท่านั้นใหม่ androidx.camera:camera-compose พร้อมใช้งานในรุ่นอัลฟ่าแล้ว ซึ่งจะแสดง CameraXViewfinder composable ซึ่งเป็นช่องมองภาพแบบ Compose ที่ปรับ SurfaceRequest ของ CameraX ให้เข้ากับ Compose ซึ่งคล้ายกับวิธีที่ PreviewView ทำงานกับมุมมอง