XRSession: select 事件

語法

在諸如 addEventListener() 之類的方法中使用事件名稱，或設定事件處理程式屬性。

addEventListener("select", (event) => { })

onselect = (event) => { }

事件型別

一個 XRInputSourceEvent。繼承自 Event。

事件屬性

除了下面列出的屬性之外，父介面 Event 的屬性也可使用。

frame 只讀

一個 XRFrame 物件，提供事件發生期間所需的事件幀資訊。此幀可能是在過去渲染的，而不是當前的幀。因為這是一個事件幀，而不是動畫幀，所以您不能在其上呼叫 XRFrame.getViewerPose()；而是使用 getPose()。

inputSource 只讀

一個 XRInputSource 物件，指示是哪個輸入源生成了此輸入事件。

描述

觸發

當用戶按下觸發器或按鈕、輕觸觸控板、說出命令或在使用影片跟蹤系統或帶加速度計的手持控制器時執行可識別的手勢時，會觸發此事件。

用例

selectstart 和 selectend 事件會告知您何時可能需要向用戶顯示一些內容，以指示主要操作正在進行。這可能包括用新顏色繪製帶有啟用按鈕的控制器，或者在 `selectstart` 到達時開始、在 `selectend` 收到時停止顯示被抓取和移動的目標物件。

select 事件會告知您的程式碼使用者已完成一項操作。這可能很簡單，比如在遊戲中扔一個物體或扣動槍的扳機，或者像將拖動的物體放置在新位置一樣複雜。

如果您的主要操作是一個簡單的觸發器操作，並且您在觸發器接合期間不需要為任何內容設定動畫，您可以忽略 selectstart 和 selectend 事件，並在開始事件上執行操作。

示例

以下示例使用 addEventListener() 來設定 `select` 事件的事件處理程式。該處理程式獲取代表 `tracked-pointer` 輸入的目標射線（ray）的姿態，並將姿態的變換髮送到一個名為 `myHandleSelectWithRay()` 的函式。

xrSession.addEventListener("select", (event) => {
  if (event.inputSource.targetRayMode === "tracked-pointer") {
    let targetRayPose = event.frame.getPose(
      event.inputSource.targetRaySpace,
      myRefSpace,
    );
    if (targetRayPose) {
      myHandleSelectWithRay(targetRayPose.transform);
    }
  }
});

您也可以透過將 XRSession 物件的 `onselect` 事件處理程式屬性設定為處理該事件的函式來設定 `select` 事件的處理程式。

xrSession.onselect = (event) => {
  if (event.inputSource.targetRayMode === "tracked-pointer") {
    let targetRayPose = event.frame.getPose(
      event.inputSource.targetRaySpace,
      myRefSpace,
    );
    if (targetRayPose) {
      myHandleSelectWithRay(targetRayPose.transform);
    }
  }
};

規範

瀏覽器相容性

另見

• selectstart 和 selectend
• beforexrselect