本頁面由 Cloud Translation API 翻譯而成。

使用快速滑過動畫移動檢視畫面

以彈跳為基礎的動畫會使用與物件速度成比例的摩擦力。可用於為物件的屬性加入動畫，並逐步結束動畫。它具有初始動量，主要來自手勢速度，並逐漸減速。當動畫速度降低到在裝置螢幕上不會產生可見變化時，動畫就會結束。

如要瞭解相關主題，請參閱下列指南：

新增 AndroidX 程式庫

如要使用以物理為基礎的動畫，您必須按照下列方式將 AndroidX 程式庫新增至專案：

開啟應用程式模組的 build.gradle 檔案。

將 AndroidX 程式庫新增至 dependencies 區段。

Groovy

        dependencies {
            implementation 'androidx.dynamicanimation:dynamicanimation:1.0.0'
        }

Kotlin

        dependencies {
            implementation("androidx.dynamicanimation:dynamicanimation:1.0.0")
        }

建立快速滑過動畫

FlingAnimation 類別可讓您為物件建立甩動動畫。如要建構甩動動畫，請建立 FlingAnimation 類別的例項，並提供要製作動畫的物件和物件的屬性。

Kotlin

val fling = FlingAnimation(view, DynamicAnimation.SCROLL_X)

Java

FlingAnimation fling = new FlingAnimation(view, DynamicAnimation.SCROLL_X);

設定速度

起始速度會定義動畫屬性在動畫開始時變化的速度。預設的起始速度設為每秒零像素。因此，您必須定義起始速度，確保動畫不會立即結束。

您可以使用固定值做為起始速度，也可以根據觸控手勢的速度來設定。如果您選擇提供固定值，應以每秒 dp 為單位定義該值，然後轉換為每秒像素。以每秒 dp 的值定義時，速度就不會受到裝置密度和板型規格的影響。如要進一步瞭解如何將起始速度轉換為每秒像素，請參閱「彈簧動畫」一文中的「將每秒 dp 轉換為每秒像素」一節。

如要設定速度，請呼叫 setStartVelocity() 方法，並以每秒像素為單位傳遞速度。這個方法會傳回設定速度的彈跳物件。

注意：請分別使用 GestureDetector.OnGestureListener 和 VelocityTracker 類別，分別擷取及計算觸控手勢的速度。

設定動畫值範圍

如要將資源值限制在特定範圍內，您可以設定最小和最大動畫值。當您為具有內在範圍的屬性 (例如 alpha 值，範圍為 0 到 1) 製作動畫時，這個範圍控制項特別實用。

注意：當甩動動畫的值達到最小或最大值時，動畫就會結束。

如要設定最小值和最大值，請分別呼叫 setMinValue() 和 setMaxValue() 方法。這兩種方法都會傳回您設定值的動畫物件。

設定摩擦力

setFriction() 方法可讓您變更動畫的摩擦力。定義動畫中速度下降的速度。

注意：如果您未在動畫開始時設定摩擦力，動畫會使用預設的摩擦力值 1。

這個方法會傳回動畫使用您提供的摩擦力值的物件。

程式碼範例

以下範例說明水平揮動。從速度追蹤器擷取的速度為 velocityX，捲動邊界則設為 0 和 maxScroll。摩擦力設為 1.1。

Kotlin

FlingAnimation(view, DynamicAnimation.SCROLL_X).apply {
    setStartVelocity(-velocityX)
    setMinValue(0f)
    setMaxValue(maxScroll)
    friction = 1.1f
    start()
}

Java

FlingAnimation fling = new FlingAnimation(view, DynamicAnimation.SCROLL_X);
fling.setStartVelocity(-velocityX)
        .setMinValue(0)
        .setMaxValue(maxScroll)
        .setFriction(1.1f)
        .start();

設定可見變更的最低門檻

如果您為未以像素定義的自訂屬性設定動畫，應設定使用者可見的動畫值變更最小值。並決定結束動畫的合理門檻。

在為 DynamicAnimation.ViewProperty 製作動畫時，不必呼叫這個方法，因為最小可視變更會從屬性衍生。例如：

對於 TRANSLATION_X、TRANSLATION_Y、TRANSLATION_Z、SCROLL_X 和 SCROLL_Y 等檢視畫面屬性，預設的最小可見變更值為 1 像素。
對於使用旋轉的動畫 (例如 ROTATION、ROTATION_X 和 ROTATION_Y)，可見的變化最小值為 MIN_VISIBLE_CHANGE_ROTATION_DEGREES，或 1/10 個像素。
對於使用不透明度的動畫，可見變化最小值為 MIN_VISIBLE_CHANGE_ALPHA，或 1/256。

如要設定動畫的最低可見變更，請呼叫 setMinimumVisibleChange() 方法，並傳遞其中一個最小可見常數，或您需要計算自訂屬性的值。如要進一步瞭解如何計算這個值，請參閱「計算最小可見變更值」一節。

Kotlin

anim.minimumVisibleChange = DynamicAnimation.MIN_VISIBLE_CHANGE_SCALE

Java

anim.setMinimumVisibleChange(DynamicAnimation.MIN_VISIBLE_CHANGE_SCALE);

注意：只有在為未以像素定義的自訂屬性設定動畫時，才需要傳遞值。

計算可見變更值下限

如要計算自訂資源的最小可見變更值，請使用下列公式：

最小可見變更 = 自訂屬性值的範圍 / 動畫範圍 (以像素為單位)

舉例來說，您想讓屬性從 0 進展到 100。這會對應到 200 像素的變更。根據公式，最小可見變更值為 100 / 200，等於 0.5 像素。