確保與手勢操作功能相容

從 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,可通知應用程式達到觸控辨識門檻。

遊戲和其他非檢視模式的應用程式

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

如果遊戲要求使用者滑動到主畫面手勢區域附近,應用程式可以要求以沉浸模式進行版面配置。這麼做會停用使用者與遊戲互動時的系統手勢,但允許使用者從螢幕底部滑動來重新啟用系統手勢。

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

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

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

其他資源

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

網誌文章

影片