跳到主要内容

模板功能介绍以及开发注意事项

该篇将为您介绍该模板实现的基础功能,以及自定义开发该项目模板的注意事项

模板功能介绍

  • 相机移动:您可以按下手柄摇杆在场景中进行瞬移、左右推摇杆进行视角的旋转。
  • 拾取物体:将手柄靠近桌子上的物体,在物体出现轮廓线时即可按下手柄侧键拾取物体,松开侧键可以将物体扔出(该功能仅支持刚体)。
  • vr菜单功能:场景中存在一个vr菜单节点(左手柄X键呼出),其功能与VR相机插件中的手柄菜单功能相同。在其中指定工具节点即可通过手柄菜单对指定节点下的物体进行移动和显隐操作。
  • 步骤提示:场景中使用了步骤提示插件,您可以根据描述体验项目模板中的实现的基本功能。
  • 重置场景:点击桌面上的重置按钮会将场景还原。
  • 调试工具:按下左手柄Y键将在手柄上显示实时帧率,可作为场景资源优化的参考。

二次开发指南

现有节点的修改

关于对场景中现有节点的修改,请参考以下建议:

  • QiGuangCamera:不要修改该子场景,这其中包含了正常导出七光头盔apk的必要逻辑以及vr相机等基础节点,如果修改该场景可能会导致导出的apk无法在七光头盔中运行。
  • vr菜单:您可以任意指定vr菜单节点中的工具节点。您不需要为工具节点下的模型添加碰撞体,他们会在项目运行时自动创建。
  • 步骤提示:场景中的步骤提示节点只作为基本功能的教程,删除不会对项目造成影响。
  • 环境模型:包含了场景中除跑车之外的所有模型,您可以任意修改删除其中的节点。
  • 定向光和世界环境:可任意修改,但需要注意,定向光中阴影的开启会造成帧数的急剧下降。
  • 跑车:用于vr菜单节点使用的模型,可随意修改。

交互制作

您可以在交互编辑器中使用VR手柄触发器和VR手柄模型替换触发器,这两个触发器功能与vr相机插件中的用法一致。

详情见:如何连接交互

注意
  • 目前版本的七光项目模板不支持与vr插件兼容,请不要下载vr插件到该模板,否则会导致VR手柄触发器和VR手柄模型替换触发器这两个交互编辑器模块无法正常使用,甚至影响项目的正常运行。

目前兼容的插件

由于一体机的交互模式和设备性能的限制,目前项目模板仅兼容部分插件:

  • 3d视频播放器
  • 3d幻灯片播放器
  • 步骤提示
  • 人物对话
  • 菜单选择
  • 3d面板
  • 3d按钮
  • 3d字体
  • 爆炸展示
  • 顺序拆装
  • 寻路指引
  • 路径移动
  • 自动跟随
  • 考题系统
  • 监控

开发注意事项

  • 目前仅支持在性能优先模式下导出apk到七光头盔。如果使用效果优先会导致帧率下降严重或无法正常运行项目。

  • 该项目无法在PC模式下正常运行,最终的运行效果只能导出apk后在七光头盔中运行查看。

  • 由于该项目模板是直接导出apk到VR头盔中,所以运行效果完全取决于头盔本身的性能。头盔性能做不到像PC那样强劲,再加上头盔中的帧率要求比PC高(帧率低会导致眩晕和黑边)这就使得项目对灯光以及模型上有着比较严格的限制。这里给出一些建议:

    1. 尽量不要使用实时光和阴影,可使用烘焙或者自发光来实现近似效果。

    2. 模型的贴图大小尽量控制在1024*1024以内。

    3. 场景模型总面数控制在百万面以下。

    4. 模型尽量合并贴图,使用相同材质球以减少绘制调用(DrawCall),总的绘制调用控制在400以下。 关于场景中面数等相关信息可以勾选查看信息进行显示。

      其中FPS为当前电脑环境下的帧数,在该项目中基本不具备参考意义,如需查看场景实际帧数请在七光头盔中运行项目,按下左手柄上的Y键进行查看。

  • 关于身高校准的注意事项:如果存在跟踪位置不准确或者跟踪位置丢失的情况,请尝试长按手柄上的home键或者关闭项目重新运行。