# FOHEART MAGIC动作捕捉系统资料汇总

**Repository Path**: foheart_1/FOHEART_MAGIC_data_summary

## Basic Information

- **Project Name**: FOHEART MAGIC动作捕捉系统资料汇总
- **Description**: 适用产品：FOHEART MAGIC全身动作捕捉系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-02-14
- **Last Updated**: 2024-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FOHEART MAGIC动作捕捉系统资料汇总

#### 介绍
首先需要下载安装设备客户端软件：  
1. Windows软件客户端下载：https://gitee.com/foheart_1/motionvenus-for-magic-mocap.git
2. 使用手册在本repo中《FOHEART_MAGIC_data_summary》.pdf  或者查看本repo的Wiki页。
#### 设备连接
！！！关闭电脑端的网络代理软件，否则无法正常收发网络数据  
1. 供电，数据接收器Type-C接口连接接收器（如果路由器或交换机带有PoE功能，接收器不需要单独供电）；  
2. 数据连接，连接网线到路由器或者交换机； 
3. 关闭电脑网络防火墙（域网络、专用网络、公共网络）处于关闭状态。   
<table>
    <tr>
        <td><img src="https://gitee.com/foheart_1/FOHEART_MAGIC_data_summary/raw/master/assets/img/firewallConfig.png"/></td>
    </tr>
</table>
4. 确保接收器与电脑在同一局域网，打开客户端软件，左侧会出现设备图标，右键设备，连接即可；          
<table>
    <tr>
        <td><img src="https://gitee.com/foheart_1/FOHEART_MAGIC_data_summary/raw/master/assets/img/connect.png"/></td>
    </tr>
</table>  
5. 如果电脑有多块网卡，并且设备无法发现，需要点击工具栏“网卡配置”，选择当前与设备连接的网卡。选择后，重启软件。<br>
网卡不要选择无线网卡，WIFI数据连接不够稳定，会影响数据质量。
<table>
    <tr>
        <td><img src="https://gitee.com/foheart_1/FOHEART_MAGIC_data_summary/raw/master/assets/img/netcard.png"/></td>
    </tr>
</table>  

6. 确保显示分辨率为100%。
在桌面右键->显示设置，缩放布局改为100%。
![](README_md_files/3f14dd40-1a4d-11ee-a9f2-fd152a57a56e.jpeg?v=1&type=image) 

8. 长按传感器开关，传感器打开，同时在软件中显示在线；  

#### 设备校准
1. 设备传感器校准与人体校准，repo内的视频：  
《传感器校准\传感器+人体校准指南.mp4》  
在线地址：https://www.bilibili.com/video/BV1ts4y127AV/?spm_id_from=333.999.0.0  
传感器磁场校准，对应视频的0~47秒。  
磁场校准的目的是使传感器适应使用场地的环境，如果更换了使用场地就需要重新做磁场校准。  
注意事项：  
（1）磁场校准不要在电脑前面做，需要站在表演场地中间，将传感器全部开机后，插到充电圆盘上，手持充电圆盘在胸前转动；  
（2）使用场地周围清空 ，不要有强磁例如音响等设备；  
（3）使用时跟电脑等设备保持两米以上；  
（4）校准完成后，软件左侧设备列表如果磁干扰持续变红就需要更换使用场地。  

#### 设备穿戴
按照手册中的2.1节穿戴传感器，按照传感器上的标签，放到对应的部位上；  
注意双脚的传感器导光柱需要朝向人体正前方，其它的传感器穿戴方向无要求；  
穿戴完成后执行人体姿态校准：  
人体姿态校准，对应视频的1分15秒之后；  
人体姿态校准的目的使消除传感器的佩戴误差，如果在使用过程中，因为绑带松动移动了传感器，就需要重新做一遍姿态校准；

注意事项：
穿戴要求，人体站立，双臂放下时：  
（1）头：传感器后脑勺中部，方向无要求；  
（2）后背双肩：坎肩已经固定，穿戴好即可；  
（3）上臂：上臂中间外侧，方向无要求；  
（4）小臂：小臂中间外侧，方向无要求；  
（5）胯部：绑带尽量往下，将传感器放到尾椎骨上，而不是腰上，方向无要求；  
（6）手：环绕外侧，方向无要求；  
（7）大腿：大腿中间外侧，方向无要求；  
（8）小腿：小腿中间外侧，方向无要求；  
（9）脚：脚面中部，不要太靠前，不要放在脚尖；传感器方向是导光柱朝前；  

#### Unity3D开发相关
1. FOHEART MAGIC动捕教程_Unity3D插件使用  
视频教程：https://www.bilibili.com/video/BV1LW4y1z7M8  
工程源码：repo内的压缩包Unity3D Plugin\2.1 PluginDemo_FoheartMocapExample.zip

2. FOHEART MAGIC动作捕捉教程_Unity3D模型绑定
视频教程：https://www.bilibili.com/video/BV1GF411F7fp  
工程源码：repo内的压缩包Unity3D Plugin\2.2 MixamoBinding_FoheartMocapExample.zip

3. FOHEART MAGIC动作捕捉教程_Unity3D绑定一个机器人  
视频教程：https://www.bilibili.com/video/BV1WY4y1n7sh  
工程源码：repo内的压缩包Unity3D Plugin\2.3 BindRobot_FoheartMocapExample.zip
#### MotionBuilder开发相关
下载repo中MotionBuilder目录里的相关文件，压缩包内有使用教程。
#### SDK开发相关
SDK源码地址：https://gitee.com/foheart_1/motionvenussdk-windows-x86-x64

#### 模型建模参考
可以参考本repo中模型： 模型建模\DefaultActor_Tpose.fbx

#### 故障排除
如果设备使用有问题可以参照下面的视频：  
《传感器校准\故障排除指南.mp4》  

#### MotionVenus软件闪退处理方法  
1. 安装电脑显卡驱动，Windows系统给显卡安装的默认驱动可能会导致软件闪退。
2. 检查电脑性能是否满足软件的最低要求。