XRSession: end 事件

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

安全上下文: 此功能仅在 安全上下文(HTTPS)中可用,在一些或所有 支持的浏览器 中可用。

当 WebXR 会话结束时,end 事件会在 XRSession 对象上触发,无论是由于 Web 应用程序选择停止会话,还是由于 用户代理 终止了会话。

语法

在诸如 addEventListener() 之类的事件处理函数中使用事件名称,或设置事件处理程序属性。

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

onend = (event) => {};

事件类型

事件属性

除了下面列出的属性之外,父接口 Event 的属性也可使用。

session 只读

与事件相关的 XRSession

描述

触发

当 WebXR 会话结束时触发,无论是由于 Web 应用程序选择停止会话,还是由于 用户代理 终止了会话。

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

用例

您可以使用此事件来对 WebXR 会话的结束做出反应。例如,您可能希望显示一个 UI 元素来告知会话的终止。

示例

要了解 WebXR 会话何时结束,您可以使用 XRSession 实例的 addEventListener() 为其添加处理程序,如下所示

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

或者,您可以使用 XRSession.onend 事件处理程序属性为 end 事件建立处理程序

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

规范

规范
WebXR 设备 API
# eventdef-xrsession-end
WebXR 设备 API
# dom-xrsession-onend

浏览器兼容性

BCD 表格仅在浏览器中加载