透過集合功能整理內容
你可以依據偏好儲存及分類內容。
輸入
預測未來的 MotionEvents 事件,藉此減少輸入互動的延遲時間
最近更新時間 |
穩定版 |
候選版 |
Beta 版 |
Alpha 版 |
2025 年 8 月 13 日 |
- |
- |
1.0.0-beta06 |
- |
宣告依附元件
如要為輸入新增依附元件,必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。
在應用程式或模組的 build.gradle
檔案中,新增所需構件的依附元件:
Groovy
dependencies {
implementation "androidx.input:input-motionprediction:1.0.0-beta06"
}
Kotlin
dependencies {
implementation("androidx.input:input-motionprediction:1.0.0-beta06")
}
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋
您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
建立新問題
詳情請參閱 Issue Tracker 文件。
這個構件沒有任何版本資訊。
1.0 版本
2025 年 8 月 13 日
發布 androidx.input:input-motionprediction:1.0.0-beta06
。1.0.0-beta06 版包含這些修訂版本。
新功能
API 變更
- 移除過時的
@RequiresApi(21)
註解 (I9103b)
2024 年 10 月 2 日
發布 androidx.input:input-motionprediction:1.0.0-beta05
。1.0.0-beta05 版包含這些修訂版本。
修正錯誤
- 防止預測值超出要求金額 (Ifbf49、b/369330439)
- 移除手動列出新平台 API 存取權的步驟,因為使用 AGP 7.3 以上版本 (例如 R8 3.3 版) 的 R8 時,系統會透過 API 建模自動執行這項作業,而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時,所有建構作業都會自動執行這項作業。如果用戶端未使用 AGP,建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(If6b4c、b/345472586)
2024 年 5 月 1 日
發布 androidx.input:input-motionprediction:1.0.0-beta04
。1.0.0-beta04 版包含這些修訂版本。
新功能
- 預測不會突然停止
- 內建預測功能現在是預設功能,而非系統預測功能
修正錯誤
- 將 androidx 程式庫的預設
minSdkVersion
設為 21 (I6ec7f)
- 修正多指標事件的按下事件時間 (04824a)。
- 修正第一個指標的歷史時間戳記 (dee0b0)。
- 修正存在多個指標時的錯誤歷史時間 (1189fa)。
2023 年 9 月 20 日
發布 androidx.input:input-motionprediction:1.0.0-beta03
。1.0.0-beta03 版包含此連結所列的修訂項目。
新功能
2023 年 7 月 26 日
發布 androidx.input:input-motionprediction:1.0.0-beta02
。查看 1.0.0-beta02 版的修訂項。
新功能
- 新增對 Android U 系統預測 API 的支援 (I7261f)
API 變更
修正錯誤
- 預測動作事件現在會回報正確的停機和事件時間 (I40059)
2023 年 3 月 22 日
發布 androidx.input:input-motionprediction:1.0.0-beta01
。1.0.0-beta01 版包含此連結所列的修訂項目。
新功能
- 預測動作事件中包含方向和傾斜角度
- 動態計算預測內部資料
API 變更
2022 年 12 月 7 日
發布 androidx.input:input-motionprediction:1.0.0-alpha02
。1.0.0-alpha02 版包含此連結所列的修訂項目。
API 變更
- 已將
recordMovement
重新命名為 record
,並將 dispose
重新命名為 close
(I018c0)
2022 年 10 月 24 日
發布了 androidx.input:input-motionprediction:1.0.0-alpha01
。1.0.0-alpha01 版包含此連結所列的修訂項目。
新功能
- 輸入預測 AndroidX 程式庫的初始版本。其中包括用來預測未來動作事件的 API,以減少感受到的輸入互動延遲。
API 變更
- 加入
MotionEventPredictor
,此公用程式可根據之前收到的事件提供預測的動作事件。
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-08-13 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-08-13 (世界標準時間)。"],[],[],null,["# Input\n\ninput\n=====\n\nAPI Reference \n[androidx.input](/reference/kotlin/androidx/input/package-summary) \nReduce the latency of input interactions by predicting future MotionEvents \n\n| Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |\n|-----------------|----------------|-------------------|---------------------------------------------------------------|---------------|\n| August 13, 2025 | - | - | [1.0.0-beta06](/jetpack/androidx/releases/input#1.0.0-beta06) | - |\n\nDeclaring dependencies\n----------------------\n\nTo add a dependency on Input, you must add the Google Maven repository to your\nproject. Read [Google's Maven repository](/studio/build/dependencies#google-maven)\nfor more information.\n\nAdd the dependencies for the artifacts you need in the `build.gradle` file for\nyour app or module: \n\n### Groovy\n\n```groovy\ndependencies {\n implementation \"androidx.input:input-motionprediction:1.0.0-beta06\"\n}\n```\n\n### Kotlin\n\n```kotlin\ndependencies {\n implementation(\"androidx.input:input-motionprediction:1.0.0-beta06\")\n}\n```\n\nFor more information about dependencies, see [Add build dependencies](/studio/build/dependencies).\n\nFeedback\n--------\n\nYour feedback helps make Jetpack better. Let us know if you discover new issues or have\nideas for improving this library. Please take a look at the\n[existing issues](https://issuetracker.google.com/issues?q=componentid:1263170%20status:open)\nin this library before you create a new one. You can add your vote to an existing issue by\nclicking the star button.\n\n[Create a new issue](https://issuetracker.google.com/issues/new?component=1263170&template=1745246)\n\nSee the [Issue Tracker documentation](https://developers.google.com/issue-tracker)\nfor more information.\n\nThere are no release notes for this artifact.\n\nVersion 1.0\n-----------\n\n### Version 1.0.0-beta06\n\nAugust 13, 2025\n\n`androidx.input:input-motionprediction:1.0.0-beta06` is released. Version 1.0.0-beta06 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/1ddcc5c5a15362711a13f1d8a5b4278a4f7d5440..e53274587ab3eb7dde3a27872b6dfbfd7e55172f/input/input-motionprediction).\n\n**New Features**\n\n- The library will now use the system prediction API if available.\n\n**API Changes**\n\n- Removing obsolete `@RequiresApi(21)` annotations ([I9103b](https://android-review.googlesource.com/#/q/I9103beb2d5f73470f3abfdf034bc2b473be923e6))\n\n### Version 1.0.0-beta05\n\nOctober 2, 2024\n\n`androidx.input:input-motionprediction:1.0.0-beta05` is released. Version 1.0.0-beta05 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/fbd1ac175922f44c69a13545d194066ee428b342..1ddcc5c5a15362711a13f1d8a5b4278a4f7d5440/input/input-motionprediction).\n\n**Bug Fixes**\n\n- Prevent prediction from going beyond requested amount ([Ifbf49](https://android-review.googlesource.com/#/q/Ifbf492418e3a15ff4743526a394c2da7c3941268), [b/369330439](https://issuetracker.google.com/issues/369330439))\n- Removed manual outlining of access to new platform APIs since this happens automatically via API modeling when using R8 with AGP 7.3 or later (e.g. R8 version 3.3) and for all builds when using AGP 8.1 or later (e.g. D8 version 8.1). Clients who are not using AGP are advised to update to D8 version 8.1 or later. See [this article](https://medium.com/androiddevelopers/mitigating-soft-verification-issues-in-r8-and-d8-7e9e06827dfd) for more details. ([If6b4c](https://android-review.googlesource.com/#/q/If6b4ccfca0a943b45971a422b58949b13a10bada), [b/345472586](https://issuetracker.google.com/issues/345472586))\n\n### Version 1.0.0-beta04\n\nMay 1, 2024\n\n`androidx.input:input-motionprediction:1.0.0-beta04` is released. Version 1.0.0-beta04 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/91bb8c1f81dcb031bda00fcd8e55f1e890b56f06..fbd1ac175922f44c69a13545d194066ee428b342/input/input-motionprediction).\n\n**New Features**\n\n- Prediction will not stop suddenly\n- Built-in prediction is now the default instead of the system one\n\n**Bug Fixes**\n\n- Move to 21 as the default `minSdkVersion` of androidx libraries ([I6ec7f](https://android-review.googlesource.com/#/q/I6ec7f80aafbe04c64c8f2d8fef82d4cd5c68525e))\n- Fix down event time for the multi pointer events ([04824a](https://android-review.googlesource.com/#/q/04824a47b59e4708fe7964bcfb36631148430d1d)).\n- Fix historical timestamp for the first pointer ([dee0b0](https://android-review.googlesource.com/#/q/dee0b0c4a6113a23fbf26021aa81cf05cd01cdc2)).\n- Fix bad historical time when multiple pointers are present ([1189fa](https://android-review.googlesource.com/#/q/1189fa5f6841e2290dff8b86921ab63857cbd2c4)).\n\n### Version 1.0.0-beta03\n\nSeptember 20, 2023\n\n`androidx.input:input-motionprediction:1.0.0-beta03` is released. [Version 1.0.0-beta03 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/4aed940027a19667e67d155563fc5fa8b7279313..91bb8c1f81dcb031bda00fcd8e55f1e890b56f06/input/input-motionprediction)\n\n**New Features**\n\n- Increase prediction confidence when using accurate tools. ([57cb7c6](https://android.googlesource.com/platform/frameworks/support/+/57cb7c62c62fe4c95643d4777dbf3443f7ba7d1b))\n- Optimized built-in prediction library memory allocation. ([0b7686e](https://android.googlesource.com/platform/frameworks/support/+/0b7686e0df49ea98b1b4e91979197ed3f6107574))\n\n### Version 1.0.0-beta02\n\nJuly 26, 2023\n\n`androidx.input:input-motionprediction:1.0.0-beta02` is released. [Version 1.0.0-beta02 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/5e7d256f82fbafb6d059ab7b18fddd87c7531553..4aed940027a19667e67d155563fc5fa8b7279313/input/input-motionprediction)\n\n**New Features**\n\n- Add support for Android U system prediction API ([I7261f](https://android-review.googlesource.com/#/q/I7261fd0bdcfe0283ff9edbb4e19940bc4731c83e))\n\n**API Changes**\n\n- Merged public and experimental API files for h- thru m-paths ([Ic4630](https://android-review.googlesource.com/#/q/Ic46302e01e1352d8b4d37cb2468ef61474e79df3), [b/278769092](https://issuetracker.google.com/issues/278769092))\n\n**Bug Fixes**\n\n- Predicted motion events now report the correct down and event time ([I40059](https://android-review.googlesource.com/#/q/I400595643e50e8cdd5c2686df65ce4cd7965b598))\n\n### Version 1.0.0-beta01\n\nMarch 22, 2023\n\n`androidx.input:input-motionprediction:1.0.0-beta01` is released. [Version 1.0.0-beta01 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/4a2f5e696614339c1ac21f706c1a17c0285780e7..5e7d256f82fbafb6d059ab7b18fddd87c7531553/input/input-motionprediction)\n\n**New Features**\n\n- Orientation and tilt are present in the predicted motion events\n- Dynamically calculated prediction internals\n\n**API Changes**\n\n- Removed `close` method as it is no longer needed ([I84349](https://android-review.googlesource.com/#/q/I843491e06b583282a4a085737429c80bc6322d99))\n\n### Version 1.0.0-alpha02\n\nDecember 7, 2022\n\n`androidx.input:input-motionprediction:1.0.0-alpha02` is released. [Version 1.0.0-alpha02 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/e3511bdaf82f43eeb8c415c3313a3f3904adc82b..4a2f5e696614339c1ac21f706c1a17c0285780e7/input/input-motionprediction)\n\n**API Changes**\n\n- Renamed `recordMovement` to `record`, and `dispose` to `close` ([I018c0](https://android-review.googlesource.com/#/q/I018c04a32c9129d6559ee85819d9a82773fd376f))\n\n### Version 1.0.0-alpha01\n\nOctober 24, 2022\n\n`androidx.input:input-motionprediction:1.0.0-alpha01` is released. [Version 1.0.0-alpha01 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/548c8ac2570ae6cf15798fea1380491f7d93796b/input/input-motionprediction)\n\n**New Features**\n\n- Initial release of the input prediction AndroidX library. This includes an API to reduce the perceived latency of input interactions by predicting future motion events.\n\n**API Changes**\n\n- Introduces `MotionEventPredictor`, a utility that provides predicted motion events based on the previously received ones."]]