mrtk_developmentreleases/2.0.0releases/2.1.0releases/2.2.0
  • 指南
  • API 文档
  • 指南
  • MRTK入门
  • 在大型项目中使用MRTK

    Show / Hide Table of Contents
    • MRTK入门
      • 发布说明
      • MRTK包内容
      • 从早期版本更新
      • 从HTK更新
      • 生成和部署MRTK
      • NuGet包
      • MRTK配置对话框
      • 开始使用 MRTK和XR SDK
      • 性能
      • 全息图稳定
      • 在大型项目中使用MRTK
    • 架构
      • 概述
      • 框架和运行时
      • 输入系统
        • 术语
        • 核心系统
        • Controllers, pointers, and focus
      • 系统,扩展服务和 data providers
    • 功能概述
      • 边界系统 Boundary System
        • 边界系统概述
        • 配置边界可视化
      • 相机系统 Camera System
        • 相机系统概述
        • Camera Settings Providers
          • Windows 混合现实相机设置
          • Unity AR相机设置[实验性]
          • 创建camera settings provider
      • 跨平台支持
        • 为iOS和Android配置MRTK
      • 检测平台能力
      • 诊断系统 Diagnostics System
        • 诊断系统概述
        • 配置诊断系统
        • 使用可视化分析器
      • 扩展服务 Extension Services
        • 扩展服务创建向导
        • 场景过渡服务概述
      • 输入系统 Input System
        • 输入概览
        • 输入动作 Input Actions
        • 输入事件 Input Events
        • Input Providers
          • Input Providers 概述
          • 创建一个 input data provider
        • 控制器 Controllers
        • 眼动跟踪 Eyes
          • 概述
          • 入门
          • 通过代码访问数据
          • 验证跟踪校准 Validate Tracking Calibration
        • 凝视 Gaze
        • 手势 Gestures
        • 手部 Hands
        • 如何添加近距离交互 Near Interaction
        • 编辑器内输入模拟 In-Editor Input Simulation
        • 指针 Pointers
        • 语音输入 Voice Input
          • 语音转录 Dictation
          • 语音(命令和控制) Speech
      • 多场景系统 Multi Scene System
        • 多场景系统概述
        • 场景类型 Scene Types
        • 内容场景加载 Content Scene Loading
        • 监测内容加载 Monitoring Content Loading
        • 光照场景操作 Lighting Scene Operations
      • 打包 Packaging
        • MRTK包 MRTK Packages
        • MRTK模块化 MRTK Modularization
      • 配置文件 Profiles
        • 配置文件概述
        • 配置指南 Configuration Guide
      • 渲染 Rendering
        • 材质实例概述 Material Instance Overview
        • Shaders
          • MRTK标准着色器 MRTK Standard Shader
      • 服务 Services
        • 什么是混合现实特性
        • 什么是 MixedRealityServiceRegistry 和IMixedRealityServiceRegistrar
        • 扩展服务 Extension services
      • 空间感知系统 Spatial Awareness System
        • 空间感知概述
        • Spatial Observers
          • 为设备配置 Observers
          • 为Editor配置 Observers
          • 通过代码控制 Observers
          • 创建自定义 Observer
      • 传送系统概述 Teleport System Overview
      • 工具
        • Dependency Window
        • Extension Service Creation Wizard
        • Holographic Remoting
        • Input Animation Recording
          • Input Animation File Format Specification
        • Optimize Window
        • Runtime tools
          • Controller Mapping tool
      • UX 构建模块
        • 工具箱窗口 Toolbox Window
        • 按钮 Button
        • 边界框 Bounding Box
        • 对象操纵器 Object Manipulator
        • Manipulation Handler [废弃]
        • Slate
        • 系统键盘 System Keyboard
        • 可交互的 Interactable
        • Solvers
          • 点击放置 Tap to Place
        • 对象集合 Object Collection
        • 提示工具条 Tooltips
        • 滑动条 Slider
        • 手部菜单 Hand Menu
        • 近处菜单 Near Menu
        • 应用程序栏 App Bar
        • 指尖可视化 Fingertip Visualization
        • 进度指示器 Progress Indicator
        • 对话框 Dialog [实验性]
        • 手势教学 Hand Coach [实验性]
        • 可滚动对象集合 Scrolling Object Collection [实验性]
        • 脉冲着色器 Pulse Shader [实验性]
        • 停靠控件 Dock Control [实验性]
        • HoloLens键盘助手 [实验性]
      • 示例场景
        • 示例中心
        • 手势交互示例场景
        • 眼动跟踪示例场景
    • Contributing
      • Contributing Overview
      • Coding Guidelines
      • Writing and Running Tests
      • Writing Documentation
      • Pull Requests
      • Experimental Features
      • Breaking Changes
      • How to use DocFX
    • Planning
      • Roadmap
    • Notice
    • Authors

    在大型项目中使用MRTK

    这个页面包含了一些有用的提示,可以帮助MRTK的使用者将其拉入现有的大型项目,或者建立一些新的东西,这些东西将是源码控制的,并且有多个 开发人员。

    我们建议阅读下面的所有指南,遵循它们将有助于避免在处理较大的代码库时遇到的一些棘手问题

    gitignore

    以下.gitignore文件是在使用MRTK时推荐使用的基础文件 MRTK中创建本地状态的部分可以被源代码控制安全地忽略 否则会破坏本地git状态。

    注意,这部分的开始部分是从默认的github Unity .gitignore具有后添加的MRTK-specific所提取的。还要注意,其中一些规则假定了某些路径 可以根据MRTK在项目中的位置进行修改。

    # This .gitignore file should be placed at the root of your Unity project directory
    #
    # Get latest from https://github.com/github/gitignore/blob/master/Unity.gitignore
    #
    /[Ll]ibrary/
    /[Tt]emp/
    /[Oo]bj/
    /[Bb]uild/
    /[Bb]uilds/
    /[Ll]ogs/
    
    # MemoryCaptures can get excessive in size.
    # They also could contain extremely sensitive data
    /[Mm]emoryCaptures/
    
    # Asset meta data should only be ignored when the corresponding asset is also ignored
    !/[Aa]ssets/**/*.meta
    
    # Uncomment this line if you wish to ignore the asset store tools plugin
    # /[Aa]ssets/AssetStoreTools*
    
    # Autogenerated Jetbrains Rider plugin
    /[Aa]ssets/Plugins/Editor/JetBrains*
    
    # Visual Studio cache directory
    .vs/
    
    # Gradle cache directory
    .gradle/
    
    # Autogenerated VS/MD/Consulo solution and project files
    ExportedObj/
    .consulo/
    *.csproj
    *.unityproj
    *.sln
    *.suo
    *.tmp
    *.user
    *.userprefs
    *.pidb
    *.booproj
    *.svd
    *.pdb
    *.mdb
    *.opendb
    *.VC.db
    
    # Unity3D generated meta files
    *.pidb.meta
    *.pdb.meta
    *.mdb.meta
    
    # Unity3D generated file on crash reports
    sysinfo.txt
    
    # Builds
    *.apk
    *.unitypackage
    
    # Crashlytics generated file
    crashlytics-build.properties
    
    # NuGet Build Process Generated
    # This section covers files that are generated when consuming/using MRTK from NuGet
    # May not be relevant if consuming via .unitypackages
    /NuGet/*
    !/NuGet/BuildSource.proj
    /MRTKBuild/
    /MSBuild/
    /PackagesCopy/
    !/scripts/Packaging/NuGetRestoreProject.csproj
    
    # MSBuildForUnity generated
    # This section covers files that are generated by the MSBuildForUnity system
    # which MRTK uses to consume certain NuGet packages. Useful for when MSBuildForUnity
    # is enabled on the project (in the MRTK configurator)
    MSBuildForUnity.Common.props
    /*.msb4u.csproj.meta
    *.msb4u.csproj.meta
    /*.msb4u.sln.meta
    *.msb4u.sln.meta
    Dependencies*
    Nuget.config*
    
    # DotNetAdapter specific
    # This section covers files that are deployed by the imported DotNetWinRT NuGet package
    # This is primarily used for Unity Editor to HoloLens 2 in-editor remoting
    !/Assets/MRTK/Providers/WindowsMixedReality/Shared/DotNetAdapter/DotNetAdapter.csproj*
    Assets/MRTK/Providers/WindowsMixedReality/Shared/DotNetAdapter/.bin/
    Assets/MRTK/Providers/WindowsMixedReality/Shared/DotNetAdapter/.obj/
    

    ProjectPreferences.asset 文件

    项目范围的MRTK设置可以在 Edit -> Project Settings -> Mixed Reality Toolkit 下找到 。这些设置将保存到一个文件中, 在资源文件夹的这个位置:

    Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset
    

    如果您的项目将有多个合作者,建议在完成MRTK设置的初始设置之后检查该asset文件。特别是,检查以下设置:

    Lock SDK Profiles - 如果这被禁用,默认的MRTK配置文件将是全局可编辑的,这将使MRTK升级具有挑战性(它可能导致框架本身的合并冲突)

    Ignore MRTK project configurator - 如果禁用此功能,项目配置器将显示当前MRTK设置是否与MRTK推荐的默认设置不匹配。由于您的项目可能已明确选择不启用某些设置,因此选中此设置将防止其他合作者无意中看到此对话框更改了设置。这些设置应该由项目设置人员配置,然后由其他合作者忽略。

    Auto-enable UWP capabilities - 如果禁用了这个功能,某些功能(例如,眼动跟踪)在部署到设备时可能会悄无声地失败,因为Unity不会自动将所需的运行时功能添加到应用程序清单中。检查此设置将确保您的应用程序部署体验不会出现此类问题。

    • Improve this Doc
    In This Article
    • gitignore
    • ProjectPreferences.asset 文件
    Back to top Generated by DocFX