อัตราเฟรม

API อัตราเฟรมช่วยให้แอปแจ้งแพลตฟอร์ม Android เกี่ยวกับอัตราเฟรมที่ต้องการได้ และพร้อมใช้งานในแอปที่กำหนดเป้าหมายเป็น Android 11 (ระดับ API 30) ขึ้นไป โดยปกติแล้ว อุปกรณ์ส่วนใหญ่จะรองรับอัตราการรีเฟรชหน้าจอเพียงอัตราเดียว ซึ่งมักจะเป็น 60Hz แต่ตอนนี้สถานการณ์ได้เปลี่ยนไปแล้ว ปัจจุบันอุปกรณ์หลายรุ่นรองรับอัตราการรีเฟรชเพิ่มเติม เช่น 90Hz หรือ 120Hz อุปกรณ์บางเครื่องรองรับการเปลี่ยนอัตราการรีเฟรชที่ราบรื่น ส่วนอุปกรณ์อื่นๆ จะแสดงหน้าจอสีดำเป็นเวลาสั้นๆ ซึ่งโดยปกติจะใช้เวลา 1 วินาที

วัตถุประสงค์หลักของ API คือการช่วยให้แอปใช้ประโยชน์จากอัตราการรีเฟรชจอแสดงผลที่รองรับทั้งหมดได้ดียิ่งขึ้น เช่น แอปที่เล่นวิดีโอ 24Hz ซึ่งเรียกใช้ setFrameRate() อาจส่งผลให้อุปกรณ์เปลี่ยนอัตราการรีเฟรชจอแสดงผลจาก 60Hz เป็น 120Hz อัตราการรีเฟรชใหม่นี้ช่วยให้เล่นวิดีโอ 24Hz ได้อย่างราบรื่นและไม่กระตุก โดยไม่จำเป็นต้องใช้การแปลง 3:2 Pulldown เหมือนกับการเล่นวิดีโอเดียวกันบนจอแสดงผล 60Hz ซึ่งจะช่วยให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ดียิ่งขึ้น

การใช้งานพื้นฐาน

Android มีวิธีเข้าถึงและควบคุมหน้าจอหลายวิธี จึงมี setFrameRate() API หลายเวอร์ชัน API แต่ละเวอร์ชันจะใช้พารามิเตอร์เดียวกันและทำงานเหมือนกับเวอร์ชันอื่นๆ ดังนี้

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

คำแนะนำเพิ่มเติม

ทำตามคำแนะนำต่อไปนี้สำหรับสถานการณ์ที่พบบ่อย

หลายแพลตฟอร์ม

แพลตฟอร์ม 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 เมื่อคุณคาดว่าการเล่นวิดีโอจะใช้เวลาหลายนาทีหรือน้อยกว่านั้น

ตัวอย่างการผสานรวมสำหรับแอปเล่นวิดีโอ

เราขอแนะนำให้ทำตามขั้นตอนต่อไปนี้เพื่อผสานรวมการเปลี่ยนอัตราการรีเฟรชในแอปเล่นวิดีโอ

  1. กำหนดchangeFrameRateStrategyดังนี้
    1. หากเล่นวิดีโอที่มีความยาวมาก เช่น ภาพยนตร์ ให้ใช้ MATCH_CONTENT_FRAMERATE_ALWAYS
    2. หากเล่นวิดีโอสั้น เช่น ตัวอย่างภาพยนตร์ ให้ใช้ CHANGE_FRAME_RATE_ONLY_IF_SEAMLESS
  2. หาก changeFrameRateStrategy เป็น CHANGE_FRAME_RATE_ONLY_IF_SEAMLESS ให้ไปที่ขั้นตอนที่ 4
  3. ตรวจหาว่าการเปลี่ยนอัตราการรีเฟรชแบบไม่ราบรื่นกำลังจะเกิดขึ้นหรือไม่โดยตรวจสอบว่าข้อเท็จจริงทั้ง 2 ข้อต่อไปนี้เป็นจริง
    1. การเปลี่ยนโหมดอย่างราบรื่นไม่สามารถทำได้จากอัตราการรีเฟรชปัจจุบัน (สมมติว่าเป็น C) ไปยังอัตราเฟรมของวิดีโอ (สมมติว่าเป็น V) กรณีนี้จะเกิดขึ้นหาก C และ V แตกต่างกัน และ Display.getMode().getAlternativeRefreshRates ไม่มีผลคูณของ V
    2. ผู้ใช้เลือกใช้การเปลี่ยนแปลงอัตราการรีเฟรชแบบไม่ราบรื่น คุณสามารถตรวจจับได้โดยตรวจสอบว่า DisplayManager.getMatchContentFrameRateUserPreference แสดงผลเป็น MATCH_CONTENT_FRAMERATE_ALWAYS หรือไม่
  4. หากต้องการให้การเปลี่ยนเป็นไปอย่างราบรื่น ให้ทำดังนี้
    1. เรียกใช้ setFrameRate และส่ง fps, FRAME_RATE_COMPATIBILITY_FIXED_SOURCE และ changeFrameRateStrategy โดยที่ fps คืออัตราเฟรมของวิดีโอ
    2. เริ่มเล่นวิดีโอ
  5. หากกำลังจะมีการเปลี่ยนโหมดแบบไม่ราบรื่น ให้ทำดังนี้
    1. แสดง UX เพื่อแจ้งให้ผู้ใช้ทราบ โปรดทราบว่าเราขอแนะนำให้คุณใช้วิธีที่ผู้ใช้สามารถปิด UX นี้และข้ามความล่าช้าเพิ่มเติมในขั้นตอนที่ 5.ง. เนื่องจากความล่าช้าที่แนะนำของเรานั้นมากกว่าที่จำเป็นบนจอแสดงผลที่มีเวลาในการสลับที่เร็วกว่า
    2. เรียกใช้ setFrameRate และส่ง fps, FRAME_RATE_COMPATIBILITY_FIXED_SOURCE และ CHANGE_FRAME_RATE_ALWAYS โดยที่ fps คืออัตราเฟรมของวิดีโอ
    3. รอให้ onDisplayChanged โทรกลับ
    4. รอ 2 วินาทีเพื่อให้การเปลี่ยนโหมดเสร็จสมบูรณ์
    5. เริ่มเล่นวิดีโอ

ซูโดโค้ดที่รองรับเฉพาะการเปลี่ยนอัตโนมัติมีดังนี้

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();
}