mrtk_developmentreleases/2.0.0releases/2.1.0releases/2.2.0
  • 指南
  • API 文档
  • 指南
  • 功能概述
  • 输入系统 Input System
  • 输入动作 Input Actions

    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

    Input Actions (输入动作)

    输入动作 是对原始输入的抽象,旨在帮助将应用程序逻辑与产生输入的特定输入源隔离开。例如,定义一个Select动作并将其映射到鼠标左键,游戏手柄中的一个按钮和一个6自由度控制器中的一个触发器,可能会很有用。然后,您可以让您的应用程序逻辑侦听Select输入动作事件,而不必知道可能产生此事件的所有不同输入。

    创建输入动作

    在MRTK组件的Input System Profile内的Input Actions Profile中配置输入动作,指定动作名称和可以映射到的输入类型 (轴约束(Axis Constraint)))

    这些是轴约束 最常用的值:

    轴约束 描述
    Digital 开/关输入,例如游戏手柄或鼠标中的二进制按钮。.
    Single Axis 单轴模拟输入,如游戏手柄中的模拟触发器。
    Dual Axis 双轴模拟输入,如摇杆。
    Six Dof 具有6个自由度控制器产生的平移和旋转的3D姿势。

    您可以在轴类型中找到完整列表.

    Mapping Inputs To Actions (将输入映射到动作)

    将输入映射到动作的方式取决于输入源的类型:

    Controller Inputs (控制器输入)

    转到 Input System Profile下的Controller Input Mapping Profile。在这里,您会找到所有支持的控制器的列表:

    选择要你想配置的一个,随即出现一个对话框窗口,其中包含所有控制器输入,可让您为每个输入设置一个动作:

    Speech Inputs (语音输入)

    在Input System Profile下的Speech Command Profile中,您将找到当前定义的语音命令列表。要将其中之一映射到某个动作,只需在Action下拉列表中选择它即可。

    Gesture Inputs (手势输入)

    Input System Profile下的Gestures Profile包含所有已定义的手势。您可以在Action下拉列表中选择手势并且将它们映射到一个动作。

    Handling Input Actions (处理输入动作)

    [!警告] 当前,只能使用本节中描述的方法来处理*数字(Digital)*类型的输入动作。对于其他动作类型,您必须直接处理相应输入的事件。例如,要处理映射到控制器输入的6自由度动作,您必须使用IMixedRealityGestureHandler<T> with T = MixedRealityPose.

    处理输入动作的最简单方法是利用 InputActionHandler 脚本。这使您可以使用Unity Events定义要监听的动作并对动作的开始和结束事件做出反应。

    如果您想要更多控制权,可以直接在您的脚本中实现IMixedRealityInputActionHandler 接口。查看 输入事件 部分,以了解有关通过handler接口进行事件处理的更多详细信息。

    例子

    有关示例场景,请参见MixedRealityToolkit.Examples\Demos\Input\Scenes\InputActions 其中显示了如何创建动作,如何将其映射到控制器,语音和手势输入以及如何根据命令旋转对象。

    • Improve this Doc
    In This Article
    • 创建输入动作
    • Mapping Inputs To Actions (将输入映射到动作)
      • Controller Inputs (控制器输入)
      • Speech Inputs (语音输入)
      • Gesture Inputs (手势输入)
    • Handling Input Actions (处理输入动作)
    • 例子
    Back to top Generated by DocFX