mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
251 lines
14 KiB
ReStructuredText
251 lines
14 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_MobileVRInterface:
|
||
|
||
MobileVRInterface
|
||
=================
|
||
|
||
**Hérite de :** :ref:`XRInterface<class_XRInterface>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||
|
||
Implémentation de RV mobile générique.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Description
|
||
-----------
|
||
|
||
Il s'agit d'une implémentation VR mobile générique où vous devez fournir des détails sur le téléphone et le casque utilisés. Il ne repose sur aucune bibliothèque existante. C'est l'interface la plus basique que nous avons. Pour un meilleur résultat, vous avez besoin d'un téléphone mobile avec un gyroscope et un accéléromètre intégrés.
|
||
|
||
Notez que même s'il n'y a pas de suivi de la position, la caméra suppose que le casque est à une hauteur de 1.85 mètres. Vous pouvez changer cela en définissant :ref:`eye_height<class_MobileVRInterface_property_eye_height>`.
|
||
|
||
Vous pouvez initialiser cette interface ainsi :
|
||
|
||
::
|
||
|
||
var interface = XRServer.find_interface("Native mobile")
|
||
if interface and interface.initialize():
|
||
get_viewport().use_xr = true
|
||
|
||
\ **Note :** Pour Android, :ref:`ProjectSettings.input_devices/sensors/enable_accelerometer<class_ProjectSettings_property_input_devices/sensors/enable_accelerometer>`, :ref:`ProjectSettings.input_devices/sensors/enable_gravity<class_ProjectSettings_property_input_devices/sensors/enable_gravity>`, :ref:`ProjectSettings.input_devices/sensors/enable_gyroscope<class_ProjectSettings_property_input_devices/sensors/enable_gyroscope>` et :ref:`ProjectSettings.input_devices/sensors/enable_magnetometer<class_ProjectSettings_property_input_devices/sensors/enable_magnetometer>` doivent être activés.
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Propriétés
|
||
--------------------
|
||
|
||
.. 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:`Rect2<class_Rect2>` | :ref:`offset_rect<class_MobileVRInterface_property_offset_rect>` | ``Rect2(0, 0, 1, 1)`` |
|
||
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`oversample<class_MobileVRInterface_property_oversample>` | ``1.5`` |
|
||
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`vrs_min_radius<class_MobileVRInterface_property_vrs_min_radius>` | ``20.0`` |
|
||
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`vrs_strength<class_MobileVRInterface_property_vrs_strength>` | ``1.0`` |
|
||
+----------------------------------------------------+--------------------------------------------------------------------------+------------------------------------------------------------------------------------+
|
||
| :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
|
||
|
||
Descriptions des propriétés
|
||
------------------------------------------------------
|
||
|
||
.. _class_MobileVRInterface_property_display_to_lens:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **display_to_lens** = ``4.0`` :ref:`🔗<class_MobileVRInterface_property_display_to_lens>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_display_to_lens**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_display_to_lens**\ (\ )
|
||
|
||
La distance entre l’affichage et les lentilles à l’intérieur de l’appareil en centimètres.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_MobileVRInterface_property_display_width:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **display_width** = ``14.5`` :ref:`🔗<class_MobileVRInterface_property_display_width>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_display_width**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_display_width**\ (\ )
|
||
|
||
La largeur de l'écran en centimètres.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_MobileVRInterface_property_eye_height:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **eye_height** = ``1.85`` :ref:`🔗<class_MobileVRInterface_property_eye_height>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_eye_height**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_eye_height**\ (\ )
|
||
|
||
La hauteur à laquelle la caméra est placée par rapport au sol (c'est-à-dire au nœud :ref:`XROrigin3D<class_XROrigin3D>`).
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_MobileVRInterface_property_iod:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **iod** = ``6.0`` :ref:`🔗<class_MobileVRInterface_property_iod>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_iod**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_iod**\ (\ )
|
||
|
||
La distance interoculaire, aussi appelée la distance interpupillaire. La distance entre la pupille de l'œil gauche et celle du l'œil droit.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_MobileVRInterface_property_k1:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **k1** = ``0.215`` :ref:`🔗<class_MobileVRInterface_property_k1>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_k1**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_k1**\ (\ )
|
||
|
||
Le facteur de lentille k1 est l'une des deux constantes qui définisse l'intensité de la lentille utilisée et influence directement l'effet de déformation des lentilles.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_MobileVRInterface_property_k2:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **k2** = ``0.215`` :ref:`🔗<class_MobileVRInterface_property_k2>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_k2**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_k2**\ (\ )
|
||
|
||
Le facteur k2 de lentille, voir k1.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_MobileVRInterface_property_offset_rect:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Rect2<class_Rect2>` **offset_rect** = ``Rect2(0, 0, 1, 1)`` :ref:`🔗<class_MobileVRInterface_property_offset_rect>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_offset_rect**\ (\ value\: :ref:`Rect2<class_Rect2>`\ )
|
||
- :ref:`Rect2<class_Rect2>` **get_offset_rect**\ (\ )
|
||
|
||
Définit le rectangle de décalage par rapport à la zone en cours de rendu. Une longueur de 1 représente l'ensemble de la zone de rendu sur cet axe.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_MobileVRInterface_property_oversample:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **oversample** = ``1.5`` :ref:`🔗<class_MobileVRInterface_property_oversample>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_oversample**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_oversample**\ (\ )
|
||
|
||
Le paramètre de sur-échantillon. En raison de la distorsion de la lentille, nous devons rendre nos buffers à une résolution plus élevée que l'écran peut manipuler nativement. Une valeur entre 1.5 et 2.0 fournit souvent de bons résultats, mais avec un coût sur les performances.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_MobileVRInterface_property_vrs_min_radius:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **vrs_min_radius** = ``20.0`` :ref:`🔗<class_MobileVRInterface_property_vrs_min_radius>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_vrs_min_radius**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_vrs_min_radius**\ (\ )
|
||
|
||
Le rayon minimal autour du point focal où la pleine qualité est garantie si VRS est utilisé en tant que pourcentage de la taille de l'écran.
|
||
|
||
\ **Note :** Moteurs de rendu Mobile et Forward+ seulement. Nécessite :ref:`Viewport.vrs_mode<class_Viewport_property_vrs_mode>` d'être défini à :ref:`Viewport.VRS_XR<class_Viewport_constant_VRS_XR>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_MobileVRInterface_property_vrs_strength:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **vrs_strength** = ``1.0`` :ref:`🔗<class_MobileVRInterface_property_vrs_strength>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_vrs_strength**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_vrs_strength**\ (\ )
|
||
|
||
La force utilisée pour calculer la carte de densité VRS. Plus cette valeur est grande, plus le VRS est notable. Cela améliore la performance au coût de la qualité.
|
||
|
||
\ **Note :** Moteurs de rendu Mobile et Forward+ seulement. Nécessite :ref:`Viewport.vrs_mode<class_Viewport_property_vrs_mode>` d'être défini à :ref:`Viewport.VRS_XR<class_Viewport_constant_VRS_XR>`.
|
||
|
||
.. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)`
|
||
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
|
||
.. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)`
|
||
.. |vararg| replace:: :abbr:`vararg (Cette méthode accepte n'importe quel nombre d'arguments après ceux décris ici.)`
|
||
.. |constructor| replace:: :abbr:`constructor (Cette méthode est utilisée pour construire un type.)`
|
||
.. |static| replace:: :abbr:`static (Cette méthode n'a pas besoin d'instance pour être appelée, elle peut donc être directement appelée en utilisant le nom de la classe.)`
|
||
.. |operator| replace:: :abbr:`operator (Cette méthode décrit un opérateur valide à utiliser avec ce type en tant qu'opérande gauche.)`
|
||
.. |bitfield| replace:: :abbr:`BitField (Cette valeur est un nombre entier composé d'un masque de bits des options suivantes.)`
|
||
.. |void| replace:: :abbr:`void (Aucune valeur de retour.)`
|