Table of Contents

快速开始

SDK导入

下载地址：TI3D-Core

在Unity中开启PackageManager，点击左上角加号，Add package from tarball，在打开的文件资源管理器中选择给出的com.turing.3dcore-1.0.0.0.tgz文件。等待编辑器编译完成

工程设置

  • SDK不需要依赖Unity内置的 XR Settings 。

    Color Space

    Edit > Project Settings > Player > Other Settings > ColorSpace > Linear

  • .NET Version

    Edit > Project Settings > Player > Other Settings > .NET Version 4.x

  • 如果项目使用了XR Settings中的 Virtual Reality Supported，请取消勾选

    1

Samples导入

packageManager中导入Turing 3D Core，选择Samples导入，导入后共10个示例场景，可将示例场景Build为EXE可执行文件，在Turing智能设备上运行。

  • 00_BasicScene_Menu 基础场景，包括UI的跳转

  • 01_BasicScene_WithTuring 包括基础的3D成像显示，物体的拖拽交互

  • 02_TuringCamera_TuringFrame TuringFrame概念，每个Frame可以视为一个预设好的屏幕

  • 03_IpointerHandlers 交互事件

  • 04_TuringPointer_MaxHitDistance 最大交互距离

  • 05_TuringPointer_MaxHitRadius 最大碰撞范围

  • 06_TuringPointer_IgnoreMask 交互层级的剔除

  • 07_TuringPointer_PriorityMask 重点层级，当碰撞范围内同时有可交互的两个层级物体时，优先碰重点层级

  • 08_TuringPointer_DefaultDragPolicy 以屏幕为基准的拖拽交互

  • 09_TuringPointer_CustomDragPlane 以自定义平面为基准的拖拽交互

  • 10_TuringFirstPerson 第一人称漫游示例

第一人称漫游

先右键创建TuringCameraRig，右键创建Empty，起名为Player， 将TuringCameraRig上的isFirstPerson勾选为true， Player的坐标设置为Camera的位置， 将TuringCameraRig设置为Player子物体， 如果更改TuringFrame属性，需要重新将Player位置设为与Camera位置相同。

基础场景搭建

  • 00_BasicScene_Menu 是原始场景，可以以下菜单自动添加组件到场景中。

    GameObject > Turing > All

    2

  • 场景组件添加后，默认的视口大小Viewer Scale 是 10，在TuringFrame组件中可设置视口大小。

    3

  • 设置场景倾角在 TuringDisplayAligner 组件

    4

  • 最后，再次选择TuringFrame，并将其pos Z值设置为-2.25。

    5

Scene视图绘制内容

  • 将主要的预制体和组件放置到场景中时，这些预制体和组件会绘制线框与图像来描述它们与世界空间的关系。以下 是场景中的线框与图像所代表的含义。

    6

    7

其他注意事项

  • 如果脚本正在修改TuringFrame或TuringCameraRig的位置，最好将脚本的执行顺序设置在TuringCameraRig之前。
[DefaultExecutionOrder(TuringCameraRig.ScriptPriority - 1)]
  • 如果脚本依赖于TuringFrame或TuringCameraRig的位置数据，最好将脚本的执行顺序设置在TuringCameraRig之后。
[DefaultExecutionOrder(TuringCameraRig.ScriptPriority + 1)]
  • 随着相机移动而出现抖动的场景或物体，通常是由于脚本的执行顺序设置不当造成。