mrtk_developmentreleases/2.0.0releases/2.1.0releases/2.2.0

    Show / Hide Table of Contents

    点击放置 Tap to Place

    TapToPlace

    Tap to Place是一个远程交互组件,用于在表面上放置游戏对象。这个组件对于在空间网格上放置对象非常有用。点击放置使用了两次点击和头部移动的组合来放置一个对象。点击开始放置,头部移动控制对象的位置,点击将对象放置在场景中。

    使用 Tap to Place

    1. 设置场景 -创建一个新的unity场景 -添加MRTK到场景导航到Mixed Reality Toolkit > Add to Scene and Configure

      Note

      Tap to Place使用由MRTK输入系统驱动的点击,但是它也可以不用点击来控制,请看下面的点击放置代码可配置性一节。 -添加一个立方体到场景中,将比例改为0.2,位置改为(0,0,0.7)。

    2. 将Tap to Place附加到具有碰撞器的游戏对象上

      TapToPlaceInspector

      -当Tap to Place组件被添加时,一个求解程序处理程序也将被附加。点到位置来自Solver类,它需要一个Solver Handler。点击放置对象的位置是相对于Solver Handler中的TrackedTargetType计算的。默认情况下,头部是TrackedTargetType,也就是说,当头部移动时,如果它被选中,对象也会跟着移动。TrackedTargetType也可以设置为Controller Ray,它让对象跟随控制器。Tap to Place检查器中的第一组属性是Common Solver属性。

      Important

      Tap to Place是一个独立的Solver,不能与其他Solver连接。它不能被链接,因为SolverHandler.UpdateSolvers用于在放置对象时更新对象的位置。

      • Tap to Place 属性:
        • Auto Start:如果为真,点击位置Solver将开始控制游戏对象的位置。对象将立即开始跟随TrackedTargetType(头或控制器射线)。必须在调用Start()之前修改该值,才能产生效果。
        • Default Placement Distance:在SolverHandler中,一个对象被放置的默认距离(单位为米)是相对于TrackedTargetType向前的。如果表面没有被射线投射击中,游戏对象将被放置在默认的位置距离。
        • Max Raycast Distance:基于'TrackedTargetType'原点的射线投射的最大距离(米)。这个射线寻找一个表面来放置选中的对象。
        • Surface Normal Offset:如果射线投射命中表面,游戏物体要放置的中心和表面法线上的表面之间的距离。默认情况下,表面法线偏移量为0,但是在Start()之后,表面法线偏移量被设置为碰撞器沿z轴的范围。
        • Keep Orientation Vertical:如果为真,要放置的游戏对象将保持垂直并与Vector3.up保持一致。
        • Rotate According to Surface:如果为false,游戏对象将不会根据击中表面而改变旋转。当被设置为true时,物体将保持面对摄像机。
        • Magnetic Surfaces:从最高到最低优先级执行的LayerMask数组。第一层layer mask 提供一个投射命中用于位置计算。
        • Debug Enabled:如果为真,在Unity编辑器中,射线命中的法线将被绘制成黄色。当RotateAccordingToSurface为true时,启用调试很有用,因为它绘制表面命中的法线,这直观地解释了为什么对象被设置为当前方向。
        • On Placing Started:当选择放置游戏对象时,这个事件会触发一次。
        • On Placing Stopped:当游戏对象放置未被选择,放置时,这个事件被触发一次。
    3. 在编辑器中测试Tap to Place 行为 -按play键并按住空格键显示输入仿真手。 -移动手,直到立方体处于对焦状态,用输入的模拟手点击鼠标左键,模拟点击。 -如果碰撞器没有出现在场景中,对象将遵循TrackedTargetType在定义的Default Placement Distance。 -对象在选择后会跟随TrackedTargetType的移动。在编辑器中模拟头部运动,按WASD键。按住鼠标右键改变头部旋转。 -要停止放置对象,请再次单击。单击停止位置时,对象不需要处于聚焦中。只有在开始放置过程的初始点击时才需要聚焦。

      TrackedTargetType: 头部(默认) TrackedTargetType: 控制器射线
      TapToPlaceInputSimulationHead TapToPlaceInputSimulationControllerRay

    Tap to Place 代码可配置性

    Tap to Place 选择时间也可以通过StartPlacement() 和StopPlacement() 来控制,而不需要一个点击事件。此功能对于编写测试非常有用,并提供了在不使用MRTK输入系统的情况下在编辑器中放置对象的替代方法。

    1. 创建一个空的游戏对象

    2. 创建以下示例脚本并将其附加到空的游戏对象

      using UnityEngine;
      using Microsoft.MixedReality.Toolkit.Utilities.Solvers;
      
      public class TapToPlaceInputExample : MonoBehaviour
      {
          private GameObject cube;
          private TapToPlace tapToPlace;
      
          void Start()
          {
              cube = GameObject.CreatePrimitive(PrimitiveType.Cube);
              cube.transform.localScale = Vector3.one * 0.2f;
              cube.transform.position = Vector3.forward * 0.7f;
      
              tapToPlace = cube.AddComponent<TapToPlace>();
          }
      
          void Update()
          {
              if (Input.GetKeyDown(KeyCode.U))
              {
                  tapToPlace.StartPlacement();
              }
              if (Input.GetKeyDown(KeyCode.I))
              {
                  tapToPlace.StopPlacement();
              }
          }
      }
      
    3. 在播放模式下,按U键开始放置立方体

    4. 按I键停止放置

    Tap to Place 示例场景

    Tap to Place示例场景由4个可替换的对象组成,每个对象都有不同的配置。示例场景包含墙壁,以显示hierarchy中默认禁用的表面放置行为。示例场景可以在 Microsoft.MixedReality.Toolkit.Unity.Examples中找到。在[发布页面](https://github.com/Microsoft/MixedRealityToolkit-Unity/releases找到unity包的例子。场景位置为:*MRTK.Examples/Demos/Solvers/Scenes/TapToPlaceExample.unity*

    TapToPlaceExampleScene

    建议浏览

    • Solvers
    • 空间感知
    • 输入模拟
    • 手部跟踪
    • 凝视
    • Improve this Doc
    In This Article
    • 使用 Tap to Place
    • Tap to Place 代码可配置性
    • Tap to Place 示例场景
    • 建议浏览
    Back to top Generated by DocFX