คู่มือการตั้งค่าความเข้ากันได้ของแอปบนหน้าจอขนาดใหญ่

หน้านี้มีคำแนะนำในการตั้งค่าแบบครอบคลุมและดัชนีสำหรับการซ้อนทับการกำหนดค่าความเข้ากันได้ของแอป Android บนหน้าจอขนาดใหญ่

Display

ส่วนนี้แสดงการตั้งค่าการกำหนดค่าทั้งหมดที่มีผลต่อการกำหนดค่าระดับการแสดงผล

ชื่อ ตำแหน่ง ประเภท ค่าเริ่มต้น
ignoreOrientationRequest display_settings.xml การกำหนดค่า false
true สำหรับหน้าจอขนาดใหญ่ (>= 600dp)
คำอธิบาย
เปิดใช้การหมุนกิจกรรมที่มีการวางแนวคงที่ของผู้ใช้โดยไม่เสียค่าใช้จ่ายบน จอแสดงผลที่ระบุ
ตัวอย่าง 
          <display-settings>
              <config identifier="0" />
              <display
                  name="<display's uniqueId>"
                  ignoreOrientationRequest="true"/>
          </display-settings>

กรณีการใช้งานหรือบริบท
จอแสดงผลไม่สนใจการวางแนวที่ขอของแอปทั้งหมด และแอปจะมีแถบดำด้านบน-ล่างของภาพ
ใช้ในอุปกรณ์หน้าจอขนาดใหญ่และ Android Automotive OS ทั้งหมด นี่คือ ค่าเริ่มต้นสำหรับอุปกรณ์หน้าจอขนาดใหญ่ทั้งหมดที่ใช้ smallestScreenWidthDp >= 600dp ใน Android 16 ขึ้นไป
config_letterboxIsDisplayRotationImmersiveAppCompatPolicyEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
เปิดใช้นโยบายความเข้ากันได้ของการหมุนสำหรับแอปที่สมจริงซึ่ง ป้องกันการหมุนอัตโนมัติเป็นแนวหน้าจอที่ไม่เหมาะสมขณะอยู่ใน โหมดเต็มหน้าจอ การดำเนินการนี้จำเป็นเนื่องจากแอปที่สมจริง เช่น เกม มักไม่ได้ปรับให้เหมาะกับทุกการวางแนว และอาจมี UX ที่ไม่ดี เมื่อหมุน นอกจากนี้ เกมบางเกมยังอาศัยเซ็นเซอร์ในการเล่นเกม ดังนั้นผู้ใช้จึงอาจทริกเกอร์การหมุนดังกล่าวโดยไม่ตั้งใจเมื่อเปิดการหมุนอัตโนมัติไว้
มีผลเฉพาะในกรณีที่เปิดใช้ ignoreOrientationRequest

กรณีการใช้งานหรือบริบท
ล็อกการหมุนสำหรับแอปที่สมจริง

สัดส่วนภาพ

ส่วนนี้แสดงการตั้งค่าการกำหนดค่าทั้งหมดที่มีผลต่อการกำหนดค่าระดับกิจกรรม สำหรับสัดส่วนภาพ

ชื่อ ตำแหน่ง ประเภท ค่าเริ่มต้น
config_fixedOrientationLetterboxAspectRatio frameworks/base/core/res/res/values/config.xml Float 0.0
คำอธิบาย
กำหนดค่าสัดส่วนภาพของแถบดำบนและล่างสำหรับแนวนอนหรือแนวตั้ง ระบบจะไม่สนใจค่าที่น้อยกว่าหรือเท่ากับ 1.0

กรณีการใช้งานหรือบริบท
กำหนดค่าสัดส่วนภาพเริ่มต้นของอุปกรณ์ที่ใช้ได้กับแอปส่วนใหญ่ที่แสดงแถบดำด้านบนและด้านล่าง มักมีสัดส่วนภาพใกล้เคียงกับสี่เหลี่ยมจัตุรัส
config_letterboxIsSplitScreenAspectRatioForUnresizableAppsEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
กำหนดว่าจะใช้สัดส่วนภาพของโหมดแยกหน้าจอเป็นสัดส่วนภาพเริ่มต้นสำหรับแอปที่ปรับขนาดไม่ได้หรือไม่

กรณีการใช้งานหรือบริบท
แอปส่วนใหญ่ที่ปรับขนาดไม่ได้คาดหวังเลย์เอาต์โทรศัพท์แบบแท่งลูกกวาดแนวตั้ง
config_letterboxIsDisplayAspectRatioForFixedOrientationLetterboxEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
กำหนดว่าจะใช้อัตราส่วนกว้างยาวของจอแสดงผลเป็นสัดส่วนภาพเริ่มต้นสำหรับแอปทั้งหมดที่แสดงแบบมีแถบดำด้านบน-ล่างของภาพ

Use Case หรือบริบท
การกำหนดค่าเพื่อใช้อัตราส่วนกว้างยาวของจอแสดงผลแบบเป็นโปรแกรม แทนการกำหนดค่าจำนวนลอยตัว

กล้อง

ส่วนนี้แสดงการตั้งค่าการกำหนดค่าทั้งหมดที่มีผลต่อแอปเมื่อมีการเรียกกลับของ onCameraOpened การตั้งค่าเหล่านี้อาจส่งผลต่อการแสดงผล กิจกรรม และการกำหนดค่ากล้อง

ชื่อ ตำแหน่ง ประเภท ค่าเริ่มต้น
config_isWindowManagerCameraCompatTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
เปิดใช้การจัดการความเข้ากันได้ของกล้องสำหรับปัญหาที่เกิดจาก การวางแนวที่ไม่ตรงกันระหว่างบัฟเฟอร์ของกล้องกับหน้าต่างแอป
ซึ่งรวมถึงการหมุนกิจกรรมที่กำหนดการวางแนวไว้แล้ว ที่เชื่อมต่อกับกล้องในโหมดเต็มหน้าจอและการแสดงเคล็ดลับเครื่องมือในโหมด แยกหน้าจอ
ปิดใช้การหมุนบังคับได้โดยการลบล้างต่อแอป ดังนี้ OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION.

กรณีการใช้งานหรือบริบท
แก้ไขตัวอย่างกล้องที่หมุนโดยบังคับ หมุนจอแสดงผลให้ตรงกับ การวางแนวที่แอปขอ
config_isWindowManagerCameraCompatSplitScreenAspectRatioEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
กำหนดว่ากิจกรรมจะใช้อัตราส่วนของหน้าจอแยกหรือไม่เมื่อเปิดใช้การประมวลผลความเข้ากันได้ของกล้อง และกิจกรรมเชื่อมต่อกับ กล้องในโหมดเต็มหน้าจอ

กรณีการใช้งานหรือบริบท
แก้ไขการแสดงตัวอย่างกล้องที่ยืดออกโดยการใส่แถบดำด้านบนและด้านล่างของกิจกรรมให้อัตราส่วนคล้ายกับแท่งลูกกวาด
มักใช้ร่วมกับการเปิดใช้การบังคับหมุน (config_isWindowManagerCameraCompatTreatmentEnabled และ camera.enable_landscape_to_portrait) ในอุปกรณ์แนวนอนเพื่อแก้ไขปัญหาความเข้ากันได้ของกล้องที่ยืดออกโดยการจำลองสัดส่วนภาพแบบแท่งลูกกวาดแนวตั้งสำหรับกิจกรรม
camera.enable_landscape_to_portrait พร็อพเพอร์ตี้ ระบบ Bool false
คำอธิบาย
ควบคุมการเข้าถึง OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT กลุ่มทดสอบ
บังคับให้กล้องครอบตัดและหมุนเอาต์พุต 90 องศาในกล้องที่มีการวางแนวแนวนอนตามธรรมชาติเพื่อจำลองการวางแนวแนวตั้งตามธรรมชาติ การวางแนวเซ็นเซอร์กล้องที่รายงานจะเป็นแนวตั้งสำหรับกล้องแนวนอนทั้งหมดในอุปกรณ์ แอปจำนวนมากไม่รองรับสถานการณ์นี้และแสดงรูปภาพที่ยืดออก

กรณีการใช้งานหรือบริบท
เปิดใช้การหมุน HAL ของกล้องและการครอบตัด ดูข้อมูลเพิ่มเติม เกี่ยวกับการปรับแต่งได้ที่หมุน ครอบตัด ปรับขนาด
เพิ่มข้อมูลต่อไปนี้ลงในไฟล์ mk ในเวลาบิลด์: PRODUCT_PROPERTY_OVERRIDES += camera.enable_landscape_to_portrait=true
การดำเนินการนี้กำหนดให้อุปกรณ์ต้องรองรับ SCALER_ROTATE_AND_CROP ใน HAL ดู CameraCharacteristics#SCALER_AVAILABLE_ROTATE_AND_CROP_MODES
ดูคำแนะนำในการติดตั้งใช้งานเฉพาะ HAL สำหรับ SCALER_ROTATE_AND_CROP ได้ที่ metadata_definitions.xml
config_isCameraCompatSimulateRequestedOrientationTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool true
คำอธิบาย
ระบุว่าเปิดใช้การจัดการความเข้ากันได้ของกล้อง ซึ่งจำลองการวางแนวที่แอปขอหรือไม่ วัตถุประสงค์ของการทดสอบคือเพื่อลดปัญหาที่เกิดจาก การวางแนวบัฟเฟอร์ของกล้องและหน้าต่างแอปไม่ตรงกัน ซึ่งรวมถึงกิจกรรมที่กำหนดการวางแนวแบบแถบดำด้านบนและด้านล่างซึ่งเชื่อมต่อกับกล้อง การครอบตัดบัฟเฟอร์ของกล้อง (หมุนและครอบตัด) และการจำกัดการหมุนจอแสดงผลใน Sandbox ให้ตรงกับการวางแนวที่แอปคาดหวัง

กรณีการใช้งานหรือบริบท
จำลอง การวางแนวที่ขอสำหรับกิจกรรมของกล้องใน
  • โหมดหน้าต่างรูปแบบอิสระ
  • คำขอการวางแนวคงที่นอกเหนือจากโหมด locked หรือ nosensor

ในการตั้งค่านี้ใน Android 17 ขึ้นไปจะปิดใช้ การบังคับให้หมุนจาก config_isWindowManagerCameraCompatTreatmentEnabled และรวมนโยบายสำหรับการแซนด์บ็อกซ์การหมุนจอแสดงผล, การแสดงผลแบบจอกว้าง, และการหมุนและครอบตัดกล้อง สำหรับแอปกล้องที่กำหนดการวางแนว
config_isCameraCompatSimReqOrientationLandscapeTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
ระบุว่ามีการเปิดใช้การประมวลผลความเข้ากันได้ของกล้อง ที่จำลองการวางแนวที่แอปขอสำหรับกล้องแนวนอนหรือไม่ จุดประสงค์ของการจัดการคือเพื่อลดปัญหาที่เกิดจากแอปที่ฮาร์ดโค้ดเซ็นเซอร์กล้องแนวตั้ง การประมวลผล รวมถึงกิจกรรมที่ใช้การวางแนวคงที่แบบ Letterbox ซึ่งเชื่อมต่อกับ กล้อง การครอบตัดบัฟเฟอร์ของกล้อง (หมุนและครอบตัด) การวางแนว เซ็นเซอร์เป็นแนวตั้ง และการจำกัดการหมุนจอแสดงผลใน Sandbox ให้ตรงกับ การวางแนวที่แอปคาดหวัง

กรณีการใช้งานหรือบริบท
ใน Android 17 ขึ้นไป การประมวลผลนี้จะเหมือนกับ การประมวลผลการจำลองการวางแนวที่ขอสำหรับ config_isCameraCompatSimulateRequestedOrientationTreatmentEnabled แต่สำหรับอุปกรณ์ที่มีกล้องแนวนอน

พื้นหลังและ UI

ส่วนนี้แสดงการตั้งค่าการกำหนดค่าทั้งหมดที่ใช้กับพื้นผิวของ เลเยอร์แถบดำบนล่างสำหรับการปรับแต่ง UI หรือที่ระดับกิจกรรม

ชื่อ ตำแหน่ง ประเภท ค่าเริ่มต้น
config_letterboxActivityCornersRadius frameworks/base/core/res/res/values/config.xml Integer 0
คำอธิบาย
กำหนดค่ารัศมีมุมสำหรับกิจกรรมที่แสดงในโหมด Letterbox ค่าที่น้อยกว่า 0 จะเปิดใช้มุมโค้งที่มีรัศมีเท่ากับค่าต่ำสุดระหว่างรัศมีมุมล่างของอุปกรณ์ ค่าเริ่มต้นของ 0 จะปิดตรรกะมุมโค้งมน ใน AppCompatLetterboxPolicy

กรณีการใช้งานหรือบริบท
โดยปกติจะกำหนดค่าให้ตรงกับมุมโค้งมน ของอุปกรณ์จริง
config_letterboxIsEnabledForTranslucentActivities frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
กำหนดว่าจะเปิดใช้ลักษณะการทำงานที่เฉพาะเจาะจงสำหรับกิจกรรมกึ่งโปร่งใส การแสดงจดหมาย

กรณีการใช้งานหรือบริบท
เปิดใช้กิจกรรมกึ่งโปร่งใสหรือโมดอลให้แสดงจดหมายและ จำกัดอยู่ในการกำหนดค่ากิจกรรมที่แสดงจดหมาย นโยบาย มีผลบังคับใช้ใน TransparentPolicy
config_isCompatFakeFocusEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
กำหนดค่าว่าจะเปิดใช้การส่งโฟกัสปลอมเพื่อความเข้ากันได้สำหรับกิจกรรมที่กลับมาทำงานต่อในโหมดแยกหน้าจอหรือไม่
การดำเนินการนี้จำเป็นเนื่องจากเอนจินเกมบางตัวจะรอรับโฟกัสก่อนที่จะวาดเนื้อหาของ แอป ซึ่งไม่ได้ระบุไว้โดยค่าเริ่มต้นในโหมดหลายหน้าต่าง

กรณีการใช้งานหรือบริบท
Flag เดิมเพื่อใช้การประมวลผลความเข้ากันได้สำหรับเอนจินเกม Unity สำหรับแอปที่กลายเป็นสีดำหลังจากเข้าสู่โหมดแยกหน้าจอและจะวาดหลังจากที่ผู้ใช้ แตะและโฟกัสแอปเท่านั้น
config_letterboxBackgroundType frameworks/base/core/res/res/values/config.xml Integer 0
คำอธิบาย
กำหนดค่าลักษณะที่มุมของพื้นหลังจดหมาย
  • 0 - พื้นหลังสีทึบโดยใช้สีที่ระบุใน R.color.config_letterboxBackgroundColor
  • 1 - สีที่ระบุใน R.attr.colorBackground สำหรับแอปพลิเคชัน ที่มีแถบดำด้านบน-ล่างของภาพ
  • 2 - สีที่ระบุใน R.attr.colorBackgroundFloating สำหรับ แอปพลิเคชันที่มีแถบดำด้านบนและด้านล่าง
  • 3 - วอลเปเปอร์ที่มีการเบลอแบบหรี่แสงหรือมีเลเยอร์สีเข้ม พารามิเตอร์ต่อไปนี้อย่างน้อย 1 รายการต้องมากกว่า 0 config_letterboxBackgroundWallpaperBlurRadius หรือ config_letterboxBackgroundWallpaperDarkScrimAlpha หากไม่เป็นเช่นนั้น หรือ หากมีการระบุรัศมีการเบลอ แต่อุปกรณ์ไม่รองรับการเบลอและมีการเลือกตัวเลือกนี้ การติดตั้งใช้งานจะเป็นไปตามค่าเริ่มต้นของตัวเลือก 0 หากค่าที่ระบุ อยู่นอกช่วงนี้ ระบบจะถือว่าใช้ตัวเลือก 0


กรณีการใช้งานหรือบริบท
ฟีเจอร์นี้ยังไม่เปิดตัวเนื่องจากปัญหาด้านประสิทธิภาพที่มีอยู่ OEM สามารถสร้างการใช้งานฟีเจอร์นี้ได้ด้วยตนเอง แต่ AOSP จะไม่จัดการข้อบกพร่องใดๆ
config_letterboxBackgroundColor frameworks/base/core/res/res/values/config.xml Color @color/system_neutral1_1000
คำอธิบาย
กำหนดค่าสีของพื้นหลังแบบจดหมาย หากมีเงื่อนไขข้อใดข้อหนึ่งต่อไปนี้ true:
  • เลือกตัวเลือก 0 สำหรับ R.integer.config_letterboxBackgroundType
  • เลือกตัวเลือก 1 สำหรับ R.integer.config_letterboxBackgroundType และไม่ได้ระบุ R.attr.colorBackground สำหรับแอป
  • มีการเลือกตัวเลือก 2 สำหรับ R.integer.config_letterboxBackgroundType และไม่ได้ระบุ R.attr.colorBackgroundFloating สำหรับแอป
  • เลือกตัวเลือก 3 สำหรับ R.integer.config_letterboxBackgroundType และขอเบลอ แต่ไม่รองรับในอุปกรณ์ หรือไม่ได้ระบุทั้งอัลฟ่าของดาร์กสคริม และรัศมีการเบลอ


กรณีการใช้งานหรือบริบท
ฟีเจอร์นี้ยังไม่เปิดตัวเนื่องจากปัญหาด้านประสิทธิภาพที่มีอยู่ OEM สามารถสร้างการใช้งานฟีเจอร์นี้ได้ด้วยตนเอง แต่ AOSP จะไม่จัดการข้อบกพร่องใดๆ
config_letterboxBackgroundWallpaperBlurRadius frameworks/base/core/res/res/values/config.xml Dimen 38dp
คำอธิบาย
กำหนดค่ารัศมีการเบลอสำหรับตัวเลือก 3 ใน R.integer.config_letterboxBackgroundType ระบบจะละเว้นค่าที่น้อยกว่า 0 และใช้ 0

กรณีการใช้งานหรือบริบท
ฟีเจอร์นี้ยังไม่เปิดตัวเนื่องจากปัญหาด้านประสิทธิภาพที่มีอยู่ OEM สามารถสร้างการใช้งานฟีเจอร์นี้ได้ด้วยตนเอง แต่ AOSP จะไม่จัดการข้อบกพร่องใดๆ
config_letterboxBackgroundWallpaperDarkScrimAlpha frameworks/base/core/res/res/values/config.xml Float 0.54
คำอธิบาย
กำหนดค่าอัลฟ่าของเลเยอร์สีดำกึ่งโปร่งแสงที่แสดงเหนือพื้นหลังกล่องจดหมายของวอลเปเปอร์ เมื่อเลือกตัวเลือก 3 สำหรับ R.integer.config_letterboxBackgroundType ระบบจะละเว้นค่าที่น้อยกว่า 0 หรือมากกว่าหรือเท่ากับ 1 และใช้ 0.0 (โปร่งใส) แทน

กรณีการใช้งานหรือบริบท
ฟีเจอร์นี้ยังไม่เปิดตัวเนื่องจากปัญหาด้านประสิทธิภาพที่มีอยู่ OEM สามารถสร้างการใช้งานฟีเจอร์นี้ได้ด้วยตนเอง แต่ AOSP จะไม่จัดการข้อบกพร่องใดๆ
config_enableSelfKillRecoveryBetweenInternalDisplays frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
เมื่อ true, การย้ายจอแสดงผลระหว่างจอแสดงผลภายในจะไม่ได้รับการยกเว้นจาก ตรรกะการกู้คืนการปิดตัวเอง

กรณีการใช้งานหรือบริบท
ใน Android 17 ขึ้นไป ระบบจะเปิดใช้การกู้คืนการปิดตัวเอง เฉพาะการย้ายจอแสดงผลที่เกี่ยวข้องกับจอภาพภายนอกเท่านั้น อย่างไรก็ตาม กระบวนการนี้ยังใช้ได้กับอุปกรณ์พับที่มีความหนาแน่นต่างกันในจอแสดงผลด้านในและด้านนอกด้วย การกำหนดค่านี้จะเปิดใช้ กระบวนการสำหรับอุปกรณ์เหล่านั้น

ระยะที่เดินทางถึงได้และการวางตำแหน่ง

ส่วนนี้แสดงการตั้งค่าการกำหนดค่าทั้งหมดที่ใช้กับการกำหนดค่าระดับกิจกรรม สำหรับฟีเจอร์การช่วยเหลือพิเศษ

ชื่อ ตำแหน่ง ประเภท ค่าเริ่มต้น
config_letterboxIsHorizontalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
กำหนดค่าว่าจะเปิดใช้การเปลี่ยนตำแหน่งความสามารถในการเข้าถึงแนวนอนสำหรับ แอปที่มีแถบดำบนและล่างในโหมดการแสดงหน้าต่างแบบเต็มหน้าจอหรือไม่

กรณีการใช้งานหรือบริบท
เปลี่ยนตำแหน่งแอปแนวตั้งไปทางซ้ายหรือขวาเพื่อให้เข้าถึงได้ง่ายขึ้น
config_letterboxHorizontalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.5
คำอธิบาย
กำหนดค่าตำแหน่งแนวนอนของกึ่งกลางหน้าต่างแอปที่มีแถบดำด้านบน-ล่างของภาพ
0 สอดคล้องกับด้านซ้ายของหน้าจอ และ 1 สอดคล้องกับด้านขวา
หากค่าที่ระบุต่ำกว่า 0 หรือสูงกว่า 1 ระบบจะละเว้นค่าดังกล่าว สำหรับท่าทางที่ไม่ใช่หนังสือ ระบบจะใช้ตำแหน่งตรงกลาง (0.5) สำหรับท่าทางของหนังสือ จะใช้ตำแหน่งด้านซ้าย (0.0)

กรณีการใช้งานหรือบริบท
ค่าเริ่มต้นคือตรงกลางสำหรับแอปที่อยู่ในรูปแบบจดหมายในแนวตั้ง
config_letterboxIsVerticalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
กำหนดค่าว่าจะเปิดใช้การเปลี่ยนตำแหน่งการเข้าถึงแนวตั้งสำหรับ แอปที่มีแถบดำด้านบนและด้านล่างในโหมดการแสดงหน้าต่างแบบเต็มหน้าจอหรือไม่

กรณีการใช้งานหรือบริบท
เปลี่ยนตำแหน่งแอปแนวนอนไปที่ด้านบนหรือด้านล่างเพื่อให้เข้าถึงได้ง่ายขึ้น
config_letterboxVerticalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
คำอธิบาย
กำหนดค่าการจัดวางแนวตั้งของกึ่งกลางหน้าต่างแอปที่มีแถบดำด้านบน-ล่างของภาพ
ค่า 0 สอดคล้องกับด้านบนของหน้าจอ และ 1 สอดคล้องกับด้านล่าง ของหน้าจอ
หากค่าที่ระบุต่ำกว่า 0 หรือสูงกว่า 1 ระบบจะละเว้นค่าดังกล่าว สำหรับโหมดที่ไม่ใช่โหมดตั้งโต๊ะ ระบบจะใช้ตำแหน่งตรงกลาง (0.5) สำหรับท่าทางบนโต๊ะ ตำแหน่งด้านบน (0.0) จะ ใช้

กรณีการใช้งานหรือบริบท
กำหนดค่าให้ตรงกลางในอุปกรณ์หน้าจอขนาดใหญ่สำหรับแอปที่ มีแถบดำด้านบนและด้านล่างในแนวนอน
config_letterboxIsAutomaticReachabilityInBookModeEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
กำหนดว่าจะเปิดใช้การวางตำแหน่งการเข้าถึงแนวนอนอัตโนมัติในท่าทางหนังสือ สำหรับแอปที่มีแถบดำบนล่างในโหมดการแสดงหน้าต่างแบบเต็มหน้าจอหรือไม่

กรณีการใช้งานหรือบริบท
ช่วยให้แอปที่มีแถบดำบนล่างในแนวตั้งย้ายไปมาระหว่างซ้ายและขวาได้ เมื่ออุปกรณ์พับได้อยู่ในท่าทางหนังสือ
config_letterboxBookModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
คำอธิบาย
กำหนดค่าตำแหน่งแนวนอนของกึ่งกลางหน้าต่างแอปแบบมีแถบดำด้านบน-ล่างของภาพเมื่ออยู่ใน ท่าทางหนังสือ
0 สอดคล้องกับด้านซ้ายของหน้าจอ และ 1 สอดคล้องกับด้านขวา หากค่าที่ระบุน้อยกว่า 0 หรือมากกว่า 1 ระบบจะละเว้นค่าดังกล่าวและใช้ตำแหน่งซ้าย (0.0) แทน

กรณีการใช้งานหรือบริบท
ตัวคูณสำหรับจำนวนที่ตำแหน่งของแอปเลื่อนเมื่อ จัดตำแหน่งใหม่ในท่าทางหนังสือ
config_letterboxDefaultPositionForBookModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
คำอธิบาย
กำหนดค่าตำแหน่งแนวนอนเริ่มต้นของหน้าต่างแอปที่มีแถบปรากฏอยู่ตามขอบเมื่อเปิดใช้ การเข้าถึงและแอปอยู่ในโหมดเต็มหน้าจอในอุปกรณ์แนวนอน และในท่าทางหนังสือ เมื่อเปิดใช้ความสามารถในการเอื้อมถึงแล้ว ตำแหน่งของ จะเปลี่ยนไปมาระหว่างซ้าย กลาง และขวาได้
  • ตัวเลือก 0 - ซ้าย
  • ตัวเลือก 1 - กึ่งกลาง
  • ตัวเลือก 2 - ขวา
หากค่าที่ระบุอยู่นอกช่วงนี้ ระบบจะถือว่าใช้ตัวเลือก 0 (ซ้าย)

กรณีการใช้งานหรือบริบท
ตำแหน่งเริ่มต้นที่วางแอปในโหมด หนังสือ
config_letterboxTabletopModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
คำอธิบาย
กำหนดค่าจัดวางแนวตั้งของกึ่งกลางหน้าต่างแอปที่มีแถบดำด้านบน-ล่างของภาพเมื่ออยู่ในท่าตั้งบนโต๊ะ
ค่า 0 สอดคล้องกับด้านบนของหน้าจอ และ 1 สอดคล้องกับด้านล่าง ของหน้าจอ หากค่าที่ระบุต่ำกว่า 0 หรือสูงกว่า 1 ระบบจะละเว้นค่าดังกล่าวและใช้ตำแหน่งบนสุด 0.0 แทน

กรณีการใช้งานหรือบริบท
ตัวคูณสำหรับจำนวนที่ตำแหน่งของแอปเลื่อนใน อุปกรณ์พับได้เมื่ออยู่ในท่าตั้งบนโต๊ะ
config_letterboxDefaultPositionForTabletopModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
คำอธิบาย
กำหนดค่าตำแหน่งแนวตั้งเริ่มต้นของหน้าต่างแอปที่มีแถบปรากฏอยู่ตามขอบเมื่อเปิดใช้ การเข้าถึงและแอปอยู่ในโหมดเต็มหน้าจอในอุปกรณ์แนวตั้ง และในท่าทางบนโต๊ะ เมื่อเปิดใช้ความสามารถในการเข้าถึงแล้ว ตำแหน่งจะเปลี่ยนไปมาระหว่างด้านบน ตรงกลาง และด้านล่างได้ การกำหนดค่านี้ กำหนดค่าเริ่มต้น
  • ตัวเลือก 0 - ด้านบน
  • ตัวเลือก 1 - กึ่งกลาง
  • ตัวเลือก 2 - ด้านล่าง
หากค่าที่ระบุอยู่นอกช่วงนี้ ระบบจะถือว่าใช้ตัวเลือก 0 (ด้านบน)

กรณีการใช้งานหรือบริบท
ตำแหน่งเริ่มต้นที่วางแอปในโหมด บนโต๊ะ

การตั้งค่า

ส่วนนี้แสดงการตั้งค่าการกำหนดค่าทั้งหมดสำหรับการปรับแต่งและการเปิดใช้การตั้งค่าสัดส่วนภาพของผู้ใช้ในการตั้งค่า > แอป > สัดส่วนภาพ

ชื่อ ตำแหน่ง ประเภท ค่าเริ่มต้น
config_appCompatUserAppAspectRatioSettingsIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
กำหนดว่าจะเปิดใช้การตั้งค่าการลบล้างสัดส่วนภาพต่อผู้ใช้ต่อแอปหรือไม่

กรณีการใช้งานหรือบริบท
เปิดใช้ฟีเจอร์การตั้งค่าสัดส่วนภาพในการตั้งค่า > แอป > สัดส่วนภาพ
config_appCompatUserAppAspectRatioFullscreenIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
กำหนดค่าว่าจะเปิดใช้ตัวเลือกการลบล้างแบบเต็มหน้าจอต่อแอปในการตั้งค่าสัดส่วน ภาพของผู้ใช้หรือไม่

กรณีการใช้งานหรือบริบท
เปิดใช้ตัวเลือกเต็มหน้าจอในฟีเจอร์การตั้งค่าสัดส่วน ภาพของผู้ใช้
การตั้งค่านี้จะไม่สนใจข้อจำกัดของแอปที่ห้ามปรับขนาด สัดส่วนภาพ และ การวางแนว
config_userAspectRatioOverrideEntries packages/apps/Settings/res/values/config.xml string-array ตัวเลือกทั้งหมดจะเปิดใช้โดยค่าเริ่มต้น
คำอธิบาย
กำหนดค่าหน้าจอการตั้งค่าสัดส่วนภาพของแอปและตัวเลือกการลบล้างสัดส่วนภาพของผู้ใช้ ต้องมีความยาวและลำดับเดียวกันกับ config_userAspectRatioOverrideValues
หากมีการเปลี่ยนแปลง ให้อัปเดตตรรกะการสำรองและกู้คืนสำหรับการเลือกค่าที่ ใกล้เคียงที่สุดใน UserAspectRatioBackupManager.java ด้วย

กรณีการใช้งานหรือบริบท
การแมปสำหรับสตริงที่แสดงในการตั้งค่า
config_userAspectRatioOverrideValues packages/apps/Settings/res/values/config.xml integer-array ระบบจะใช้สตริง AOSP ทั้งหมดโดยค่าเริ่มต้น
คำอธิบาย
กำหนดค่าหน้าจอการตั้งค่าสัดส่วนภาพของแอปและตัวเลือกการลบล้างสัดส่วนภาพของผู้ใช้ ต้องมีความยาวและลำดับเดียวกันกับ config_userAspectRatioOverrideEntries ค่าต้อง สอดคล้องกับ PackageManager.UserMinAspectRatio
หากมีการเปลี่ยนแปลง ให้อัปเดตตรรกะการสำรองและกู้คืนเพื่อเลือกค่าที่ใกล้เคียงที่สุดใน UserAspectRatioBackupManager.java ด้วย

กรณีการใช้งานหรือบริบท
การแมปสำหรับตัวเลือกไปยังแบ็กเอนด์ PackageManager.UserMinAspectRatio:
  • ค่าเริ่มต้นของแอป - 0
  • แยกหน้าจอ - 1
  • สัดส่วนภาพของจอแสดงผล - 2
  • 4:3 - 3
  • 16:9 - 4
  • 3:2 - 5
  • เต็มหน้าจอ - 6
ภาพวาดแบบคงที่สำหรับธีมสว่าง packages/apps/Settings/res/drawable/ic_app_aspect_ratio_<option>.xml vector ชิ้นงานขนาดอุปกรณ์พับได้แนวนอน
Description
Configures the available drawables:


กรณีการใช้งานหรือบริบท
รูปภาพแบบคงที่ที่มีธีมสีอ่อนในแต่ละตัวเลือกในการตั้งค่า > ข้อมูลแอป > สัดส่วนภาพ
ภาพวาดแบบคงที่ในธีมมืด packages/apps/Settings/res/drawable-night/ic_app_aspect_ratio_<option>.xml vector ชิ้นงานขนาดอุปกรณ์พับได้แนวนอน
Description
Configures the available drawables:


กรณีการใช้งานหรือบริบท
รูปภาพแบบคงที่ที่มีธีมสีเข้มในแต่ละตัวเลือกในการตั้งค่า > ข้อมูลแอป > สัดส่วนภาพ
Drawable แบบไดนามิก
user_aspect_ratio_education.json		 packages/apps/Settings/res/raw/user_aspect_ratio_education.json JSON ชิ้นงานแบบไดนามิกขนาดแนวนอนสำหรับอุปกรณ์พับได้
คำอธิบาย
กำหนดค่าภาพ Lottie ใน UserAspectRatioAppsPageProvider

กรณีการใช้งานหรือบริบท
ภาพเคลื่อนไหวในรายการแอป: การตั้งค่า > แอป > สัดส่วน ภาพ

การศึกษา

ส่วนนี้แสดงการตั้งค่าการกำหนดค่าทั้งหมดสำหรับการให้ความรู้แก่ผู้ใช้เกี่ยวกับฟีเจอร์ความเข้ากันได้ของแอป

ชื่อ ตำแหน่ง ประเภท ค่าเริ่มต้น
config_letterboxIsEducationEnabled frameworks/base/core/res/res/values/config.xml Bool false
คำอธิบาย
กำหนดค่าว่าจะเปิดใช้คำแนะนำเกี่ยวกับแถบดำด้านบนและด้านล่างสำหรับแอปแบบเต็มหน้าจอที่มีแถบดำด้านบนและด้านล่างหรือไม่

กรณีการใช้งานหรือบริบท
ดูรูปที่ 1 สำหรับกรณีการใช้งานคำแนะนำเกี่ยวกับแถบดำด้านบนและด้านล่างสำหรับแอปแบบเต็มหน้าจอ
config_letterboxIsRestartDialogEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
คำอธิบาย
กำหนดค่าว่าจะเปิดใช้กล่องโต้ตอบการรีสตาร์ทแบบขยายหรือไม่

กรณีการใช้งานหรือบริบท
ดูกรณีการใช้งานกล่องโต้ตอบการรีสตาร์ทแบบขยายได้ที่รูปที่ 2
config_letterboxIsReachabilityEducationEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
คำอธิบาย
กำหนดว่าจะเปิดใช้การให้ความรู้เพิ่มเติมเกี่ยวกับความสามารถในการเข้าถึงหรือไม่

กรณีการใช้งานหรือบริบท
ดูกรณีการใช้งานการให้ความรู้เกี่ยวกับความสามารถในการเข้าถึงในรูปที่ 3
config_isSizeCompatRestartButtonEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool true
คำอธิบาย
กำหนดว่าจะเปิดใช้ปุ่มรีสตาร์ทความเข้ากันได้ของขนาดหรือไม่

กรณีการใช้งานหรือบริบท
ปุ่มรีสตาร์ทเพื่อรีสตาร์ทการกำหนดค่าสำหรับแอปที่ปรับขนาดไม่ได้หลังจากเปลี่ยนขนาดหน้าต่าง เช่น เมื่อเข้าสู่โหมดแยกหน้าจอหรือหมุน จอแสดงผล
ดูเคสการใช้งานปุ่มรีสตาร์ทที่เข้ากันได้กับขนาดในรูปที่ 4
config_letterboxRestartButtonHideTolerance frameworks/base/libs/WindowManager/Shell/res/values/config.xml Integer 100
Description
กำหนดค่าความคลาดเคลื่อนขั้นต่ำของเปอร์เซ็นต์ขอบเขตกิจกรรมภายในงานเพื่อซ่อนปุ่มรีสตาร์ทความเข้ากันได้ของขนาด ระบบจะละเว้นค่าที่ต่ำกว่า 0 หรือสูงกว่า 100
100 คือค่าเริ่มต้นที่กิจกรรมต้องพอดีกับ งานเพื่อให้ซ่อนปุ่มรีสตาร์ทความเข้ากันได้ของขนาดได้ ค่า 0 หมายความว่า ปุ่มรีสตาร์ทความเข้ากันได้ของขนาดจะซ่อนอยู่เสมอ

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

รูปภาพต่อไปนี้แสดงกรณีการใช้งานการซ้อนทับเพื่อการศึกษา

การเว้นขอบดำเพื่อการศึกษาสำหรับแอปแบบเต็มหน้าจอ

รูปที่ 1 การเว้นขอบดำเพื่อการศึกษาสำหรับแอปแบบเต็มหน้าจอ

ตัวอย่างกล่องโต้ตอบการรีสตาร์ทแบบขยาย

รูปที่ 2 กล่องโต้ตอบการรีสตาร์ทแบบขยาย

ตัวอย่างการให้ความรู้เรื่องการเข้าถึง

รูปที่ 3 การศึกษาเกี่ยวกับความสามารถในการเข้าถึง

ตัวอย่างปุ่มรีสตาร์ทความเข้ากันได้ของขนาด

รูปที่ 4 ปุ่มเริ่มใหม่ที่เข้ากันได้กับขนาด