一、场地

Q：我该如何布置摆放摄像头

A1：两个摄像头之间的水平距离为2米（最大2.5米），垂直距离为1米。主摄像机高度为1米（动捕演员正对的摄像机为主摄像机），副摄像机高度为0.9米，摄像头水平放置，不能仰视或者俯视。如果不按照该要求进行场地布置，会导致动捕精度丢失。

A2：保持摄像头与地面水平，避免仰视或者俯视，因为这样会拍摄不到腿部，导致腿部质量下降，抖动。

Q：摄像头的型号选择

A1：支持1080p 30帧 广角Fov在90°-120°之间的网络摄像头，需要型号相同的两台摄像机。

A2：默认提供90度广角的摄像头，如果您的场地比较小，可以考虑更大广角的摄像头，例如110度，120度，能在更近的位置拍摄动捕演员全身。

A3：推荐emeetC960.

Q：动捕演员该如何站位

A：动捕演员需要站在能被两个摄像机拍摄全身的位置，并且确保动捕期间也要能被拍到，否则会存在精度丢失的问题。

Q：光线、灯光等有什么要求

A：确保摄像头画面清晰可见，能清晰拍摄动捕演员全身，您可以打开系统自带的camera软件，观看摄像头拍摄的画面是否清晰。

A：摄像头不可以被人造光源或者太阳光直射，否则会逆光拍摄模糊。

Q：对服装有什么要求

A1：尽量避免宽松飘逸的服装（裙子、宽松的半截裤）

A2：不要遮挡手腕，需要挽起手袖。

A3：佩戴口罩会丢失面捕、佩戴眼镜有几率影响眼睛捕捉

A4：尽量避免服装与背景色完全一致

Q：对场地有什么要求

A1：尽量保持场地内空旷、避免太多杂物遮挡

A2：保持一定明亮度、太暗会丢失捕捉精度

二、常见捕捉精度丢失问题

Q：手指抖动扭曲问题

A1：手腕被遮挡导致手指异常，需要挽起手袖，

A2：采集端程序在点击启动后，初始化过程中动捕演员握拳导致，需要张开手掌初始化

A3：摄像头画面模糊，被强光照射导致手指无法捕捉

Q：腿部异常扭曲、抖动

A1：动捕演员超出两个摄像头拍摄范围、距离摄像头太近

A2：摄像头拍不到腿部导致抖动（摄像头摆放高度太高、仰视放置摄像头）

A3：副摄像头连接不稳定、掉帧或延迟高

三、采集端程序常见问题

Q：打开后采集捕捉程序白屏

A1：按一下F5刷新程序

A2：检查软件安装路径是否有中文字符，需要全英文路径。

A3：检查电脑用户名是否为中文用户名，需要英文用户名。

A4：检查电脑是否为AMD显卡，需要使用nVidia显卡

Q：软件启动失败、启动按钮无法点击

A1：检查软件是否被windows安全中心或杀毒软件拦截，打开windows Security（安全中心）-Virus&threat protection(病毒和威胁 )-Protection history（保护历史）-找到被拦截的程序，点击还原操作。

A2：检查电脑是否为AMD显卡，需要使用nVidia显卡

A3：重新解压软件

Q：采集端左下角人形状态栏的头部为白色

A1：更新显卡驱动后，重新启动采集端

A2：检查cyanmain.exe程序是否被杀毒软件查杀，将软件添加到信任区

A3：检查电脑是否为AMD显卡，需要使用nVidia显卡

Q：点击启动按钮后，初始化无法完成，状态栏无法全部变绿

A1：确保动捕演员在初始化期间能被摄像头拍到全身，确保初始化过程中两个摄像头视野内没有其他人

A2：摄像头未按教程要求放置

Q：打开采集端程序 ，未检测到足够摄像头

A1：确保两个摄像头已插入电脑，并在相机camera程序中检测到

A2：确保两个摄像头型号、名称相同

Q：点击启动以后，摄像头预览画面冻结

A：单击运行后，摄像头预览窗口会冻结。这是正常的，因为Windows不允许两个程序同时调用摄像头。不影响软件使用。

Q：采集端初始化完成后，状态栏变红，显示离开了

A1：动捕演员完全或部位离开两个摄像机视野范围内，请确保两个摄像头能拍到动捕演员全身

A2：离摄像头太近，尝试远离摄像头

A3：检查摄像头摆放位置是否与教程一致、可能正副摄像头识别错误，需要点击切换摄像头

A4：背景墙上有明显人影投影，或场地中存在第二个人、类似人体形状的物体/海报。

Q：序列号提示绑定主机超过上限

A：1.4.0以上版本的采集端程序进行解绑操作后，即可绑定到新的主机

A：1个序列号只能同时绑定4台机器

Q：提示软件文件丢失、缺失

A：点击采集端程序安装目录中的 文件恢复.exe

Q：采集端程序点击启动，提示服务器异常，令牌错误

A1：检查电脑网络连接是否正常

Q：采集端的离地参数滑动条无法拖动

A：避免放大采集端网页，如果采集端网页比例被放大会导致按钮被遮挡无法点击

四、UE端常见问题

Q：如何控制示例工程中的镜头和导出数据

A1：点击上方编辑器的三角形按钮或按F8切换为手柄控制模式、长按鼠标右键，点击QWEASD控制镜头。

点击左侧菜单栏录制按钮开始录制，再次点击录制按钮停止录制，点击导出按钮，生成完成后勾选全部选项，保存到本地文件夹。

A2：插件版请使用UE自带导出功能，详情见教程文档（UE自带导出FBX功能教程）。

Q：UE端看到的画面帧数低

A1：在window中打开图形设置，将cyan.exe、cyanmain.exe已经Unreal Editor添加为高性能模式

A2：如果使用笔记本请确保连接上电源并且开启高性能模式，以及使用独立显卡运行程序

A3：调整工程版system文件或者插件版的CyanAnimApply，找到LoopCount，把参数调小。

Q：打开UE示例工程显示IOCP Connect failed、默认在播放动画不开始捕捉

A1：示例工程版本：需要修改system文件内的IP地址与采集端一致，打开渲染端示例工程的文件夹路径CyanAnimation5_0\CyanAnimation5_0\Content\User\system  把采集端界面显示的IP地址填入"IPaddress": "192.168.xx.xx"

A2：插件版本：在项目设置中找到CyanAnimApply、更改IP地址为采集端所显示的IP

Q：启动UE示例工程提示

①The following modules are Missing or built with different engine version

②CyanAnimApply  is could not be compiled.Try rebuilding from source manually

③The 'CyanAnimApply' plugin was designed for build 5, 1.0. Atempt to load it anyway?

A1：选择No，因为使用了错误的版本打开UE示例工程，需要下载对应的UE版本，右键CyanAnimation5_0，选择“切换UE版本”（switch Unreal Engine version）、选择对应的UE版本打开

A2：UE版本不完整，打开虚幻引擎程序，右键对应的UE版本，选择检验UE完整性（Verify）

Q：模型的脚陷入场景中、模型悬空

A1：拖动采集端程序左侧的离地参数滑动条

A2：调整工程版system文件或者插件版的CyanAnimApply，找到floor参数，调整离地参数

A3：拖动场景配合人物模型

Q：如何示例工程为自己的模型

A：导入模型文件到UE中、修改骨骼绑定，创建动画蓝图连接节点，修改人物引用等，具体参考我们的切换人物以及骨骼绑定教程

Q：导出的fbx文件中丢失面部数据

A：确保表情使用arkit标准命名格式、FBX导出设置中需要勾选全部选项。

Q：点击导出按钮后长时间没反应、无法正常导出FBX文件

A1：检查模型是否缺少根节点，会导致模型无法正常导出

A2：检查模型配置文件骨骼绑定是否正确填写，骨骼绑定有误导致无法正常导出

Q：点击运行后、UE闪退报错

A1：检查是否模型引用填错，诸如引用内多了空格，双引号缺失等情况。

A2：Ue5.3/5.2插件版因为lod问题会导致运行途中报错闪退，需要在模型处将Number of LODs的值改为1

Q：动捕演员跳跃时，模型无法跳跃

A1：调整工程版system文件或者插件版的CyanAnimApply，找到floor参数，调整离地参数。修改后重启UE生效。

A2：调整采集端的离地滑动条

Q：插件版中模型无法正常驱动

A1：确保项目设置中CyanAnimApply的IP地址已修改

A2：确保模型在场景中的位置为（0，0，0）点

A3：确保模型正面是Y轴朝前

A4：检查人物蓝图节点是否正确连接

A5：确保mocp character组件正确添加

A6：确保BodyName和FaceName的值填写正确

A7：确保拖入场景的是人物蓝图

A8：检查datatable内骨骼绑定命名填写正确

A9：确保采集端显示动捕中

A10：确保插件版本安装正确

A11：确保人物蓝图（character blueprint）选择了正确的动画类（anim class）

A12：确保插件文件放置正确、不可多放一层文件夹