一台电脑管理整个 HoloLens 教室:MixedRealityCompanionKit Commander 多设备管理实战教程
【免费下载链接】MixedRealityCompanionKitThis is a MixedRealityToolkit style repository for code bits and components that may not run directly on Microsoft HoloLens or immersive headsets but instead pair with them to build experiences.项目地址: https://gitcode.com/gh_mirrors/mi/MixedRealityCompanionKit
MixedRealityCompanionKit 是微软开源的 HoloLens 伴侣工具集,其中的 Windows Mixed Reality Commander(原 HoloLens Commander)是一款免费的 HoloLens 多设备管理应用:只需一台 Windows 10 电脑,就能注册、监控并批量控制整间教室的 HoloLens 或 Windows PC 设备,统一安装、运行和卸载混合现实应用。无论你是 XR 课堂教师、实训讲师还是演示工程师,这篇实战教程都能带你从零搭建到日常批量化管理。
先认识一下:Commander 能帮你做什么
MixedRealityCompanionKit 与微软 MixedRealityToolkit(MRTK)同源,专门收录那些"不戴在头上、而在配套电脑上运行"的工具,共 6 大功能区块:
| 组件 | 用途 |
|---|---|
| Windows Mixed Reality Commander | 教室 / 演示场景的多设备管理 |
| Holographic Remoting Host | 全息远程渲染主机示例 |
| KinectIPD | 用 Kinect 测量用户的 IPD(瞳距) |
| MixedRemoteViewCompositor | 远程混合现实视频合成 |
| SpectatorView | 让旁观者实时看到佩戴者第一视角 |
| Asset Bundler | 打包 Unity 资产并投递到设备 |
Commander 是其中最"救火"的一个:它基于 Windows Device Portal 机制构建,正是微软 HoloLens 团队在 Holographic Academy 培训营中使用的同款管理工具。
开始前的准备工作:必备 3 件套 📋
| 准备项 | 说明 |
|---|---|
| Windows 10 主机电脑 | x86 / x64 均可,运行管理端应用 |
| 目标设备(HoloLens 或 Windows PC) | 必须开启开发者模式并启用Windows Device Portal;Windows PC 启用后需重启 |
| Visual Studio 2017 Community + Windows 10 SDK | 用于编译部署,专业版 / 企业版同样支持 |
⚠️ 注意:连接前请先确认目标设备的 Device Portal 已与你打算使用的管理账号配对,否则注册会失败。
快速上手:三步部署多设备管理工具
第 1 步,克隆伴侣工具集项目:
git clone https://gitcode.com/gh_mirrors/mi/MixedRealityCompanionKit第 2 步,用 Visual Studio 打开解决方案文件HoloLensCommander/HoloLensCommander.sln。
第 3 步,构建并部署(Build and deploy)即可。
💡 小技巧:直接在 VS 中部署到即将运行的电脑上,会自动放行 UWP 网络隔离的循环回环(loopback)限制,因此你可以通过 USB 直连 HoloLens 时使用回环地址http://127.0.0.1:10080快速接入。想深入阅读源码的话,设备监控核心在HoloLensCommander/HoloLensCommander/Device/DeviceMonitor.cs,注册设备对话框在HoloLensCommander/HoloLensCommander/Dialogs/ConnectToDeviceDialog.xaml。
把 HoloLens 接入教室:注册设备操作详解
打开 Commander,点击左上角的Register按钮,弹出针对单台设备的连接对话框。
1️⃣ 先设置一次管理凭据
点击连接控制区中钥匙形状按钮(Set Credentials),填写 Device Portal 的默认用户名和密码。设置一次后,之后注册新设备都不再需要重复输入。
2️⃣ 填写设备地址
- HoloLens:打开 设置 > 网络和 Internet > WLAN 查看 IP
- Windows PC:打开 设置 > 更新和安全 > 开发人员 查看 IP;端口通常为
50443,勾选 "Desktop PC" 会自动补上默认端口 - 留空地址:默认使用回环地址,适合 USB 直连的开发机
3️⃣ 其他常用选项
- Name:给设备起本地别名;勾选Update Device还会直接重命名设备并重启
- SSID + Key:把设备切到你指定的 Wi-Fi 网络(若已设默认值会自动填充)
- Use Installed Device Certificate:已安装过该设备根证书时可勾选,省去自动下载
连接成功后,设备会出现在主窗口中央的设备列表中,并按设备名称与地址自动排序:
日常教室管理:三大工具区速查 🎛️
主窗口左侧的工具区覆盖了日常教学 90% 的场景,所有操作都作用于当前勾选的设备(单选或批量)。
Common Applications(应用管理)
- Run / Close All:在选中设备上启动指定应用,或一键关闭所有应用
- Install / Uninstall:批量安装 / 卸载
.appx、.appbundle等安装包,可预先记住默认安装文件夹 - Remove Sideloaded Apps:移除设备上的全部侧载应用,还原本机干净状态
Mixed Reality Capture(第一视角录制)
- Start / Stop / Save:远程开启或结束 HoloLens 第一视角录制,保存后批量下载到电脑相机卷;Clear Camera Roll可清空设备上的全部拍摄内容
Device Control(设备控制)
- 重启、关机、忘记设备(从列表移除)
- ✏️Tag 设备:为设备设置一个自定义的本地标签,比如"学员-05 号",再也不用对着 IP 猜是哪位学生的机器
批量操作时,配合顶部的Select All / Select None与All / HoloLens / Windows PC过滤器,可以快速圈定操作范围。
大班型教室的杀手锏:会话恢复与批量配置
一间教室动辄几十台设备,每节课都手动注册一遍是不现实的。Commander 用"会话(Session)"机制解决这个问题:
- 自动保存:设备每次注册 / 注销时,当前会话自动存档
- Restore Previous Session:下次启动一键恢复上次的全部设备;在 设置对话框 中还能开启Auto-Reconnect,启动即自动重连
- Save / Load Session:把当前设备集合手动存成文件,换教室、换电脑时一键还原整个班
- Heartbeat Interval:可配置心跳检测间隔,决定多久检查一次设备是否在线
此外,Settings 对话框允许设置默认凭据和默认 SSID / 网络密钥——新设备注册对话框会自动填好,大班型开课前的批量纳管效率会提升一大截。
顺手认识其他伴侣组件 🚀
除 Commander 外,工具集里还有几个在教室 / 演示场景很实用的成员:
KinectIPD —— 用 Kinect 精确测量瞳距(IPD)很多用户佩戴 HoloLens 时出现"重影",其实是 IPD 没调好。KinectIPD 桌面应用用 Kinect 捕捉用户眼部位置,自动算出瞳距并推送到 HoloLens,一步校正:
Asset Bundler —— 把 Unity 资产打包投送到设备把 Unity Asset Bundle 压缩打包后,直接通过 Device Portal 上传到 HoloLens,免去手动拷贝:
SpectatorView / RemotingHostSample / MixedRemoteViewCompositor—— 让台下观众实时看到佩戴者的第一视角,或把全息渲染放到高性能 PC 上远程完成,详见各子目录下的 README 文档。
常见问题解答(FAQ)❓
Q:设备列表显示 "Lost Connection to Device" 怎么办?A:说明心跳检测失败。确认设备已开机、与主机在同一网络、Device Portal 仍处于启用状态;Windows PC 还需检查防火墙是否放行了 50443 端口。
Q:设备换了 Wi-Fi 后失联了?A:如果设备被切到了主机无法访问的网络,连接就会断开。让 PC 与 HoloLens 回到同一网络后,重新注册或恢复会话即可。
Q:能预注册一台暂时不在线的设备吗?A:可以。2.1706 版本起支持预注册当前不在网络上的设备,设备上线后即可使用。
Q:误点了"忘记设备"怎么办?A:重新输入 IP 地址和凭据注册一次即可;被忘记的设备会移出列表,其应用状态也会重置。
一台电脑 + Commander,就能把杂乱无章的 HoloLens 教室变成"一键纳管、一键开课"的高效课堂。建议先用 3~5 台设备跑通注册、批量安装、第一视角录制的完整流程,再借助会话文件与默认配置扩展到全班规模。
【免费下载链接】MixedRealityCompanionKitThis is a MixedRealityToolkit style repository for code bits and components that may not run directly on Microsoft HoloLens or immersive headsets but instead pair with them to build experiences.项目地址: https://gitcode.com/gh_mirrors/mi/MixedRealityCompanionKit
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考