ข่าวสารเกี่ยวกับผลิตภัณฑ์

เหนือกว่าฟีเจอร์เดียว: รับประกันการใช้ฟีเจอร์ร่วมกันด้วย CameraX 1.5

ใช้เวลาอ่าน 6 นาที
ดูโปรไฟล์ของ Tahsin Masrur
Tahsin Masrur วิศวกรซอฟต์แวร์

แอปกล้องสมัยใหม่มีฟีเจอร์ที่ทรงพลังและทับซ้อนกัน ผู้ใช้คาดหวังที่จะบันทึกวิดีโอด้วย 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) ขณะเดียวกันก็หลีกเลี่ยงข้อผิดพลาดในอุปกรณ์ที่ไม่รองรับการใช้ฟีเจอร์ร่วมกันได้อย่างราบรื่น

unnamed.png
Pixel 10 Pro เปิดใช้ทั้ง HDR และ 60 FPS พร้อมกัน
unnamed (1).png
ในอุปกรณ์รุ่นเก่าที่ HDR และ 60 FPS ไม่สามารถทำงานพร้อมกันได้ ระบบจะเปิดใช้เฉพาะ HDR และปิดใช้ตัวเลือก 60 FPS

Feature Group API ช่วยให้คุณทำสิ่งต่อไปนี้ได้

  • สร้าง UI แบบไดนามิกที่ชาญฉลาดยิ่งขึ้น: เปิดหรือปิดใช้การตั้งค่าใน UI อย่างชาญฉลาดโดยอิงตามการรองรับฮาร์ดแวร์แบบเรียลไทม์ เช่น หากผู้ใช้เปิดใช้ HDR คุณสามารถเปลี่ยนตัวเลือก 60 FPS เป็นสีเทาและปิดใช้ได้ทันทีหากอุปกรณ์ไม่รองรับการใช้ทั้ง 2 ตัวเลือกร่วมกัน 
hdr.gif
  • แสดงโหมด "คุณภาพสูง" ที่เชื่อถือได้: กำหนดค่ากล้องด้วยรายการฟีเจอร์ที่ต้องการตามลำดับความสำคัญ CameraX จะค้นหาและเปิดใช้ชุดค่าผสมที่รองรับได้ดีที่สุดสำหรับอุปกรณ์หนึ่งๆ โดยอัตโนมัติ เพื่อให้ได้ผลลัพธ์ที่ยอดเยี่ยมโดยไม่ต้องใช้ตรรกะที่ซับซ้อนและเฉพาะเจาะจงสำหรับอุปกรณ์
  • ป้องกันไม่ให้เซสชันกล้องล้มเหลว: การยืนยันการรองรับล่วงหน้าจะช่วยป้องกันไม่ให้กล้องพยายามกำหนดค่าชุดค่าผสมที่ไม่รองรับ ซึ่งจะช่วยขจัดสาเหตุที่พบบ่อยของข้อขัดข้องและมอบประสบการณ์การใช้งานที่ราบรื่นให้แก่ผู้ใช้

วิธีการทำงาน: องค์ประกอบหลัก

API ใหม่จะเน้นไปที่การเพิ่มคีย์ใน SessionConfig และ CameraInfo

  1. GroupableFeature: API นี้จะเปิดตัวชุดฟีเจอร์ที่จัดกลุ่มได้ซึ่งกำหนดไว้ล่วงหน้า เช่น HDR_HLG10, FPS_60, PREVIEW_STABILIZATION และ IMAGE_ULTRA_HDR เนื่องจากข้อจำกัดด้านการประมวลผล จึงมีเพียงฟีเจอร์บางชุดเท่านั้นที่จัดกลุ่มได้ด้วยความน่าเชื่อถือระดับสูงที่ API นี้มีให้ เรากำลังพยายามอย่างเต็มที่เพื่อขยายรายการนี้ และจะเปิดตัวการรองรับฟีเจอร์เพิ่มเติมในรุ่นต่อๆ ไป
     
  2. พารามิเตอร์ SessionConfig ใหม่: คลาสนี้ใช้สำหรับเริ่มเซสชันกล้อง และตอนนี้ยอมรับพารามิเตอร์ใหม่ 2 รายการต่อไปนี้
    • requiredFeatureGroup: ใช้ค่านี้สำหรับฟีเจอร์ที่ต้องรองรับเพื่อให้การกำหนดค่าสำเร็จ เหมาะสำหรับฟีเจอร์ที่ผู้ใช้เปิดใช้อย่างชัดแจ้ง เช่น การเปิด/ปิดสวิตช์ "HDR" เพื่อให้มั่นใจว่าประสบการณ์การใช้งานจะเป็นไปตามที่กำหนดและสอดคล้องกัน การเรียกใช้ bindToLifecycle จะแสดง IllegalArgumentException หากไม่รองรับชุดค่าผสมที่ขอ แทนที่จะเพิกเฉยต่อคำขอฟีเจอร์โดยไม่แจ้งให้ทราบ คุณควรใช้ CameraInfo#isFeatureGroupSupported API (รายละเอียดด้านล่าง) เพื่อค้นหาผลลัพธ์นี้ล่วงหน้า
    • preferredFeatureGroup: ใช้สำหรับฟีเจอร์ที่ต้องการแต่ไม่บังคับ เช่น เมื่อคุณต้องการใช้โหมด "คุณภาพสูง" เริ่มต้น คุณระบุรายการฟีเจอร์ที่ต้องการตามลำดับความสำคัญ แล้ว CameraX จะเปิดใช้ชุดค่าผสมที่มีลำดับความสำคัญสูงสุดที่อุปกรณ์รองรับโดยอัตโนมัติ
  3. 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 จะพยายามเปิดใช้ชุดค่าผสมของฟีเจอร์ตามลำดับความสำคัญต่อไปนี้ โดยเลือกชุดค่าผสมแรกที่อุปกรณ์รองรับอย่างเต็มรูปแบบ

  1. HDR + 60 FPS + ระบบกันภาพสั่นไหวในตัวอย่าง
  2. HDR + 60 FPS
  3. HDR + ระบบกันภาพสั่นไหวในตัวอย่างภาพ
  4. HDR
  5. 60 FPS + ระบบกันภาพสั่นในตัวอย่าง
  6. 60 FPS
  7. การแสดงตัวอย่างระบบกันสั่น
  8. ไม่มีฟีเจอร์ข้างต้น

สถานการณ์ที่ 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 โดยจะมีการรองรับและการปรับปรุงเพิ่มเติมในอนาคต

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

เขียนโดย
อ่านต่อ