Files
godot-docs-l10n/classes/zh_CN/class_mobilevrinterface.rst

191 lines
8.7 KiB
ReStructuredText

:github_url: hide
.. DO NOT EDIT THIS FILE!!!
.. Generated automatically from Godot engine sources.
.. Generator: https://github.com/godotengine/godot/tree/4.2/doc/tools/make_rst.py.
.. XML source: https://github.com/godotengine/godot/tree/4.2/modules/mobile_vr/doc_classes/MobileVRInterface.xml.
.. _class_MobileVRInterface:
MobileVRInterface
=================
**继承:** :ref:`XRInterface<class_XRInterface>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
通用移动 VR 实现。
.. rst-class:: classref-introduction-group
描述
----
这是一个通用的移动 VR 实现,你需要提供有关所用手机和 HMD 的详细信息。它不依赖于任何现有框架。这是我们拥有的最基本的接口。为了获得最佳效果,你需要一部带有陀螺仪和加速度计的手机。
请注意,即使没有位置跟踪,相机也会假定头戴设备处于 1.85 米的高度。可以通过设置 :ref:`eye_height<class_MobileVRInterface_property_eye_height>` 来更改该设置。
可以按如下方式初始化该接口:
::
var interface = XRServer.find_interface("Native mobile")
if interface and interface.initialize():
get_viewport().xr = true
.. rst-class:: classref-reftable-group
属性
----
.. table::
:widths: auto
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`display_to_lens<class_MobileVRInterface_property_display_to_lens>` | ``4.0`` |
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`display_width<class_MobileVRInterface_property_display_width>` | ``14.5`` |
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`eye_height<class_MobileVRInterface_property_eye_height>` | ``1.85`` |
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`iod<class_MobileVRInterface_property_iod>` | ``6.0`` |
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`k1<class_MobileVRInterface_property_k1>` | ``0.215`` |
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`k2<class_MobileVRInterface_property_k2>` | ``0.215`` |
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`oversample<class_MobileVRInterface_property_oversample>` | ``1.5`` |
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
| :ref:`PlayAreaMode<enum_XRInterface_PlayAreaMode>` | xr_play_area_mode | ``1`` (overrides :ref:`XRInterface<class_XRInterface_property_xr_play_area_mode>`) |
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
属性说明
--------
.. _class_MobileVRInterface_property_display_to_lens:
.. rst-class:: classref-property
:ref:`float<class_float>` **display_to_lens** = ``4.0``
.. rst-class:: classref-property-setget
- void **set_display_to_lens** **(** :ref:`float<class_float>` value **)**
- :ref:`float<class_float>` **get_display_to_lens** **(** **)**
显示器与设备内部镜片之间的距离,单位为厘米。
.. rst-class:: classref-item-separator
----
.. _class_MobileVRInterface_property_display_width:
.. rst-class:: classref-property
:ref:`float<class_float>` **display_width** = ``14.5``
.. rst-class:: classref-property-setget
- void **set_display_width** **(** :ref:`float<class_float>` value **)**
- :ref:`float<class_float>` **get_display_width** **(** **)**
显示器的宽度,单位为厘米。
.. rst-class:: classref-item-separator
----
.. _class_MobileVRInterface_property_eye_height:
.. rst-class:: classref-property
:ref:`float<class_float>` **eye_height** = ``1.85``
.. rst-class:: classref-property-setget
- void **set_eye_height** **(** :ref:`float<class_float>` value **)**
- :ref:`float<class_float>` **get_eye_height** **(** **)**
相机相对于地面所处的高度(即相对于 :ref:`XROrigin3D<class_XROrigin3D>` 节点)。
.. rst-class:: classref-item-separator
----
.. _class_MobileVRInterface_property_iod:
.. rst-class:: classref-property
:ref:`float<class_float>` **iod** = ``6.0``
.. rst-class:: classref-property-setget
- void **set_iod** **(** :ref:`float<class_float>` value **)**
- :ref:`float<class_float>` **get_iod** **(** **)**
眼间距离,也称为瞳孔间距离。左眼和右眼瞳孔之间的距离。
.. rst-class:: classref-item-separator
----
.. _class_MobileVRInterface_property_k1:
.. rst-class:: classref-property
:ref:`float<class_float>` **k1** = ``0.215``
.. rst-class:: classref-property-setget
- void **set_k1** **(** :ref:`float<class_float>` value **)**
- :ref:`float<class_float>` **get_k1** **(** **)**
k1 镜头因子是定义所使用镜头强度的两个常量之一,并直接影响镜头失真效果。
.. rst-class:: classref-item-separator
----
.. _class_MobileVRInterface_property_k2:
.. rst-class:: classref-property
:ref:`float<class_float>` **k2** = ``0.215``
.. rst-class:: classref-property-setget
- void **set_k2** **(** :ref:`float<class_float>` value **)**
- :ref:`float<class_float>` **get_k2** **(** **)**
k2 镜头因子,见 k1。
.. rst-class:: classref-item-separator
----
.. _class_MobileVRInterface_property_oversample:
.. rst-class:: classref-property
:ref:`float<class_float>` **oversample** = ``1.5``
.. rst-class:: classref-property-setget
- void **set_oversample** **(** :ref:`float<class_float>` value **)**
- :ref:`float<class_float>` **get_oversample** **(** **)**
过采样设置。由于镜头失真,我们必须以比屏幕自然分辨率更高的质量渲染我们的缓冲区。介于 1.5 和 2.0 之间的值通常可以提供良好的结果,但会牺牲性能。
.. |virtual| replace:: :abbr:`virtual (本方法通常需要用户覆盖才能生效。)`
.. |const| replace:: :abbr:`const (本方法没有副作用。不会修改该实例的任何成员变量。)`
.. |vararg| replace:: :abbr:`vararg (本方法除了在此处描述的参数外,还能够继续接受任意数量的参数。)`
.. |constructor| replace:: :abbr:`constructor (本方法用于构造某个类型。)`
.. |static| replace:: :abbr:`static (调用本方法无需实例,所以可以直接使用类名调用。)`
.. |operator| replace:: :abbr:`operator (本方法描述的是使用本类型作为左操作数的有效操作符。)`
.. |bitfield| replace:: :abbr:`BitField (这个值是由下列标志构成的位掩码整数。)`