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

**Repository Path**: foheart_1/FOHEART_X_data_summary

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-06-05
- **Last Updated**: 2023-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

#### 介绍
首先需要下载安装设备客户端软件：  
1. 下载software文件夹下的软件并安装，安装后运行忽略升级提示，不要升级。

#### 设备连接
1. 竖起接收器的天线；  
2. 连接5V2A适配器；  
3. 连接Micro USB数据线，并连接到电脑，尽量直接连接到电脑的USB端口，不要经过USB HUB集线器；  
连接后MotionVenus软件右下角显示1，如下图：
<table>
    <tr>
        <td><img src="https://gitee.com/foheart_1/FOHEART_X_data_summary/raw/master/img/foheartxrouterconnect.png"/></td>
    </tr>
</table>
4. 将传感器从充电底座拔出。长按传感器开关，传感器打开，同时在软件中显示在线；  

#### 设备连接不稳定？
首先要保证传感器与接收器之间数据稳定，也就是左侧设备列表中第一列持续是绿色圆圈图标。  
如果是红色或者是红色与绿色之间反复交替，就是无线数据收到干扰，这样设备是无法使用的。  
1. 断电重启接收器；  
2. 将接收器的usb线直接插到电脑机箱的后部，不要经过usb hub等设备；  
3. 换一根microusb数据线再试一下；  
4. 检查使用环境周围是否有大功率路由器或AP，如果有的话先关闭；  
5. 换个使用环境再试下。  

#### 设备校准
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. 下载unity3d文件夹下工程，并按照教程开发：https://v.youku.com/v_show/id_XNDQxMTQ4NjQyOA==.html?spm=a2hcb.profile.app.5~5!2~5~5!3~5!2~5~5!17~A  
打包Unity工程报错，改正方法：Assest下新建Editor文件夹，把FoheartModelEditor.cs剪切到Editor文件夹。再次执行打包即可。
MotionVenus转发配置：<br>
<table>
    <tr>
        <td><img src="https://gitee.com/foheart_1/FOHEART_X_data_summary/raw/master/img/u3dRules.png"/></td>
    </tr>
</table>

#### UE4/5开发相关
UE4/UE5插件及例程下载：
链接：https://pan.baidu.com/s/1ApISh_M0fTDYbIPlot-Pdg
提取码：ttq0
1. ue5.x_demo.zip 这个是Unreal插件；
3. 3.0 Unreal插件使用.mp4 这个是操作视频；
4. 解压后，按照视频操作驱动人物运动；

如果需要自建模型，请注意：
metahuman必须为t-pose，a-pose或者在ue里调整为t-pose均无效，需要原始模型就是t-pose，详见模型绑定视频：
https://v.youku.com/v_show/id_XNDQxMTkwNzM0MA==.html?spm=a2hcb.profile.app.5~5!2~5~5!3~5!2~5~5!12~A

如果需要绑定自建模型，则需要做骨骼映射：
骨骼映射的步骤（在视频4分20秒）：
https://v.youku.com/v_show/id_XNDQxMTkwNzM0MA==.html?spm=a2hcb.profile.app.5~5!2~5~5!3~5!2~5~5!15~A

MotionVenus转发配置：<br>
![](README_md_files/4dba0980-0f42-11ee-8465-ef186b64e39a.jpeg?v=1&type=image)

#### MotionBuilder开发相关
下载repo中MotionBuilder目录里的相关文件，压缩包内有使用教程。
MotionVenus转发配置：<br>
<table>
    <tr>
        <td><img src="https://gitee.com/foheart_1/FOHEART_X_data_summary/raw/master/img/motionBuilderRules.png"/></td>
    </tr>
</table>

其它相关参考：[Mocappys - Your Guide to Capturing and Editing Motion](https://mocappys.com/)
1.  [How to Characterize your Character in MotionBuilder - Mocappys](https://mocappys.com/how-to-characterize-your-character-in-motionbuilder/)
2.  [How to Characterize A Character In MotionBuilder [VIDEO] - Mocappys](https://mocappys.com/how-to-characterize-a-character-in-motionbuilder-video/)
3.  [How to T-Pose and Characterize your Character Using MotionBuilder Python - Mocappys](https://mocappys.com/how-to-t-pose-and-characterize-your-character-using-motionbuilder-python/)
#### 模型建模参考
可以参考本repo中模型： 模型建模\DefaultActor_Tpose.fbx

#### SDK开发相关
下载repo中SDK目录里的相关文件，压缩包内有使用教程。


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

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

#### FOHEART C1驱动安装
2019 年 6 月 25日后出厂设备不需要做这一步。
FOHEART C1接收器驱动需要手动安装，将接收器连接电脑后，电脑设备管理器中出现：
<table>
    <tr>
        <td><img src="https://gitee.com/foheart_1/FOHEART_X_data_summary/raw/master/img/foheart c1 driver.png"/></td>
    </tr>
</table>
下载repo中的FOHEART C1 driver文件夹中的《FOHEART C1驱动安装.pdf》和《FOHEART Drivers.zip》
按照《FOHEART C1驱动安装.pdf》中的说明进行安装。