UserInputState

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

使用者輸入狀態枚列描述目前或最近執行的輸入狀態。它被同一名稱的 InputObject.UserInputState 屬性以及各種 UserInputService 和 GuiObject 事件使用。

取決於 Enum.UserInputType ，輸入可能會跟隨狀態不同。

簡單按鈕和按鍵通常會跟隨簡單的開始 → 結束流程。
- 遊戲控制器觸發按鈕與按鈕按下器相似，但會使用變更作為按鈕狀態變更。
滑鼠移動通常會跟隨開始 (滑鼠漂浮) → 變更 → 結束 (滑鼠離開)。
- 觸摸輸入的行為類似於滑鼠移動。開始和結束發生時，用戶開始或結束觸碰屏幕，分別。相同的 InputObject 用於相同的觸點。
遊戲手柄搖桿控件會導致每一個框架位置變更時發生變更。

取消

在 ContextActionService 的上下文中，使用 BindAction 來綁定行動處理功能，當執行相關輸入時，會向行動處理器提供一個用戶輸入狀態。如果與綁定行動相關的進行中輸入與不同輸入相關，則 unbound 或變得與不同輸入相關，則取消用戶輸入狀態將傳送，表示輸入不再與行動作相關。

道具

名稱	值	概要
Begin	0	發生當 InputObject 開始與遊戲互動時。例如，滑鼠按鈕向下、鍵向下，或當觸摸開始觸碰屏幕時。
Change	1	每個框架發生一次 InputObject 已開始與遊戲互動，其狀態的一部分正在變更。例如，滑鼠位置的移動、遊戲手柄搖桿、遊戲手柄觸發按鈕或螢幕觸碰點。
End	2	當 InputObject 結束與遊戲的互動時。例如，滑鼠按鈕上升，或按鍵上升，或當觸摸停止觸碰屏幕時。
Cancel	3	指示此輸入已不相關的特殊情況狀態，特別是與 ContextActionService 。例如，綁定兩個行動處理功能會導致第一個取消，如果第二個已綁定時輸入已在進行中，當第一個被綁定時。
None	4	一個狀態，在遊戲中絕對不應該看到，本質上只標記枚舉的結束。