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

浏览器兼容性