輸入事件 — MRTK2

下列清單概述自訂 MonoBehaviour 元件要實作的所有可用輸入事件介面。 MRTK 輸入系統會呼叫這些介面，以根據使用者輸入互動來處理自訂應用程式邏輯。 指標輸入事件 處理方式與下列標準輸入事件種類稍有不同。

作用中的輸入事件

在腳本層級，您可以實作上表所示的其中一個事件處理常式介面來取用輸入事件。 當輸入事件透過使用者互動引發時，會發生下列動作：

1. MRTK 輸入系統可辨識已發生輸入事件。
2. MRTK 輸入系統會將輸入事件的相關介面函式引發至所有 已註冊的全域輸入處理常式
3. 針對向輸入系統註冊的每個作用中指標：
   1. 輸入系統會決定哪些 GameObject 是目前指標的焦點。
   2. 輸入系統會利用 Unity 的事件系統 ，針對焦點 GameObject 上的所有相符元件引發相關的介面函式。
   3. 如果輸入事件在任何時間點 標示為已使用，進程將會結束，而且不會再收到 GameObjects 回呼。
      • 範例：辨識語音命令時，會搜尋實作介面 IMixedRealitySpeechHandler 的元件。
      • 注意：如果目前 GameObject 上找不到符合所需介面的元件，Unity 事件系統將會反升至搜尋父 GameObject。
4. 如果未註冊任何全域輸入處理常式，而且找不到具有相符元件/介面的 GameObject，則輸入系統會呼叫每個後援註冊的輸入處理常式

輸入事件介面範例

下列程式碼示範如何使用 IMixedRealitySpeechHandler 介面。 當使用者以這個 ShowHideSpeechHandler 類別將焦點放在 GameObject 時，說出「較小」或「較大」這個字時，GameObject 將自行調整為一半或兩倍。

public class ShowHideSpeechHandler : MonoBehaviour, IMixedRealitySpeechHandler
{
    ...

    void IMixedRealitySpeechHandler.OnSpeechKeywordRecognized(SpeechEventData eventData)
    {
        if (eventData.Command.Keyword == "smaller")
        {
            transform.localScale *= 0.5f;
        }
        else if (eventData.Command.Keyword == "bigger")
        {
            transform.localScale *= 2.0f;
        }
    }
}

註冊全域輸入事件

若要建立可接聽全域輸入事件的元件，忽略 GameObject 可能處於焦點，元件必須向輸入系統註冊本身。 註冊之後，此 MonoBehaviour 的任何實例都會接收輸入事件，以及目前處於焦點的 GameObject (s) 和其他全域註冊接聽程式。

如果輸入事件標示 為已使用，全域註冊的處理常式仍會全部接收回呼。 不過，沒有焦點的 GameObjects 會收到事件。

全域輸入註冊範例

public class GlobalHandListenerExample : MonoBehaviour,
    IMixedRealitySourceStateHandler, // Handle source detected and lost
    IMixedRealityHandJointHandler // handle joint position updates for hands
{
    private void OnEnable()
    {
        // Instruct Input System that we would like to receive all input events of type
        // IMixedRealitySourceStateHandler and IMixedRealityHandJointHandler
        CoreServices.InputSystem?.RegisterHandler<IMixedRealitySourceStateHandler>(this);
        CoreServices.InputSystem?.RegisterHandler<IMixedRealityHandJointHandler>(this);
    }

    private void OnDisable()
    {
        // This component is being destroyed
        // Instruct the Input System to disregard us for input event handling
        CoreServices.InputSystem?.UnregisterHandler<IMixedRealitySourceStateHandler>(this);
        CoreServices.InputSystem?.UnregisterHandler<IMixedRealityHandJointHandler>(this);
    }

    // IMixedRealitySourceStateHandler interface
    public void OnSourceDetected(SourceStateEventData eventData)
    {
        var hand = eventData.Controller as IMixedRealityHand;

        // Only react to articulated hand input sources
        if (hand != null)
        {
            Debug.Log("Source detected: " + hand.ControllerHandedness);
        }
    }

    public void OnSourceLost(SourceStateEventData eventData)
    {
        var hand = eventData.Controller as IMixedRealityHand;

        // Only react to articulated hand input sources
        if (hand != null)
        {
            Debug.Log("Source lost: " + hand.ControllerHandedness);
        }
    }

    public void OnHandJointsUpdated(
                InputEventData<IDictionary<TrackedHandJoint, MixedRealityPose>> eventData)
    {
        MixedRealityPose palmPose;
        if (eventData.InputData.TryGetValue(TrackedHandJoint.Palm, out palmPose))
        {
            Debug.Log("Hand Joint Palm Updated: " + palmPose.Position);
        }
    }
}

註冊後援輸入事件

後援輸入處理常式類似于已註冊的全域輸入處理常式，但會被視為輸入事件處理的最後手段。 只有在找不到全域輸入處理常式且沒有 GameObjects 處於焦點時，才會利用後援輸入處理常式。

後援輸入處理常式範例

public class GlobalHandListenerExample : MonoBehaviour,
    IMixedRealitySourceStateHandler // Handle source detected and lost
{
    private void OnEnable()
    {
        CoreServices.InputSystem?.PushFallbackInputHandler(this);
    }

    private void OnDisable()
    {
        CoreServices.InputSystem?.PopFallbackInputHandler();
    }

    // IMixedRealitySourceStateHandler interface
    public void OnSourceDetected(SourceStateEventData eventData)
    {
        ...
    }

    public void OnSourceLost(SourceStateEventData eventData)
    {
        ...
    }
}

如何停止輸入事件

每個輸入事件介面都會 BaseInputEventData 提供資料物件做為介面上每個函式的參數。 這個事件資料物件會從 Unity 自己的 AbstractEventData 擴充。

為了停止輸入事件以 概述的方式傳播其執行，元件可以呼叫 AbstractEventData.Use() 來將事件標示為已使用。 這將會停止任何其他 GameObject 接收目前的輸入事件，但全域輸入處理常式除外。

另請參閱

• 指標
• 語音
• 輸入狀態