XRInputSource: profiles 属性

安全上下文：此功能仅在安全上下文（HTTPS）中可用，在部分或所有支持的浏览器中可用。

只读的XRInputSource属性profiles返回一个字符串数组，每个字符串描述输入源的配置概要文件。概要文件字符串按特异性顺序排列，最特异的概要文件列在最前面。

注意：当 WebXR 会话处于内联模式时，profiles 列表始终为空。

值

一个字符串数组，每个字符串描述一个由 XRInputSource 对象表示的输入设备的配置概要文件。每个输入概要文件指定输入源的首选视觉表示和行为。

输入概要文件名称

输入概要文件名称是一个字符串，描述输入源可能配置为使用的视觉表示和行为。每个字符串

  • 没有空格；而是用连字符 (“-”) 字符分隔单词
  • 如果平台提供，则可能会提供 USB 供应商和产品 ID，但不能依赖于此
  • 不能唯一标识特定设备；相反，它标识产品能够使用的配置
  • 不提供有关设备手性的信息，如果适用

设备开发人员和浏览器开发人员使用WebXR 输入概要文件注册表来尝试确保给定设备无论使用哪个浏览器或其他用户代理都将报告相同的概要文件字符串。

通用输入概要文件名称

以下输入概要文件名称是通用的，可以用作描述设备的最粗略意义上的后备方案。

  • generic-button
  • generic-hand-select-grasp
  • generic-hand-select
  • generic-hand
  • generic-touchpad
  • generic-touchscreen
  • generic-trigger-squeeze-thumbstick
  • generic-trigger-squeeze-touchpad-thumbstick
  • generic-trigger-squeeze-touchpad
  • generic-trigger-squeeze
  • generic-trigger-thumbstick
  • generic-trigger-touchpad-thumbstick
  • generic-trigger-touchpad
  • generic-trigger

示例

profiles 中的列表按反特异性顺序排列；也就是说，最精确的描述在最前面，最不精确的描述在最后面。列表中的第一个条目通常表示控制器的确切型号，或者控制器兼容的型号。

例如，Oculus Touch 控制器中 profiles 中的条目 0 是 oculus-touch。下一个条目是 generic-trigger-squeeze-thumbstick，表示具有触发器、挤压控制和拇指摇杆的通用设备。虽然 Oculus Touch 控制器实际上有一个拇指板而不是一个拇指摇杆，但总体描述是“足够接近”，以至于与名称匹配的概要文件中的详细信息将使控制器能够被有效地解释。

js
inputSource.profiles;
// ['oculus-touch', 'generic-trigger-squeeze-thumbstick']

规范

规范
WebXR 设备 API
# dom-xrinputsource-profiles

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅