XRSession: end 事件

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

當 WebXR 會話結束時,會在 XRSession 物件上觸發一個 end 事件,原因可能是 Web 應用程式已選擇停止會話,或者 使用者代理終止了會話。

語法

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

js
addEventListener("end", (event) => { })

onend = (event) => { }

事件型別

一個 XRSessionEvent。繼承自 Event

Event XRSessionEvent

事件屬性

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

session 只讀

事件所引用的 XRSession

描述

觸發

當 WebXR 會話結束時觸發,原因可能是 Web 應用程式已選擇停止會話,或者 使用者代理終止了會話。

此事件不可取消,也不會冒泡。

用例

您可以使用此事件來響應 WebXR 會話的結束。例如,您可能希望顯示一個 UI 元素來告知會話已終止。

示例

要獲知 WebXR 會話何時結束,您可以使用 addEventListener() 在您的 XRSession 例項上新增一個處理程式,如下所示:

js
XRSession.addEventListener("end", (event) => {
  /* the session has shut down */
});

或者,您可以使用 XRSession.onend 事件處理程式屬性來為 end 事件設定處理程式。

js
XRSession.onend = (event) => {
  /* the session has shut down */
};

規範

規範
WebXR Device API
# eventdef-xrsession-end
WebXR Device API
# dom-xrsession-onend

瀏覽器相容性