API อัตราเฟรมช่วยให้แอปแจ้งแพลตฟอร์ม Android เกี่ยวกับอัตราเฟรมที่ต้องการได้ และพร้อมใช้งานในแอปที่กำหนดเป้าหมายเป็น Android 11 (ระดับ API 30) ขึ้นไป โดยปกติแล้ว อุปกรณ์ส่วนใหญ่จะรองรับอัตราการรีเฟรชหน้าจอเพียงอัตราเดียว ซึ่งมักจะเป็น 60Hz แต่ตอนนี้สถานการณ์ได้เปลี่ยนไปแล้ว ปัจจุบันอุปกรณ์หลายรุ่นรองรับอัตราการรีเฟรชเพิ่มเติม เช่น 90Hz หรือ 120Hz อุปกรณ์บางเครื่องรองรับการเปลี่ยนอัตราการรีเฟรชที่ราบรื่น ส่วนอุปกรณ์อื่นๆ จะแสดงหน้าจอสีดำเป็นเวลาสั้นๆ ซึ่งโดยปกติจะใช้เวลา 1 วินาที
วัตถุประสงค์หลักของ API คือการช่วยให้แอปใช้ประโยชน์จากอัตราการรีเฟรชจอแสดงผลที่รองรับทั้งหมดได้ดียิ่งขึ้น เช่น แอปที่เล่นวิดีโอ 24Hz ซึ่งเรียกใช้ setFrameRate() อาจส่งผลให้อุปกรณ์เปลี่ยนอัตราการรีเฟรชจอแสดงผลจาก 60Hz เป็น 120Hz อัตราการรีเฟรชใหม่นี้ช่วยให้เล่นวิดีโอ 24Hz ได้อย่างราบรื่นและไม่กระตุก โดยไม่จำเป็นต้องใช้การแปลง 3:2 Pulldown เหมือนกับการเล่นวิดีโอเดียวกันบนจอแสดงผล 60Hz ซึ่งจะช่วยให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ดียิ่งขึ้น
การใช้งานพื้นฐาน
Android มีวิธีเข้าถึงและควบคุมหน้าจอหลายวิธี จึงมี setFrameRate() API หลายเวอร์ชัน API แต่ละเวอร์ชันจะใช้พารามิเตอร์เดียวกันและทำงานเหมือนกับเวอร์ชันอื่นๆ ดังนี้
Surface.setFrameRate()SurfaceControl.Transaction.setFrameRate()ANativeWindow_setFrameRate()ASurfaceTransaction_setFrameRate()
แอปไม่จำเป็นต้องพิจารณาอัตราการรีเฟรชการแสดงผลที่รองรับจริง ซึ่งสามารถรับได้โดยการเรียกใช้ Display.getSupportedModes() เพื่อเรียกใช้ setFrameRate() อย่างปลอดภัย ตัวอย่างเช่น แม้ว่าอุปกรณ์จะรองรับเฉพาะ 60Hz ให้เรียกใช้ setFrameRate() ด้วยอัตราเฟรมที่แอปของคุณต้องการ
อุปกรณ์ที่ไม่มีอัตราเฟรมที่ตรงกับแอปมากกว่าจะยังคงใช้อัตราการรีเฟรชการแสดงผลปัจจุบัน
หากต้องการดูว่าการเรียกใช้ setFrameRate() ส่งผลให้เกิดการเปลี่ยนแปลงอัตราการรีเฟรชการแสดงผลหรือไม่ ให้ลงทะเบียนรับการแจ้งเตือนการเปลี่ยนแปลงการแสดงผลโดยเรียกใช้ DisplayManager.registerDisplayListener() หรือ AChoreographer_registerRefreshRateCallback()
เมื่อเรียกใช้ setFrameRate() คุณควรส่งอัตราเฟรมที่แน่นอนแทนที่จะปัดเศษเป็นจำนวนเต็ม เช่น เมื่อแสดงผลวิดีโอที่บันทึกที่ 29.97 Hz ให้ส่งค่า 29.97 แทนที่จะปัดเศษเป็น 30
สำหรับแอปวิดีโอ ควรตั้งค่าพารามิเตอร์ความเข้ากันได้ที่ส่งไปยัง setFrameRate() เป็น Surface.FRAME_RATE_COMPATIBILITY_FIXED_SOURCE เพื่อให้คำแนะนำเพิ่มเติมแก่แพลตฟอร์ม Android ว่าแอปจะใช้การดึงลงเพื่อปรับให้เข้ากับอัตราการรีเฟรชจอแสดงผลที่ไม่ตรงกัน (ซึ่งจะส่งผลให้เกิดการกระตุก)
ในบางสถานการณ์ พื้นผิววิดีโอจะหยุดส่งเฟรม แต่จะยังคงปรากฏบนหน้าจอเป็นระยะเวลาหนึ่ง สถานการณ์ที่พบบ่อย ได้แก่ เมื่อการเล่นวิดีโอถึงตอนจบหรือเมื่อผู้ใช้หยุดเล่นชั่วคราว ในกรณีเหล่านี้ ให้เรียกใช้ setFrameRate() โดยตั้งค่าพารามิเตอร์อัตราเฟรมเป็น 0 เพื่อล้างการตั้งค่าอัตราเฟรมของ Surface กลับเป็นค่าเริ่มต้น การล้างการตั้งค่าอัตราเฟรมเช่นนี้ไม่จำเป็นเมื่อทำลาย Surface หรือเมื่อซ่อน Surface เนื่องจากผู้ใช้เปลี่ยนไปใช้แอปอื่น ล้างการตั้งค่าอัตราเฟรมเฉพาะเมื่อ Surface ยังคงมองเห็นได้โดยไม่ได้ใช้งาน
การเปลี่ยนอัตราเฟรมแบบไม่ราบรื่น
ในอุปกรณ์บางเครื่อง การเปลี่ยนอัตราการรีเฟรชอาจทำให้ภาพหยุดชะงัก เช่น หน้าจอดำเป็นเวลา 1-2 วินาที ซึ่งมักเกิดขึ้นในกล่องรับสัญญาณ แผงทีวี และอุปกรณ์ที่คล้ายกัน โดยค่าเริ่มต้น เฟรมเวิร์ก Android จะไม่เปลี่ยนโหมดเมื่อมีการเรียกใช้ API Surface.setFrameRate() เพื่อหลีกเลี่ยงการรบกวนภาพดังกล่าว
ผู้ใช้บางรายชอบให้มีภาพคั่นที่ต้นและท้ายวิดีโอที่มีความยาว ซึ่งจะช่วยให้อัตราการรีเฟรชของจอแสดงผลตรงกับอัตราเฟรมของวิดีโอ และหลีกเลี่ยงข้อบกพร่องในการแปลงอัตราเฟรม เช่น การกระตุกแบบ 3:2 Pulldown สำหรับการเล่นภาพยนตร์
ด้วยเหตุนี้ คุณจึงเปิดใช้การเปลี่ยนอัตราการรีเฟรชแบบไม่ราบรื่นได้หากทั้งผู้ใช้และแอปเลือกใช้ ดังนี้
- ผู้ใช้: หากต้องการเลือกใช้ ผู้ใช้สามารถเปิดใช้การตั้งค่าผู้ใช้จับคู่อัตราเฟรมของเนื้อหา
- แอป: หากต้องการเลือกใช้ แอปสามารถส่ง
CHANGE_FRAME_RATE_ALWAYSไปยังsetFrameRate()
เราขอแนะนำให้ใช้ CHANGE_FRAME_RATE_ALWAYS เสมอสำหรับวิดีโอที่มีความยาวมาก เช่น ภาพยนตร์ เนื่องจากประโยชน์ของการจับคู่อัตราเฟรมของวิดีโอมีมากกว่าการหยุดชะงักที่เกิดขึ้นเมื่อเปลี่ยนอัตราการรีเฟรช
คำแนะนำเพิ่มเติม
ทำตามคำแนะนำต่อไปนี้สำหรับสถานการณ์ที่พบบ่อย
หลายแพลตฟอร์ม
แพลตฟอร์ม Android ออกแบบมาเพื่อจัดการสถานการณ์ที่มีหลายแพลตฟอร์มซึ่งมีการตั้งค่าอัตราเฟรมที่แตกต่างกันได้อย่างถูกต้อง เมื่อแอปมีหลายแพลตฟอร์มที่มีอัตราเฟรมต่างกัน ให้เรียกใช้ setFrameRate() ด้วยอัตราเฟรมที่ถูกต้องสำหรับแต่ละแพลตฟอร์ม แม้ว่าอุปกรณ์จะเรียกใช้แอปหลายแอปพร้อมกันโดยใช้โหมดแยกหน้าจอหรือโหมดการแสดงภาพซ้อนภาพ แต่แต่ละแอปก็สามารถเรียกใช้ setFrameRate() สำหรับแพลตฟอร์มของตนเองได้อย่างปลอดภัย
แพลตฟอร์มไม่เปลี่ยนเป็นอัตราเฟรมของแอป
แม้ว่าอุปกรณ์จะรองรับอัตราเฟรมที่แอประบุในการเรียกใช้ setFrameRate() แต่ก็มีบางกรณีที่อุปกรณ์จะไม่เปลี่ยนการแสดงผลเป็นอัตราการรีเฟรชนั้น ตัวอย่างเช่น พื้นผิวที่มีลำดับความสำคัญสูงกว่าอาจมีการตั้งค่าอัตราเฟรมที่แตกต่างกัน หรืออุปกรณ์อาจอยู่ในโหมดประหยัดแบตเตอรี่ (ตั้งค่าข้อจำกัดเกี่ยวกับอัตราการรีเฟรชจอแสดงผลเพื่อประหยัดแบตเตอรี่) แอปยังคงต้องทำงานอย่างถูกต้องเมื่ออุปกรณ์ไม่เปลี่ยนอัตราการรีเฟรชการแสดงผลเป็นการตั้งค่าอัตราเฟรมของแอป แม้ว่าอุปกรณ์จะเปลี่ยนภายใต้สถานการณ์ปกติก็ตาม
แอปจะเป็นผู้กำหนดวิธีตอบสนองเมื่ออัตราการรีเฟรชของจอแสดงผลไม่ตรงกับอัตราเฟรมของแอป สำหรับวิดีโอ อัตราเฟรมจะคงที่ตามวิดีโอต้นฉบับ และจะต้องใช้การพูลดาวน์เพื่อแสดงเนื้อหาวิดีโอ เกมอาจเลือกที่จะพยายามทำงานที่อัตราการรีเฟรชของจอแสดงผลแทนที่จะคงอัตราเฟรมที่ต้องการไว้ แอปไม่ควรเปลี่ยนค่าที่ส่งไปยัง setFrameRate() โดยอิงตามสิ่งที่แพลตฟอร์มทำ โดยควรตั้งค่าเป็นอัตราเฟรมที่แอปต้องการ ไม่ว่าแอปจะจัดการกับกรณีที่แพลตฟอร์มไม่ปรับให้ตรงกับคำขอของแอปอย่างไรก็ตาม ด้วยวิธีนี้ หากสภาพของอุปกรณ์เปลี่ยนแปลงไปจนสามารถใช้อัตราการรีเฟรชการแสดงผลเพิ่มเติมได้ แพลตฟอร์มจะมีข้อมูลที่ถูกต้องเพื่อเปลี่ยนไปใช้อัตราเฟรมที่แอปต้องการ
ในกรณีที่แอปจะไม่ทำงานหรือทำงานไม่ได้ที่อัตราการรีเฟรชการแสดงผล แอปควรระบุการประทับเวลาการนำเสนอสำหรับแต่ละเฟรม โดยใช้กลไกอย่างใดอย่างหนึ่งของแพลตฟอร์มในการตั้งค่าการประทับเวลาการนำเสนอ ดังนี้
การใช้การประทับเวลาเหล่านี้จะช่วยป้องกันไม่ให้แพลตฟอร์มแสดงเฟรมแอปเร็วเกินไป ซึ่งจะส่งผลให้เกิดการกระตุกโดยไม่จำเป็น การใช้การประทับเวลาการนำเสนอเฟรมอย่างถูกต้องนั้นค่อนข้างซับซ้อน สำหรับเกม โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการหลีกเลี่ยงภาพสั่นไหวในคู่มือการกำหนดอัตราเฟรม และพิจารณาใช้ไลบรารีการกำหนดอัตราเฟรมของ Android
ในบางกรณี แพลตฟอร์มอาจเปลี่ยนไปใช้จำนวนเท่าของอัตราเฟรมที่แอปกำหนดไว้ใน setFrameRate() เช่น แอปอาจเรียกใช้ setFrameRate() ด้วยความถี่ 60Hz และอุปกรณ์อาจเปลี่ยนการแสดงผลเป็น 120Hz สาเหตุหนึ่งที่อาจทำให้เกิดปัญหานี้คือแอปอื่นมีแพลตฟอร์มที่มีการตั้งค่าอัตราเฟรมเป็น 24Hz ในกรณีนี้ การแสดงผลที่ 120Hz จะช่วยให้ทั้งพื้นผิว 60Hz และพื้นผิว 24Hz ทำงานได้โดยไม่ต้องใช้การดึงลง
เมื่อจอแสดงผลทำงานที่อัตราเฟรมหลายเท่าของแอป แอปควรระบุการประทับเวลาการนำเสนอสำหรับแต่ละเฟรมเพื่อหลีกเลี่ยงการกระตุกโดยไม่จำเป็น สำหรับเกม ไลบรารีการเว้นระยะเฟรมของ Android จะช่วยในการตั้งค่าการประทับเวลาการนำเสนอเฟรมอย่างถูกต้อง
setFrameRate() เทียบกับ preferredDisplayModeId
WindowManager.LayoutParams.preferredDisplayModeId
เป็นอีกวิธีหนึ่งที่แอปสามารถระบุอัตราเฟรมของตนเองไปยังแพลตฟอร์มได้ แอปบางแอปต้องการเปลี่ยนเฉพาะอัตราการรีเฟรชของจอแสดงผลแทนที่จะเปลี่ยนการตั้งค่าโหมดการแสดงผลอื่นๆ เช่น ความละเอียดในการแสดงผล โดยทั่วไป ให้ใช้ setFrameRate() แทน preferredDisplayModeId ฟังก์ชัน setFrameRate()
ใช้งานได้ง่ายกว่าเนื่องจากแอปไม่จำเป็นต้องค้นหาในรายการโหมดการแสดงผลเพื่อค้นหาโหมดที่มีอัตราเฟรมที่เฉพาะเจาะจง
setFrameRate() ช่วยให้แพลตฟอร์มมีโอกาสมากขึ้นในการเลือกอัตราเฟรมที่เข้ากันได้ในสถานการณ์ที่มีหลายแพลตฟอร์มที่ทำงานด้วยอัตราเฟรมที่แตกต่างกัน ตัวอย่างเช่น ลองพิจารณาสถานการณ์ที่แอป 2 แอปทำงานในโหมดแยกหน้าจอใน Pixel 4 โดยแอปหนึ่งเล่นวิดีโอ 24Hz และอีกแอปหนึ่งแสดงรายการที่เลื่อนได้ให้ผู้ใช้เห็น Pixel 4 รองรับอัตราการรีเฟรชหน้าจอ 2 แบบ ได้แก่ 60Hz และ 90Hz เมื่อใช้ preferredDisplayModeId API ระบบจะบังคับให้แพลตฟอร์มวิดีโอเลือก 60Hz หรือ 90Hz การเรียกใช้ setFrameRate() ด้วย 24Hz จะทำให้แพลตฟอร์มวิดีโอให้ข้อมูลเพิ่มเติมเกี่ยวกับอัตราเฟรมของวิดีโอต้นฉบับแก่แพลตฟอร์ม ซึ่งช่วยให้แพลตฟอร์มเลือก 90Hz สำหรับอัตราการรีเฟรชจอแสดงผลได้ ซึ่งดีกว่า 60Hz ในสถานการณ์นี้
อย่างไรก็ตาม มีบางสถานการณ์ที่ควรใช้ preferredDisplayModeId แทน setFrameRate() เช่น สถานการณ์ต่อไปนี้
- หากแอปต้องการเปลี่ยนความละเอียดหรือการตั้งค่าโหมดการแสดงผลอื่นๆ ให้ใช้
preferredDisplayModeId - แพลตฟอร์มจะเปลี่ยนโหมดการแสดงผลเพื่อตอบสนองต่อการเรียกใช้
setFrameRate()ก็ต่อเมื่อการเปลี่ยนโหมดใช้ทรัพยากรน้อยและผู้ใช้ไม่น่าจะสังเกตเห็น หากแอปต้องการเปลี่ยนอัตราการรีเฟรชการแสดงผลแม้ว่าจะต้องเปลี่ยนโหมดอย่างหนัก (เช่น ในอุปกรณ์ Android TV) ให้ใช้preferredDisplayModeId - แอปที่ไม่สามารถจัดการจอแสดงผลที่ทำงานด้วยอัตราเฟรมหลายเท่าของแอป ซึ่งต้องตั้งค่าการประทับเวลาการนำเสนอในแต่ละเฟรม ควรใช้
preferredDisplayModeId
setFrameRate() เทียบกับ preferredRefreshRate
WindowManager.LayoutParams#preferredRefreshRate
ตั้งค่าอัตราเฟรมที่ต้องการในหน้าต่างของแอป และอัตราดังกล่าวจะใช้ได้กับทุกแพลตฟอร์มภายในหน้าต่าง แอปควรระบุอัตราเฟรมที่ต้องการโดยไม่คำนึงถึงอัตราการรีเฟรชที่อุปกรณ์รองรับ เช่นเดียวกับ setFrameRate() เพื่อให้ตัวจัดกำหนดการทราบอัตราเฟรมที่แอปต้องการได้ดีขึ้น
ระบบจะไม่สนใจ preferredRefreshRate สำหรับแพลตฟอร์มที่ใช้ setFrameRate() โดยทั่วไป ให้ใช้ setFrameRate() หากเป็นไปได้
preferredRefreshRate เทียบกับ preferredDisplayModeId
หากแอปต้องการเปลี่ยนเฉพาะอัตราการรีเฟรชที่ต้องการ เราขอแนะนำให้ใช้ preferredRefreshRate แทน preferredDisplayModeId
หลีกเลี่ยงการเรียกใช้ setFrameRate() บ่อยเกินไป
แม้ว่าการเรียกใช้ setFrameRate() จะไม่ส่งผลต่อประสิทธิภาพมากนัก แต่แอปควรหลีกเลี่ยงการเรียกใช้ setFrameRate() ทุกเฟรมหรือหลายครั้งต่อวินาที การเรียกใช้ setFrameRate() มีแนวโน้มที่จะส่งผลให้เกิดการเปลี่ยนแปลงอัตราการรีเฟรชการแสดงผล ซึ่งอาจส่งผลให้เฟรมหายไประหว่างการเปลี่ยน
คุณควรหาอัตราเฟรมที่ถูกต้องล่วงหน้าและเรียกใช้ setFrameRate() เพียงครั้งเดียว
การใช้งานสำหรับเกมหรือแอปอื่นๆ ที่ไม่ใช่วิดีโอ
แม้ว่าวิดีโอจะเป็น Use Case หลักสำหรับ setFrameRate() API แต่ก็สามารถใช้กับแอปอื่นๆ ได้ ตัวอย่างเช่น เกมที่ตั้งใจจะไม่ทำงานสูงกว่า 60Hz (เพื่อลดการใช้พลังงานและทำให้เล่นเกมได้นานขึ้น) สามารถเรียกใช้ Surface.setFrameRate(60, Surface.FRAME_RATE_COMPATIBILITY_DEFAULT) ได้ ด้วยวิธีนี้ อุปกรณ์ที่ทำงานที่ 90Hz โดยค่าเริ่มต้นจะทำงานที่ 60Hz แทนขณะที่เกมทำงานอยู่ ซึ่งจะช่วยหลีกเลี่ยงการกระตุกที่อาจเกิดขึ้นหากเกมทำงานที่ 60Hz ขณะที่จอแสดงผลทำงานที่ 90Hz
การใช้ FRAME_RATE_COMPATIBILITY_FIXED_SOURCE
FRAME_RATE_COMPATIBILITY_FIXED_SOURCE มีไว้สำหรับแอปวิดีโอเท่านั้น สำหรับการใช้งานที่ไม่ใช่วิดีโอ ให้ใช้ FRAME_RATE_COMPATIBILITY_DEFAULT
การเลือกกลยุทธ์สำหรับการเปลี่ยนอัตราเฟรม
- เราขอแนะนำอย่างยิ่งว่าเมื่อแอปแสดงวิดีโอที่เล่นเป็นเวลานาน เช่น ภาพยนตร์ ให้เรียกใช้
setFrameRate(fps, FRAME_RATE_COMPATIBILITY_FIXED_SOURCE, CHANGE_FRAME_RATE_ALWAYS)โดยที่ fps คืออัตราเฟรมของวิดีโอ - เราขอแนะนำอย่างยิ่งไม่ให้แอปเรียกใช้
setFrameRate()ด้วยCHANGE_FRAME_RATE_ALWAYSเมื่อคุณคาดว่าการเล่นวิดีโอจะใช้เวลาหลายนาทีหรือน้อยกว่านั้น
ตัวอย่างการผสานรวมสำหรับแอปเล่นวิดีโอ
เราขอแนะนำให้ทำตามขั้นตอนต่อไปนี้เพื่อผสานรวมการเปลี่ยนอัตราการรีเฟรชในแอปเล่นวิดีโอ
- กำหนด
changeFrameRateStrategyดังนี้- หากเล่นวิดีโอที่มีความยาวมาก เช่น ภาพยนตร์ ให้ใช้
MATCH_CONTENT_FRAMERATE_ALWAYS - หากเล่นวิดีโอสั้น เช่น ตัวอย่างภาพยนตร์ ให้ใช้
CHANGE_FRAME_RATE_ONLY_IF_SEAMLESS
- หากเล่นวิดีโอที่มีความยาวมาก เช่น ภาพยนตร์ ให้ใช้
- หาก
changeFrameRateStrategyเป็นCHANGE_FRAME_RATE_ONLY_IF_SEAMLESSให้ไปที่ขั้นตอนที่ 4 - ตรวจหาว่าการเปลี่ยนอัตราการรีเฟรชแบบไม่ราบรื่นกำลังจะเกิดขึ้นหรือไม่โดยตรวจสอบว่าข้อเท็จจริงทั้ง 2 ข้อต่อไปนี้เป็นจริง
- การเปลี่ยนโหมดอย่างราบรื่นไม่สามารถทำได้จากอัตราการรีเฟรชปัจจุบัน (สมมติว่าเป็น C) ไปยังอัตราเฟรมของวิดีโอ (สมมติว่าเป็น V) กรณีนี้จะเกิดขึ้นหาก C และ V แตกต่างกัน และ
Display.getMode().getAlternativeRefreshRatesไม่มีผลคูณของ V - ผู้ใช้เลือกใช้การเปลี่ยนแปลงอัตราการรีเฟรชแบบไม่ราบรื่น คุณสามารถตรวจจับได้โดยตรวจสอบว่า
DisplayManager.getMatchContentFrameRateUserPreferenceแสดงผลเป็นMATCH_CONTENT_FRAMERATE_ALWAYSหรือไม่
- การเปลี่ยนโหมดอย่างราบรื่นไม่สามารถทำได้จากอัตราการรีเฟรชปัจจุบัน (สมมติว่าเป็น C) ไปยังอัตราเฟรมของวิดีโอ (สมมติว่าเป็น V) กรณีนี้จะเกิดขึ้นหาก C และ V แตกต่างกัน และ
- หากต้องการให้การเปลี่ยนเป็นไปอย่างราบรื่น ให้ทำดังนี้
- เรียกใช้
setFrameRateและส่งfps,FRAME_RATE_COMPATIBILITY_FIXED_SOURCEและchangeFrameRateStrategyโดยที่fpsคืออัตราเฟรมของวิดีโอ - เริ่มเล่นวิดีโอ
- เรียกใช้
- หากกำลังจะมีการเปลี่ยนโหมดแบบไม่ราบรื่น ให้ทำดังนี้
- แสดง UX เพื่อแจ้งให้ผู้ใช้ทราบ โปรดทราบว่าเราขอแนะนำให้คุณใช้วิธีที่ผู้ใช้สามารถปิด UX นี้และข้ามความล่าช้าเพิ่มเติมในขั้นตอนที่ 5.ง. เนื่องจากความล่าช้าที่แนะนำของเรานั้นมากกว่าที่จำเป็นบนจอแสดงผลที่มีเวลาในการสลับที่เร็วกว่า
- เรียกใช้
setFrameRateและส่งfps,FRAME_RATE_COMPATIBILITY_FIXED_SOURCEและCHANGE_FRAME_RATE_ALWAYSโดยที่fpsคืออัตราเฟรมของวิดีโอ - รอให้
onDisplayChangedโทรกลับ - รอ 2 วินาทีเพื่อให้การเปลี่ยนโหมดเสร็จสมบูรณ์
- เริ่มเล่นวิดีโอ
ซูโดโค้ดที่รองรับเฉพาะการเปลี่ยนอัตโนมัติมีดังนี้
SurfaceControl.Transaction transaction = new SurfaceControl.Transaction();
transaction.setFrameRate(surfaceControl,
contentFrameRate,
FRAME_RATE_COMPATIBILITY_FIXED_SOURCE,
CHANGE_FRAME_RATE_ONLY_IF_SEAMLESS);
transaction.apply();
beginPlayback();
ซูโดโค้ดเพื่อรองรับการเปลี่ยนอัตโนมัติและไม่ราบรื่นตามที่อธิบายไว้ข้างต้นมีดังนี้
SurfaceControl.Transaction transaction = new SurfaceControl.Transaction();
if (isSeamlessSwitch(contentFrameRate)) {
transaction.setFrameRate(surfaceControl,
contentFrameRate,
FRAME_RATE_COMPATIBILITY_FIXED_SOURCE,
CHANGE_FRAME_RATE_ONLY_IF_SEAMLESS);
transaction.apply();
beginPlayback();
} else if (displayManager.getMatchContentFrameRateUserPreference()
== MATCH_CONTENT_FRAMERATE_ALWAYS) {
showRefreshRateSwitchUI();
sleep(shortDelaySoUserSeesUi);
displayManager.registerDisplayListener(…);
transaction.setFrameRate(surfaceControl,
contentFrameRate,
FRAME_RATE_COMPATIBILITY_FIXED_SOURCE,
CHANGE_FRAME_RATE_ALWAYS);
transaction.apply();
waitForOnDisplayChanged();
sleep(twoSeconds);
hideRefreshRateSwitchUI();
beginPlayback();
}