เหนือกว่าฟีเจอร์เดียว: รับประกันการใช้ฟีเจอร์ร่วมกันด้วย CameraX 1.5
ใช้เวลาอ่าน 6 นาที
แอปกล้องสมัยใหม่มีฟีเจอร์ที่ทรงพลังและทับซ้อนกัน ผู้ใช้คาดหวังที่จะบันทึกวิดีโอด้วย HDR ที่น่าทึ่ง จับภาพการเคลื่อนไหวที่ลื่นไหลที่ 60 FPS และได้ฟุตเทจที่ราบรื่นด้วยระบบกันภาพสั่นไหวในเวอร์ชันตัวอย่าง ซึ่งมักจะเกิดขึ้นพร้อมกันทั้งหมด
ในฐานะนักพัฒนาแอป เราทราบดีว่าในความเป็นจริงแล้วมีความซับซ้อนมากกว่านั้น คุณจะรับประกันได้อย่างไรว่าอุปกรณ์หนึ่งๆ รองรับชุดค่าผสมที่ระบุจริงๆ ก่อนหน้านี้ การเปิดใช้หลายฟีเจอร์มักเป็นการเสี่ยงดวง คุณสามารถตรวจสอบการรองรับฟีเจอร์แต่ละรายการได้ แต่การรวมฟีเจอร์เข้าด้วยกันอาจทำให้เกิดลักษณะการทำงานที่ไม่ได้กำหนดไว้ หรือแย่กว่านั้นคือเซสชันกล้องไม่สำเร็จ ความไม่แน่นอนนี้ทำให้นักพัฒนาแอปต้องระมัดระวัง ซึ่งทำให้ผู้ใช้ที่ใช้อุปกรณ์ที่มีประสิทธิภาพไม่สามารถเข้าถึงประสบการณ์การใช้งานที่ดีที่สุดได้
ตัวอย่างเช่น มีอุปกรณ์ระดับพรีเมียมเพียงไม่กี่เครื่องที่รองรับวิดีโอ HDR และ 60 FPS พร้อมกันได้อย่างเสถียร ด้วยเหตุนี้ แอปส่วนใหญ่จึงหลีกเลี่ยงการเปิดใช้ทั้ง 2 อย่างพร้อมกันเพื่อป้องกันไม่ให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ไม่ดีในโทรศัพท์ส่วนใหญ่
เพื่อแก้ไขปัญหานี้ เราขอแนะนำ Feature Group ใน CameraX ซึ่งเป็น API ใหม่ที่ออกแบบมาเพื่อขจัดความไม่แน่นอนนี้ ตอนนี้คุณสามารถค้นหาได้ว่าระบบรองรับฟีเจอร์ที่รวมกันบางอย่างหรือไม่ก่อนกำหนดค่ากล้อง หรือเพียงบอก CameraX ว่าคุณให้ความสำคัญกับสิ่งใดและให้ระบบเปิดใช้ฟีเจอร์ที่รวมกันซึ่งรองรับได้ดีที่สุดสำหรับคุณ
สำหรับผู้ที่เพิ่งเริ่มใช้ CameraX
ก่อนที่เราจะเจาะลึก Feature Group API ใหม่ มาสรุปสั้นๆ กันก่อนว่า CameraX คืออะไร CameraX เป็นไลบรารีสนับสนุน Jetpack ที่สร้างขึ้นเพื่อช่วยให้คุณพัฒนาแอปกล้องได้ง่ายขึ้น โดยมีแพลตฟอร์ม API ที่สอดคล้องและใช้งานง่ายซึ่งทำงานได้ในอุปกรณ์ Android ส่วนใหญ่ พร้อมความเข้ากันได้แบบย้อนหลังกับ Android 6.0 (API ระดับ 23) หากคุณเพิ่งเริ่มใช้ CameraX เราขอแนะนำให้อ่านเอกสารประกอบอย่างเป็นทางการและลองใช้ Codelab เพื่อเริ่มต้นใช้งาน
สิ่งที่คุณสร้างได้ด้วย Feature Group API
คุณไม่จำเป็นต้องเสี่ยงกับการใช้ฟีเจอร์ร่วมกันอีกต่อไป และสามารถมอบประสบการณ์การใช้งานกล้องที่ดีที่สุดได้อย่างมั่นใจ เช่น วิดีโอ HDR และ 60 FPS พร้อมกันในฮาร์ดแวร์ที่รองรับ (เช่น Pixel 10 Pro) ขณะเดียวกันก็หลีกเลี่ยงข้อผิดพลาดในอุปกรณ์ที่ไม่รองรับการใช้ฟีเจอร์ร่วมกันได้อย่างราบรื่น
Feature Group API ช่วยให้คุณทำสิ่งต่อไปนี้ได้
- สร้าง UI แบบไดนามิกที่ชาญฉลาดยิ่งขึ้น: เปิดหรือปิดใช้การตั้งค่าใน UI อย่างชาญฉลาดโดยอิงตามการรองรับฮาร์ดแวร์แบบเรียลไทม์ เช่น หากผู้ใช้เปิดใช้ HDR คุณสามารถเปลี่ยนตัวเลือก 60 FPS เป็นสีเทาและปิดใช้ได้ทันทีหากอุปกรณ์ไม่รองรับการใช้ทั้ง 2 ตัวเลือกร่วมกัน
- แสดงโหมด "คุณภาพสูง" ที่เชื่อถือได้: กำหนดค่ากล้องด้วยรายการฟีเจอร์ที่ต้องการตามลำดับความสำคัญ CameraX จะค้นหาและเปิดใช้ชุดค่าผสมที่รองรับได้ดีที่สุดสำหรับอุปกรณ์หนึ่งๆ โดยอัตโนมัติ เพื่อให้ได้ผลลัพธ์ที่ยอดเยี่ยมโดยไม่ต้องใช้ตรรกะที่ซับซ้อนและเฉพาะเจาะจงสำหรับอุปกรณ์
- ป้องกันไม่ให้เซสชันกล้องล้มเหลว: การยืนยันการรองรับล่วงหน้าจะช่วยป้องกันไม่ให้กล้องพยายามกำหนดค่าชุดค่าผสมที่ไม่รองรับ ซึ่งจะช่วยขจัดสาเหตุที่พบบ่อยของข้อขัดข้องและมอบประสบการณ์การใช้งานที่ราบรื่นให้แก่ผู้ใช้
วิธีการทำงาน: องค์ประกอบหลัก
API ใหม่จะเน้นไปที่การเพิ่มคีย์ใน SessionConfig และ CameraInfo
- GroupableFeature: API นี้จะเปิดตัวชุดฟีเจอร์ที่จัดกลุ่มได้ซึ่งกำหนดไว้ล่วงหน้า เช่น HDR_HLG10, FPS_60, PREVIEW_STABILIZATION และ IMAGE_ULTRA_HDR เนื่องจากข้อจำกัดด้านการประมวลผล จึงมีเพียงฟีเจอร์บางชุดเท่านั้นที่จัดกลุ่มได้ด้วยความน่าเชื่อถือระดับสูงที่ API นี้มีให้ เรากำลังพยายามอย่างเต็มที่เพื่อขยายรายการนี้ และจะเปิดตัวการรองรับฟีเจอร์เพิ่มเติมในรุ่นต่อๆ ไป
- พารามิเตอร์ SessionConfig ใหม่: คลาสนี้ใช้สำหรับเริ่มเซสชันกล้อง และตอนนี้ยอมรับพารามิเตอร์ใหม่ 2 รายการต่อไปนี้
requiredFeatureGroup: ใช้ค่านี้สำหรับฟีเจอร์ที่ต้องรองรับเพื่อให้การกำหนดค่าสำเร็จ เหมาะสำหรับฟีเจอร์ที่ผู้ใช้เปิดใช้อย่างชัดแจ้ง เช่น การเปิด/ปิดสวิตช์ "HDR" เพื่อให้มั่นใจว่าประสบการณ์การใช้งานจะเป็นไปตามที่กำหนดและสอดคล้องกัน การเรียกใช้bindToLifecycleจะแสดงIllegalArgumentExceptionหากไม่รองรับชุดค่าผสมที่ขอ แทนที่จะเพิกเฉยต่อคำขอฟีเจอร์โดยไม่แจ้งให้ทราบ คุณควรใช้CameraInfo#isFeatureGroupSupportedAPI (รายละเอียดด้านล่าง) เพื่อค้นหาผลลัพธ์นี้ล่วงหน้าpreferredFeatureGroup: ใช้สำหรับฟีเจอร์ที่ต้องการแต่ไม่บังคับ เช่น เมื่อคุณต้องการใช้โหมด "คุณภาพสูง" เริ่มต้น คุณระบุรายการฟีเจอร์ที่ต้องการตามลำดับความสำคัญ แล้ว CameraX จะเปิดใช้ชุดค่าผสมที่มีลำดับความสำคัญสูงสุดที่อุปกรณ์รองรับโดยอัตโนมัติ
- CameraInfo#isFeatureGroupSupported(): นี่คือเมธอดการค้นหาหลักสำหรับการตรวจสอบอย่างชัดเจนว่าระบบรองรับกลุ่มฟีเจอร์หรือไม่ ซึ่งเหมาะสำหรับการแสดงเฉพาะตัวเลือกฟีเจอร์ที่รองรับแก่ผู้ใช้ใน UI ของแอป คุณส่ง
SessionConfigไปยังเมธอดดังกล่าว และเมธอดจะแสดงผลบูลีนที่ระบุว่ารองรับชุดค่าผสมหรือไม่ หากต้องการเชื่อมโยงSessionConfigกับฟีเจอร์ที่จำเป็น คุณควรใช้ API นี้ก่อนเพื่อให้แน่ใจว่าระบบรองรับ
การนำไปใช้จริง
มาดูวิธีใช้คอมโพเนนต์เหล่านี้เพื่อสร้างประสบการณ์การใช้งานกล้องที่ดียิ่งขึ้นกัน
สถานการณ์ที่ 1: โหมดคุณภาพสูงแบบ "พยายามอย่างเต็มที่"
หากต้องการเปิดใช้ฟีเจอร์ที่ดีที่สุดโดยค่าเริ่มต้น คุณสามารถระบุรายการที่จัดลำดับความสำคัญให้กับ preferredFeatureGroup ได้ ในตัวอย่างนี้ เราบอกให้ CameraX จัดลำดับความสำคัญของ HDR ตามด้วย 60 FPS และสุดท้ายคือระบบกันสั่นในตัวอย่างภาพ CameraX จะจัดการความซับซ้อนในการตรวจสอบชุดค่าผสมที่เป็นไปได้ทั้งหมดและเลือกชุดค่าผสมที่ดีที่สุดที่อุปกรณ์รองรับ
เช่น หากอุปกรณ์รองรับ HDR และ 60 FPS พร้อมกันได้ แต่ไม่รองรับระบบกันสั่นในตัวอย่าง CameraX จะเปิดใช้ 2 ฟีเจอร์แรกและปิดใช้ฟีเจอร์ที่ 3 วิธีนี้จะช่วยให้คุณได้รับประสบการณ์การใช้งานที่ดีที่สุดโดยไม่ต้องเขียนการตรวจสอบที่ซับซ้อนและเจาะจงอุปกรณ์
cameraProvider.bindToLifecycle(
lifecycleOwner,
cameraSelector,
SessionConfig(
useCases = listOf(preview, videoCapture),
// The order of features in this list determines their priority.
// CameraX will enable the best-supported combination based on these
// priorities: HDR_HLG10 > FPS_60 > Preview Stabilization.
preferredFeatureGroup =
listOf(HDR_HLG10, FPS_60, PREVIEW_STABILIZATION),
).apply {
// (Optional) Get a callback with the enabled features
// to update your UI.
setFeatureSelectionListener { selectedFeatures ->
updateUiIndicators(selectedFeatures)
}
}
)สำหรับข้อมูลโค้ดนี้ CameraX จะพยายามเปิดใช้ชุดค่าผสมของฟีเจอร์ตามลำดับความสำคัญต่อไปนี้ โดยเลือกชุดค่าผสมแรกที่อุปกรณ์รองรับอย่างเต็มรูปแบบ
- HDR + 60 FPS + ระบบกันภาพสั่นไหวในตัวอย่าง
- HDR + 60 FPS
- HDR + ระบบกันภาพสั่นไหวในตัวอย่างภาพ
- HDR
- 60 FPS + ระบบกันภาพสั่นในตัวอย่าง
- 60 FPS
- การแสดงตัวอย่างระบบกันสั่น
- ไม่มีฟีเจอร์ข้างต้น
สถานการณ์ที่ 2: การสร้าง UI แบบรีแอ็กทีฟ
หากต้องการสร้าง UI ที่ตอบสนองต่อการเลือกของผู้ใช้และป้องกันไม่ให้ผู้ใช้เลือกชุดค่าผสมของฟีเจอร์ที่ไม่รองรับ คุณสามารถค้นหาการรองรับได้โดยตรง ฟังก์ชันด้านล่างจะตรวจสอบว่าฟีเจอร์ใดเข้ากันไม่ได้กับตัวเลือกปัจจุบันของผู้ใช้ ซึ่งจะช่วยให้คุณปิดใช้องค์ประกอบ UI ที่เกี่ยวข้องได้
/**
* Returns a list of features that are NOT supported in combination
* with the currently selected features.
*/
fun getUnsupportedFeatures(
currentFeatures: Set<GroupableFeature>
): Set<GroupableFeature> {
val unsupportedFeatures = mutableSetOf<GroupableFeature>()
val appFeatureOptions = setOf(HDR_HLG10, FPS_60, PREVIEW_STABILIZATION)
// Iterate over every available feature option in your app.
appFeatureOptions.forEach { featureOption ->
// Skip features the user has already selected.
if (currentFeatures.contains(featureOption)) return@forEach
// Check if adding this new feature is supported.
val isSupported = cameraInfo.isFeatureGroupSupported(
SessionConfig(
useCases = useCases,
// Check the new feature on top of existing ones.
requiredFeatureGroup = currentFeatures + featureOption
)
)
if (!isSupported) {
unsupportedFeatures.add(featureOption)
}
}
return unsupportedFeatures
}จากนั้นคุณสามารถเชื่อมต่อตรรกะนี้เข้ากับ ViewModel หรือตัวควบคุม UI เพื่อตอบสนองต่ออินพุตของผู้ใช้และเชื่อมโยงกล้องอีกครั้งด้วยการกำหนดค่าที่รับประกันว่าจะทำงานได้
// Invoked when user turns some feature on/off.
fun onFeatureChange(currentFeatures: Set<GroupableFeature>) {
// Identify features that are unsupported with the current selection.
val unsupportedFeatures = getUnsupportedFeatures(currentFeatures)
// Update app UI so that users can't enable them.
updateDisabledFeatures(unsupportedFeatures)
// Since the UI now only allows selecting supported feature combinations,
// `currentFeatures` is always valid. This allows setting
// `requiredFeatureGroup` directly, without needing to re-check for
// support or set a feature selection listener.
cameraProvider.bindToLifecycle(
lifecycleOwner,
cameraSelector,
SessionConfig(
useCases = listOf(preview, videoCapture),
requiredFeatureGroup = currentFeatures,
)
)
}หากต้องการดูแนวคิดเหล่านี้ในแอปพลิเคชันที่ใช้งานได้จริง คุณสามารถสำรวจแอปทดสอบภายในของเรา ซึ่งมีการติดตั้งใช้งานทั้งสถานการณ์ "พยายามอย่างเต็มที่" และ "UI แบบรีแอ็กทีฟ" ที่กล่าวถึงข้างต้นอย่างสมบูรณ์
โปรดทราบว่านี่เป็นแอปพลิเคชันทดสอบและไม่ใช่ตัวอย่างที่รองรับอย่างเป็นทางการ แม้ว่าจะเป็นข้อมูลอ้างอิงที่ยอดเยี่ยมสำหรับ Feature Group API แต่ก็ยังไม่ได้รับการปรับปรุงสำหรับการใช้งานจริง
เริ่มวันนี้เลย
Feature Group API ช่วยลดความคลุมเครือในการทำงานกับความสามารถขั้นสูงของกล้อง การระบุวิธีเชิงกำหนดในการค้นหาการรองรับฟีเจอร์จะช่วยให้คุณสร้างแอปกล้องที่มีประสิทธิภาพและเชื่อถือได้มากขึ้นอย่างมั่นใจ
API นี้พร้อมให้ใช้งานในขั้นทดลองใน CameraX 1.5 และมีกำหนดจะเสถียรอย่างสมบูรณ์ในรุ่น 1.6 โดยจะมีการรองรับและการปรับปรุงเพิ่มเติมในอนาคต
ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบอย่างเป็นทางการ เราจะรอดูสิ่งที่คุณจะสร้างสรรค์และหวังเป็นอย่างยิ่งว่าจะได้รับฟังความคิดเห็นจากคุณ โปรดแสดงความคิดเห็นและรายงานปัญหาผ่านช่องทางต่อไปนี้
-
ข่าวสารเกี่ยวกับผลิตภัณฑ์ดูวิธีที่เครื่องมือขยายช่องทางของ Google Play ใน Play Console ช่วยเพิ่มการเข้าถึงผู้ซื้อใน Store, เว็บ และแพลตฟอร์มภายนอก พร้อมทั้งปกป้องมาร์จิน
Phalene Gowling, Rejane França • ใช้เวลาอ่าน 4 นาที -
ข่าวสารเกี่ยวกับผลิตภัณฑ์Unity ขับเคลื่อนเกมบนอุปกรณ์เคลื่อนที่มากกว่าครึ่งหนึ่งทั่วโลก ดังนั้นความประทับใจแรกจึงเป็นสิ่งสำคัญ สำหรับนักพัฒนาเกม ประสบการณ์การเตรียมความพร้อมผู้ใช้งานใหม่ที่ราบรื่นและเชื่อถือได้เป็นสิ่งสำคัญในการกระตุ้นการคงผู้ใช้ไว้ตั้งแต่วันแรกและความผูกพันในระยะยาว
Michelle Martin • ใช้เวลาอ่าน 1 นาที -
ข่าวสารเกี่ยวกับผลิตภัณฑ์ตั้งแต่การดื่มด่ำอย่างเต็มรูปแบบที่บ้านไปจนถึงประสบการณ์ที่เข้าถึงได้ง่ายในระหว่างเดินทาง การสร้างแอปบน Android XR ช่วยให้คุณเข้าถึงผู้ใช้ได้ทุกที่ทุกเวลาในแอปพลิเคชันเชิงพื้นที่ทุกประเภท ที่งาน Android Developer Summit เราได้ประกาศความสำเร็จที่น่าตื่นเต้นด้วยการเปิดตัว XREAL AURA
Amy Zeppenfeld, Vinny DaSilva • ใช้เวลาอ่าน 3 นาที
รับข้อมูลเชิงลึกล่าสุดเกี่ยวกับการพัฒนา Android ที่ส่งไปยังกล่องจดหมายของคุณทุกสัปดาห์