大螢幕使用者個別應用程式覆寫值

Android 提供的覆寫值可能會變更已設定的應用程式行為。

裝置製造商可以在特定大螢幕裝置上，為應用程式套用覆寫值。Android 14 QPR1 推出了使用者覆寫值，可讓使用者透過裝置設定為應用程式套用覆寫值。

個別應用程式覆寫值的用意是改善大螢幕裝置的使用者體驗。應用程式可停用部分覆寫值。

如要進一步瞭解個別應用程式覆寫值，請參閱「裝置相容模式」。

注意： 為了讓應用程式提供最佳使用者體驗，且不依賴裝置製造商或使用者覆寫值，請遵守「大螢幕應用程式品質」指南。

使用者覆寫

Android 14 QPR1 推出了新的設定選單，可讓使用者變更應用程式的顯示比例，改善應用程式在大螢幕上的顯示方式。選定大螢幕裝置的裝置設定中會實作這項選單。

在已實作設定選單的裝置上，使用者可從應用程式清單中選擇，然後將應用程式顯示比例設為各種值，例如 4:3、16:9 和全螢幕 (顯示比例值由裝置製造商設定)。使用者也可以將顯示比例重設為應用程式預設值，也就是裝置製造商為個別應用程式覆寫指定的值 (請參閱 OVERRIDE_MIN_ASPECT_RATIO)，或是如果未套用覆寫值，或應用程式已停用覆寫值，則為應用程式資訊清單中的值。

停用覆寫值

Android 14 QPR1 支援下列 PackageManager.Property 標記，可讓您在已實作覆寫值的裝置上停用或修改顯示比例設定選單：

注意： 屬性標記是 Jetpack WindowManager WindowProperties 常數，可能無法在所有裝置上使用或測試。

• PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE

  如要停用使用者顯示比例相容性覆寫值，請將屬性新增至應用程式資訊清單，並將值設為 false：

  <application>
      <property
          android:name="android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE"
          android:value="false"/>
  </application>
  

  在已實作設定選單的裝置上，您的應用程式會從裝置設定中的應用程式清單中移除，因此使用者無法覆寫應用程式的顯示比例。

  將屬性設為 true 不會產生任何影響。

  
  

• PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE

  如要停用使用者顯示比例相容性覆寫值的全螢幕選項，請將屬性新增至應用程式資訊清單，並將值設為 false：

  <application>
      <property
          android:name="android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE"
          android:value="false"/>
  </application>
  

  在已實作設定選單的裝置上，裝置設定中的顯示比例選項清單中會移除全螢幕選項。使用者無法將全螢幕覆寫值套用至您的應用程式。

  將這個屬性設為 true 不會產生任何影響。

  注意： 如果 PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE 設為 false，這項屬性就不會生效。

注意： 如要實作屬性標記，應用程式必須加入 Jetpack WindowManager 程式庫依附元件。

針對大螢幕最佳化應用程式：請勿在應用程式中設定顯示比例限制。請使用視窗大小類別，根據可用的顯示空間大小支援不同的版面配置。