確保與手勢操作功能相容

從 Android 10 (API 級別 29) 開始,Android 系統支援完全以手勢為基礎的導覽。應用程式開發人員必須採取下列兩項行動,才能確保自己的應用程式與這項功能相容:

  • 將應用程式內容從邊緣延伸至邊緣。
  • 處理衝突的應用程式手勢。

此外,Android 13 (API 級別 33) 也為 Android 裝置 (例如手機、大螢幕和折疊式裝置) 推出了預測返回手勢,而這項手勢為多年來的一部份。應用程式開發人員可以採取措施,確保自家應用程式支援預測返回手勢。

提供無邊框應用程式內容

如要利用浮動導覽列提供的額外螢幕空間,您必須在應用程式中進行某些變更。

詳情請參閱「在應用程式中顯示無邊框內容」。

處理衝突的應用程式手勢

手勢操作模型可能會與應用程式開發人員先前使用的手勢發生衝突。因此,您可能需要調整應用程式的使用者介面。

與返回手勢衝突

返回新的系統手勢是指從螢幕左側或右側邊緣向內滑動。這可能會影響這些區域的應用程式導覽元素。如要在螢幕左側和右側邊緣維持元素功能,請選擇性地將返回手勢選擇退出,告知系統哪些區域需要接收觸控輸入。只要將 List<Rect> 傳遞至 Android 10 中導入的 View.setSystemGestureExclusionRects() API,即可執行此操作。自 androidx.core:core:1.1.0-dev01起,ViewCompat 也可以使用此方法。

舉例來說:

Kotlin

var exclusionRects = listOf(rect1, rect2, rect3)

fun onLayout(
        changedCanvas: Boolean, left: Int, top: Int, right: Int, bottom: Int) {
  // Update rect bounds and the exclusionRects list
  setSystemGestureExclusionRects(exclusionRects)
}

fun onDraw(canvas: Canvas) {
  // Update rect bounds and the exclusionRects list
  setSystemGestureExclusionRects(exclusionRects)
}

Java

List<Rect> exclusionRects;

public void onLayout(
        boolean changedCanvas, int left, int top, int right, int bottom) {
    // Update rect bounds and the exclusionRects list
    setSystemGestureExclusionRects(exclusionRects);
}

public void onDraw(Canvas canvas) {
    // Update rect bounds and the exclusionRects list
    setSystemGestureExclusionRects(exclusionRects);
}

與主畫面或快速切換手勢發生衝突

新的系統手勢和快速切換手勢,都是在瀏覽列先前佔用的空間的螢幕底部滑動。應用程式無法停用這些手勢,因為可以使用返回手勢。

為緩解這個問題,Android 10 推出了 WindowInsets.getMandatorySystemGestureInsets() API,可告知應用程式觸控辨識門檻。

遊戲和其他非 View 應用程式

沒有檢視區塊階層的遊戲和其他應用程式通常會要求使用者在系統手勢區域附近滑動。在這種情況下,遊戲可以使用 Window.setSystemGestureExclusionRects() 排除與系統手勢保留的區域重疊的區域。遊戲必須確保只在必要時排除這些區域,例如在遊戲期間。

如果遊戲需要使用者滑動靠近主畫面手勢區域,應用程式可以要求以沉浸模式展開。這項設定會在使用者與遊戲互動時停用系統手勢,但使用者可從螢幕底部滑動,重新啟用系統手勢。

更新應用程式,以便支援預測返回手勢

Android 13 (API 級別 33) 在手機、大螢幕裝置和折疊式裝置等 Android 裝置上推出了預測返回手勢,預測返回手勢是多年版本的一部分。完整實作後,這項功能可讓使用者在完成返回手勢之前預覽目的地或其他結果,以便決定要繼續還是停留在目前的檢視畫面。

詳情請參閱「新增對預測返回手勢的支援」一文。

其他資源

如要進一步瞭解手勢操作模式,請參閱以下資源:

網誌文章

影片