Przewodnik konfiguracji zgodności aplikacji z urządzeniami z dużym ekranem

Na stronie znajdziesz szczegółowy przewodnik konfiguracji i indeks nakładek konfiguracji zgodności aplikacji na Androida z dużym ekranem.

Wyświetlacz

W tej sekcji znajdziesz listę wszystkich ustawień konfiguracji, które wpływają na konfigurację na poziomie wyświetlania.

Nazwa Lokalizacja Typ Domyślny
ignoreOrientationRequest display_settings.xml konfiguracja false
true na duże ekrany (>= 600 dp)
Opis
Umożliwia bezpłatne obracanie przez użytkownika aktywności o stałej orientacji na określonym wyświetlaczu.
Przykład:
          <display-settings>
              <config identifier="0" />
              <display
                  name="<display's uniqueId>"
                  ignoreOrientationRequest="true"/>
          </display-settings>
        

Przypadek użycia lub kontekst
Wyświetlacz ignoruje żądaną orientację wszystkich aplikacji, a aplikacja jest wyświetlana w formacie letterbox.
Używany na wszystkich urządzeniach z dużym ekranem i w systemie operacyjnym Android Automotive. Jest to domyślne ustawienie na wszystkich urządzeniach z dużym ekranem z Androidem 16 lub nowszym.smallestScreenWidthDp >= 600dp
config_letterboxIsDisplayRotationImmersiveAppCompatPolicyEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Włącza zasadę zgodności z rotacją w przypadku aplikacji immersyjnych, która zapobiega automatycznemu obracaniu ekranu do nieoptymalnej orientacji w trybie pełnoekranowym. Jest to konieczne, ponieważ aplikacje immersyjne, takie jak gry, często nie są zoptymalizowane pod kątem wszystkich orientacji i po obróceniu mogą mieć słabą jakość. Niektóre gry wykorzystują czujniki, więc użytkownicy mogą przypadkowo uruchomić takie obroty, gdy automatyczne obracanie jest włączone.
Dotyczy tylko sytuacji, gdy włączona jest opcja ignoreOrientationRequest.

Przypadek użycia lub kontekst
Blokuje obracanie w przypadku aplikacji immersyjnych.

Format obrazu

W tej sekcji znajdziesz wszystkie ustawienia konfiguracji, które wpływają na konfigurację okna na poziomie aktywności w przypadku współczynnika proporcji.

Nazwa Lokalizacja Typ Domyślny
config_fixedOrientationLetterboxAspectRatio frameworks/base/core/res/res/values/config.xml Float 0.0
Opis
 Konfiguruje współczynnik proporcji letterboxingu dla stałej orientacji. Wartości mniejsze lub równe 1.0 są ignorowane.

Przypadek użycia lub kontekst
Konfiguruje domyślny format obrazu urządzenia, który działa w przypadku większości aplikacji z paskami u góry i u dołu. Zwykle ma format bliższy kwadratowi.
config_letterboxIsSplitScreenAspectRatioForUnresizableAppsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Określa, czy format obrazu podzielonego ekranu ma być domyślnym formatem obrazu w przypadku aplikacji, których rozmiaru nie można zmieniać.

Przypadek użycia lub kontekst
Większość aplikacji, których rozmiaru nie można zmieniać, oczekuje układu telefonu w formie cukierka w orientacji pionowej.
config_letterboxIsDisplayAspectRatioForFixedOrientationLetterboxEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Konfiguruje, czy współczynnik proporcji wyświetlacza ma być używany jako domyślny współczynnik proporcji dla wszystkich aplikacji z paskami u góry i u dołu.

Przypadek użycia lub kontekst
Konfiguracja umożliwiająca programowe używanie współczynnika proporcji wyświetlacza zamiast konfigurowania wartości zmiennoprzecinkowej.

Aparat

W tej sekcji znajdziesz wszystkie ustawienia konfiguracji, które wpływają na aplikacje po wywołaniu zwrotnym funkcji onCameraOpened. Te ustawienia mogą wpływać na wyświetlanie, aktywność i konfigurację kamery.

Nazwa Lokalizacja Typ Domyślny
config_isWindowManagerCameraCompatTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Włącza obsługę zgodności kamery w przypadku problemów spowodowanych przez niezgodność orientacji między buforami kamery a oknem aplikacji.
Obejmuje to wymuszenie obracania działań o stałej orientacji połączonych z aparatem w trybie pełnoekranowym i wyświetlanie etykietki w trybie podzielonego ekranu.
Wymuszone obracanie można wyłączyć za pomocą zastąpienia dla poszczególnych aplikacji: OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION.

Przypadek użycia lub kontekst
Naprawia obrócone podglądy z kamery przez wymuszone obracanie wyświetlacza w celu dopasowania go do orientacji żądanej przez aplikację.
config_isWindowManagerCameraCompatSplitScreenAspectRatioEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Określa, czy aktywność używa proporcji ekranu dzielonego, gdy włączona jest obsługa zgodności z aparatem, a aktywność jest połączona z aparatem w trybie pełnoekranowym.

Przypadek użycia lub kontekst
Naprawia rozciągnięte podglądy z kamery, dodając do aktywności czarne pasy u góry i u dołu, aby uzyskać proporcje podobne do batonika.
Zwykle używane razem z włączonym wymuszonym obracaniem (config_isWindowManagerCameraCompatTreatmentEnabledcamera.enable_landscape_to_portrait) na urządzeniach w trybie poziomym, aby rozwiązać problemy z kompatybilnością kamery spowodowane rozciągnięciem obrazu przez symulowanie proporcji ekranu w trybie pionowym.
camera.enable_landscape_to_portrait Właściwość systemowa Bool false
Opis
Umożliwia wyświetlanieOVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT kampanii eksperymentalnej.
Wymusza przycinanie i obracanie o 90 stopni obrazu z aparatu o naturalnej orientacji poziomej, aby symulować naturalną orientację pionową. W przypadku wszystkich kamer w orientacji poziomej na urządzeniu zgłaszana orientacja czujnika aparatu to orientacja pionowa. Wiele aplikacji nie radzi sobie z taką sytuacją i wyświetla rozciągnięte obrazy.

Przypadek użycia lub kontekst
Umożliwia obracanie i przycinanie obrazu w warstwie HAL aparatu. Więcej informacji o tym działaniu znajdziesz w artykule Obracanie, przycinanie i skalowanie.
Podczas kompilacji dodaj do pliku mk ten kod: PRODUCT_PROPERTY_OVERRIDES += camera.enable_landscape_to_portrait=true
Ta funkcja wymaga, aby urządzenie obsługiwało w HAL.SCALER_ROTATE_AND_CROP Zobacz CameraCharacteristics#SCALER_AVAILABLE_ROTATE_AND_CROP_MODES.
Wskazówki dotyczące implementacji interfejsu HAL dla SCALER_ROTATE_AND_CROP znajdziesz w artykule metadata_definitions.xml.

Tło i interfejs

W tej sekcji znajdziesz wszystkie ustawienia konfiguracji zastosowane do powierzchni warstwy letterbox na potrzeby dostosowywania interfejsu lub na poziomie aktywności.

Nazwa Lokalizacja Typ Domyślny
config_letterboxActivityCornersRadius frameworks/base/core/res/res/values/config.xml Integer 0
Description
Konfiguruje promień zaokrąglenia rogu aktywności wyświetlanej w trybie letterbox. Wartości mniejsze niż 0 włączają zaokrąglone rogi o promieniu równym mniejszemu z promieni dolnych rogów urządzenia. Domyślna wartość 0 wyłącza logikę zaokrąglonych rogów w AppCompatLetterboxPolicy.

Przykład zastosowania lub kontekst
Zwykle skonfigurowane tak, aby pasowały do zaokrąglonych rogów urządzenia fizycznego.
config_letterboxIsEnabledForTranslucentActivities frameworks/base/core/res/res/values/config.xml Bool false
Opis
Konfiguruje, czy w przypadku półprzezroczystych aktywności ma być włączone konkretne zachowanie w zakresie letterboxingu.

Przypadek użycia lub kontekst
Umożliwia wyświetlanie półprzezroczystych aktywności lub okien modalnych w formacie letterbox i ograniczenie ich do konfiguracji aktywności w tym formacie. Zasady obowiązują w TransparentPolicy.
config_isCompatFakeFocusEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Konfiguruje, czy wysyłanie fałszywego fokusu zgodności w przypadku wznowionych aktywności w trybie podzielonego ekranu jest włączone.
Jest to konieczne, ponieważ niektóre silniki gier czekają na uzyskanie fokusu, zanim narysują zawartość aplikacji, która nie jest domyślnie dostępna w trybach wielu okien.

Przypadek użycia lub kontekst
Starsza flaga umożliwiająca zastosowanie traktowania zgodności w przypadku silników gier Unity w aplikacjach, które po przejściu do trybu podzielonego ekranu stają się czarne i są rysowane dopiero po kliknięciu i skupieniu się na nich przez użytkownika.
config_letterboxBackgroundType frameworks/base/core/res/res/values/config.xml Integer 0
Opis
Konfiguruje wygląd narożników tła letterboxa:
  • 0 – jednolite tło w kolorze określonym w polu R.color.config_letterboxBackgroundColor.
  • 1 – kolor określony w R.attr.colorBackground dla aplikacji w formacie letterbox.
  • 2 – kolor określony w R.attr.colorBackgroundFloating dla aplikacji w formacie letterbox.
  • 3 – tapeta z przyciemnionym rozmyciem lub ciemną zasłoną. Co najmniej jeden z tych parametrów musi być większy niż 0: config_letterboxBackgroundWallpaperBlurRadius lub config_letterboxBackgroundWallpaperDarkScrimAlpha. Jeśli tak nie jest lub jeśli podano promień rozmycia, ale rozmycie nie jest obsługiwane przez urządzenie i wybrano tę opcję, implementacja domyślnie przyjmuje wartość opcji 0. Jeśli podana wartość wykracza poza ten zakres, przyjmuje się opcję 0.


Przypadek użycia lub kontekst
Ta funkcja nie została wprowadzona ze względu na istniejące problemy z wydajnością. Producenci OEM mogą tworzyć własne implementacje tej funkcji, ale AOSP nie będzie obsługiwać żadnych błędów.
config_letterboxBackgroundColor frameworks/base/core/res/res/values/config.xml Color @color/system_neutral1_1000
Opis
Konfiguruje kolor tła w przypadku letterboxingu, jeśli spełniony jest jeden z tych warunków:true
  • Wybrano opcję 0 dla R.integer.config_letterboxBackgroundType.
  • W przypadku R.integer.config_letterboxBackgroundType wybrano opcję 1, a w przypadku aplikacji nie określono R.attr.colorBackground.
  • W przypadku R.integer.config_letterboxBackgroundType wybrano opcję 2, a w przypadku aplikacji nie określono R.attr.colorBackgroundFloating.
  • Opcja 3 jest wybrana dla R.integer.config_letterboxBackgroundType i rozmycie jest wymagane, ale nie jest obsługiwane na urządzeniu, lub nie podano wartości alfa ciemnej zasłony ani promienia rozmycia.


Przypadek użycia lub kontekst
Ta funkcja nie została wprowadzona ze względu na istniejące problemy z wydajnością. Producenci OEM mogą tworzyć własne implementacje tej funkcji, ale AOSP nie będzie obsługiwać żadnych błędów.
config_letterboxBackgroundWallpaperBlurRadius frameworks/base/core/res/res/values/config.xml Dimen 38dp
Opis
Konfiguruje promień rozmycia dla opcji 3R.integer.config_letterboxBackgroundType. Wartości mniejsze niż 0 są ignorowane, a używana jest wartość 0.

Przypadek użycia lub kontekst
Ta funkcja nie została wprowadzona ze względu na istniejące problemy z wydajnością. Producenci OEM mogą tworzyć własne implementacje tej funkcji, ale AOSP nie będzie obsługiwać żadnych błędów.
config_letterboxBackgroundWallpaperDarkScrimAlpha frameworks/base/core/res/res/values/config.xml Float 0.54
Opis
 Konfiguruje przezroczystość czarnej, półprzezroczystej nakładki wyświetlanej nad tłem tapety w formacie letterbox, gdy w przypadku opcji R.integer.config_letterboxBackgroundType wybrano opcję 3. Wartości mniejsze niż 0 lub większe bądź równe 1 są ignorowane, a zamiast nich używana jest wartość 0.0 (przezroczysty).

Przypadek użycia lub kontekst
Ta funkcja nie została wprowadzona ze względu na istniejące problemy z wydajnością. Producenci OEM mogą tworzyć własne implementacje tej funkcji, ale AOSP nie będzie obsługiwać żadnych błędów.

Dostępność i pozycjonowanie

W tej sekcji znajdziesz wszystkie ustawienia konfiguracji zastosowane do konfiguracji okna na poziomie aktywności na potrzeby ułatwień dostępu.

Nazwa Lokalizacja Typ Domyślny
config_letterboxIsHorizontalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Określa, czy w przypadku aplikacji w formacie letterbox w trybie pełnoekranowym jest włączone poziome przenoszenie w zasięg.

Przypadek użycia lub kontekst
Przenosi aplikację w orientacji pionowej w lewo lub w prawo, aby ułatwić dostęp.
config_letterboxHorizontalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.5
Opis
Konfiguruje położenie poziome środka okna aplikacji z czarnymi pasami.
0 odpowiada lewej stronie ekranu, a 1 – prawej.
Jeśli podana wartość jest mniejsza niż 0 lub większa niż 1, jest ignorowana. W przypadku pozycji innej niż książka używana jest pozycja środkowa (0.5). W przypadku pozycji książki używana jest pozycja po lewej stronie (0.0).

Przypadek użycia lub kontekst
Domyślnie jest to środek w przypadku aplikacji w formacie letterbox w orientacji pionowej.
config_letterboxIsVerticalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Określa, czy w przypadku aplikacji w formacie letterbox w trybie pełnoekranowym włączone jest pionowe przenoszenie w zasięg.

Przypadek użycia lub kontekst
Przenosi aplikację w orientacji poziomej na górę lub na dół, aby ułatwić dostęp.
config_letterboxVerticalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Opis
Konfiguruje położenie pionowe środka okna aplikacji w formacie letterbox.
Wartość 0 odpowiada górnej części ekranu, a 1 – dolnej.
Jeśli podana wartość jest mniejsza niż 0 lub większa niż 1, jest ignorowana. W przypadku trybu innego niż Na stole używana jest pozycja środkowa (0.5). W przypadku pozycji na stole używana jest pozycja górna (0.0).

Przypadek użycia lub kontekst
Skonfigurowano na środku na urządzeniach z dużym ekranem w przypadku aplikacji w formacie poziomym z paskami u góry i u dołu.
config_letterboxIsAutomaticReachabilityInBookModeEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Konfiguruje, czy automatyczne pozycjonowanie w trybie poziomym w przypadku aplikacji w formacie letterbox w trybie pełnoekranowym jest włączone.

Przypadek użycia lub kontekst
Umożliwia przenoszenie aplikacji w formacie letterbox w trybie pionowym między lewą a prawą stroną, gdy urządzenie składane jest w trybie książki.
config_letterboxBookModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Opis
Konfiguruje położenie poziome środka okna aplikacji w formacie letterbox w trybie książki.
0 odpowiada lewej stronie ekranu, a 1 – prawej. Jeśli podana wartość jest mniejsza niż 0 lub większa niż 1, jest ignorowana i używana jest pozycja po lewej stronie (0.0).

Przypadek użycia lub kontekst
Mnożnik określający, o ile zmienia się pozycja aplikacji po zmianie położenia urządzenia w trybie książki.
config_letterboxDefaultPositionForBookModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
Opis
Konfiguruje domyślne położenie poziome okna aplikacji z paskami po bokach, gdy włączona jest funkcja ułatwień dostępu, a aplikacja jest wyświetlana na pełnym ekranie urządzenia w orientacji poziomej i w trybie książki. Gdy funkcja dostępności jest włączona, pozycja może się zmieniać między lewą, środkową i prawą:
  • Opcja 0 – lewa
  • Opcja 1 – środek
  • Opcja 2 – po prawej
Jeśli podana wartość jest spoza tego zakresu, zakłada się, że wybrana jest opcja 0 (po lewej).

Przypadek użycia lub kontekst
Domyślne położenie aplikacji w trybie książki.
config_letterboxTabletopModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Opis
Konfiguruje pionowe położenie środka okna aplikacji z czarnymi paskami w trybie stołowym.
Wartość 0 odpowiada górnej części ekranu, a 1 – dolnej. Jeśli podana wartość jest mniejsza niż 0 lub większa niż 1, jest ignorowana i używana jest pozycja u góry ekranu0.0.

Przypadek użycia lub kontekst
Mnożnik określający, o ile zmienia się pozycja aplikacji na urządzeniu składanym w trybie stołowym.
config_letterboxDefaultPositionForTabletopModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
Opis
Konfiguruje domyślne położenie pionowe okna aplikacji z paskami po bokach, gdy włączona jest funkcja ułatwień dostępu, a aplikacja jest wyświetlana na pełnym ekranie urządzenia w orientacji pionowej i w trybie stołowym. Gdy funkcja dostępności jest włączona, pozycja może się zmieniać między górną, środkową i dolną. Ta konfiguracja określa domyślną:
  • Opcja 0 – góra
  • Opcja 1 – środek
  • Opcja 2 – dół
Jeśli podana wartość jest poza tym zakresem, przyjmuje się opcję 0 (górną).

Przypadek użycia lub kontekst
Domyślna pozycja, w której aplikacja jest umieszczana w trybie tabletu.

Ustawienia

W tej sekcji znajdziesz wszystkie ustawienia konfiguracyjne, które umożliwiają dostosowywanie i włączanie ustawień formatu obrazu użytkownika w Ustawieniach > Aplikacjach > Formacie obrazu.

Nazwa Lokalizacja Typ Domyślny
config_appCompatUserAppAspectRatioSettingsIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Określa, czy włączone są ustawienia zastępowania współczynnika proporcji ekranu dla poszczególnych aplikacji.

Przypadek użycia lub kontekst
Włącza funkcję ustawień współczynnika proporcji w sekcji Ustawienia > Aplikacje > Współczynnik proporcji.
config_appCompatUserAppAspectRatioFullscreenIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Konfiguruje, czy opcja zastępowania pełnego ekranu w przypadku poszczególnych aplikacji jest włączona w ustawieniach formatu obrazu użytkownika.

Przypadek użycia lub kontekst
Włącza opcję Pełny ekran w funkcji ustawień formatu obrazu użytkownika.
To ustawienie ignoruje ograniczenia dotyczące możliwości zmiany rozmiaru, formatu obrazu i orientacji aplikacji.
config_userAspectRatioOverrideEntries packages/apps/Settings/res/values/config.xml string-array Domyślnie wszystkie opcje są włączone.
Opis
 Konfiguruje ekran ustawień proporcji aplikacji i opcje zastępowania proporcji przez użytkownika. Musi mieć taką samą długość i kolejność jak config_userAspectRatioOverrideValues.
Jeśli zmienisz tę wartość, zaktualizuj też logikę tworzenia kopii zapasowych i przywracania, aby wybierać najbliższą wartość w UserAspectRatioBackupManager.java.

Przypadek użycia lub kontekst
Mapowania ciągów znaków wyświetlanych w Ustawieniach.
config_userAspectRatioOverrideValues packages/apps/Settings/res/values/config.xml integer-array Domyślnie używane są wszystkie ciągi tekstowe AOSP.
Opis
 Konfiguruje ekran ustawień proporcji aplikacji i opcje zastępowania proporcji przez użytkownika. Musi mieć taką samą długość i kolejność jak config_userAspectRatioOverrideEntries. Wartości muszą być zgodne z elementem PackageManager.UserMinAspectRatio.
Jeśli zmienisz to ustawienie, zaktualizuj też logikę tworzenia kopii zapasowej i przywracania, aby wybierać najbliższą wartość w UserAspectRatioBackupManager.java.

Przypadek użycia lub kontekst
Mapowania opcji na backend PackageManager.UserMinAspectRatio:
  • Domyślne ustawienie aplikacji – 0
  • Podzielony ekran – 1
  • Format obrazu wyświetlacza – 2
  • 4:3 - 3
  • 16:9 – 4
  • 3:2 - 5
  • Pełny ekran – 6
Statyczne elementy rysowane w jasnym motywie packages/apps/Settings/res/drawable/ic_app_aspect_ratio_<option>.xml vector Komponenty w formacie poziomym na urządzenia składane
Opis
Konfiguruje dostępne elementy rysunkowe:


Przypadek użycia lub kontekst
Statyczne obrazy w jasnym motywie pod każdą opcją w sekcji Ustawienia > Informacje o aplikacji > Współczynnik proporcji.
Statyczne elementy rysunkowe w ciemnym motywie packages/apps/Settings/res/drawable-night/ic_app_aspect_ratio_<option>.xml vector Komponenty w formacie poziomym na urządzenia składane
Opis
Konfiguruje dostępne elementy rysunkowe:


Przypadek użycia lub kontekst
Statyczne obrazy w ciemnym motywie pod każdą opcją w sekcji Ustawienia > Informacje o aplikacji > Format obrazu.
Dynamiczny obiekt rysowalny
user_aspect_ratio_education.json
packages/apps/Settings/res/raw/user_aspect_ratio_education.json JSON Dynamiczny zasób w formacie poziomym na urządzenia składane
Opis
Konfiguruje ilustrację Lottie w UserAspectRatioAppsPageProvider.

Przypadek użycia lub kontekst
Animacja na liście aplikacji: Ustawienia > Aplikacje > Format obrazu.

Edukacja

W tej sekcji znajdziesz wszystkie ustawienia konfiguracji dotyczące informowania użytkowników o funkcjach zgodności aplikacji.

Nazwa Lokalizacja Typ Domyślny
config_letterboxIsEducationEnabled frameworks/base/core/res/res/values/config.xml Bool false
Opis
Określa, czy w przypadku aplikacji pełnoekranowych z efektem letterbox ma być włączone wyświetlanie informacji o tym efekcie.

Przypadek użycia lub kontekst
Przypadek użycia wyświetlania informacji o efekcie letterbox w aplikacjach pełnoekranowych znajdziesz na rysunku 1.
config_letterboxIsRestartDialogEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
Opis
Konfiguruje, czy rozszerzone okno ponownego uruchomienia jest włączone.

Przypadek użycia lub kontekst
Przypadek użycia rozszerzonego okna ponownego uruchomienia znajdziesz na rysunku 2.
config_letterboxIsReachabilityEducationEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
Opis
Określa, czy włączone są dodatkowe informacje o dostępności.

Przypadek użycia lub kontekst
Przypadek użycia informacji o dostępności znajdziesz na rysunku 3.
config_isSizeCompatRestartButtonEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool true
Opis
Określa, czy przycisk ponownego uruchomienia zgodności rozmiaru jest włączony.

Przypadek użycia lub kontekst
Przycisk ponownego uruchomienia, który umożliwia ponowne uruchomienie konfiguracji aplikacji o stałym rozmiarze po zmianie rozmiaru okna, np. po przejściu do trybu podzielonego ekranu lub obróceniu wyświetlacza.
Przykład użycia przycisku ponownego uruchamiania w przypadku zgodności rozmiarów znajdziesz na rysunku 4.
config_letterboxRestartButtonHideTolerance frameworks/base/libs/WindowManager/Shell/res/values/config.xml Integer 100
Opis
Konfiguruje minimalną tolerancję procentową granic aktywności w ramach zadania, aby ukryć przycisk ponownego uruchomienia zgodności rozmiaru. Wartości mniejsze niż 0 lub większe niż 100 są ignorowane.
100 to wartość domyślna, w przypadku której aktywność musi dokładnie mieścić się w ramach zadania, aby można było ukryć przycisk ponownego uruchomienia zgodności rozmiaru. Wartość 0 oznacza, że przycisk ponownego uruchomienia ze względu na zgodność rozmiaru jest zawsze ukryty.

Przypadek użycia lub kontekst
Używane na urządzeniach o proporcjach zbliżonych do kwadratu, aby ukryć przycisk ponownego uruchomienia, gdy użytkownik obróci aplikacje o zmiennych rozmiarach, ale ponowne uruchomienie aplikacji nie spowoduje znacznej poprawy interfejsu.

Na poniższych obrazach przedstawiono przykłady zastosowania nakładki edukacyjnej:

Letterboxing w przypadku aplikacji pełnoekranowych

Rysunek 1. Letterboxing w przypadku aplikacji pełnoekranowych

Przykład rozszerzonego okna ponownego uruchomienia.

Rysunek 2. Rozszerzone okno ponownego uruchamiania

Przykład informacji o dostępności.

Rysunek 3. Edukacja w zakresie dostępności.

Przykładowy przycisk ponownego uruchomienia zgodny z rozmiarem.

Rysunek 4. Przycisk ponownego uruchomienia zgodności rozmiaru.