在Vtube Studio中使用mocopi

您可以使用索尼 mocopi 追踪器在 VTube Studio 中进行身体动作捕捉。

VTube Studio 支持将您的 3D 身体动作转换为可应用于 2D 模型的追踪参数，包括身体动作、头部动作、腿部动作以及手臂/手部动作。

VTube Studio 支持在 Windows 和 macOS 系统上接收并使用 mocopi 数据。

示例模型(Example Model)

索尼mocopi团队提供了一个已为VTube Studio设置并支持所有mocopi参数的示例Live2D模型。如果您想尝试mocopi功能或参考示例模型来制作自己的模型，可以在此免费下载RAYNOS-chan-avatar_for_VTubeStudio_v1.0.0.zip：

Download RAYNOS-chan-avatar_for_VTubeStudio

*注意：该模型可在直播中使用，但可能存在某些限制。请在下载模型前阅读提供的角色许可协议。

设置(Setup)

第一步是设置您的 mocopi 设备以将数据发送至 VTube Studio。mocopi 设备无法直接连接至 VTube Studio。您需要使用 mocopi iOS/Android 应用或 Windows 电脑应用。

1. mocopi iOS/Android 手机应用程序（免费）：在您的智能手机上运行，接收 mocopi 追踪器的数据，然后通过本地网络/Wi-Fi 将数据发送至 VTube Studio。
   1. 更多信息：从mocopi应用程序发送数据
2. mocopi桌面PC应用程序（订阅制）：直接在您的PC上运行，并从mocopi追踪器接收数据。此功能需要使用索尼mocopi传感器数据接收器，并通过USB连接至您的PC。同时通过本地网络将数据发送至VTube Studio（运行于同一台PC）。
   1. 更多信息：mocopi电脑版的使用方法

通常，使用这些应用程序的方式相同：

1. 连接您的mocopi设备。
2. 在VTube Studio中设置与VTube Studio的连接。
3. 在VTube Studio的mocopi配置页面中检查您的IP地址和已选端口。将该IP地址和端口输入到mocopi应用程序中的第三方连接配置中。
4. 在mocopi应用程序中点击【开始传送数据】，并确认Vtube Studio中的mocopi接收器已开启

此时您应该能够在Vtube Studio中看到连接已建立，且mocopi的追踪数据应已处于可用状态。

支持的参数(Supported Parameters)

默认情况下，VTube Studio在设置模型时会隐藏mocopi跟踪参数列表中的跟踪参数。如果您想使用mocopi，请确保在VTube Studio的mocopi配置中启用“显示跟踪参数”。

关于mocopi跟踪参数范围的重要说明：下表中列出的参数范围仅为VTube Studio在创建新参数映射时使用的默认最小/最大值。对于某些参数（如 mocopiAngleX），其列表范围为 [-30, 30]，但参数值可远超此范围。对于范围为 [-180, 180] 的参数，其值无法超出该范围：当参数达到范围一端时，将跳转至另一端（360°，以 0 为中心，两侧各 180°）。

有关参数和运动范围的详细工作原理，建议查看索尼提供的 mocopi Live2D 模型（如下述链接）。

Download RAYNOS-chan-avatar_for_VTubeStudio

在 VTube Studio 的 mocopi 设置中启用“显示跟踪参数”后，将可访问以下参数：

1. MocopiConnected
   1. 范围：[0, 1]
   2. 说明：当 VTube Studio 的 mocopi 接收器关闭或当前未接收数据时为 0。当从 mocopi 接收数据时为 1。
2. MocopiHipAngleZ
   1. 范围：[-30, 30]
   2. 说明：髋部摆动角度。负值表示向左，正值表示向右。
3. MocopiAngleX
   1. 范围：[-30, 30]
   2. 说明：头部左右旋转（头部晃动）。
4. MocopiAngleY
   1. 范围：[-30, 30]
   2. 说明：头部上下旋转（点头）。
5. MocopiAngleZ
   1. 范围：[-30, 30]
   2. 说明：头部左右倾斜。
6. MocopiBodyAngleX
   1. 范围：[-10, 10]
   2. 说明：身体左右旋转。
7. MocopiBodyAngleY
   1. 范围：[-10, 10]
   2. 说明：身体前后倾斜旋转。
8. MocopiBodyAngleZ
   1. 范围：[-10, 10]
   2. 说明：身体左右倾斜旋转。
9. MocopiBodyPositionX
   1. 范围：[-1, 1]
   2. 说明：绝对身体位置：X。
10. MocopiBodyPositionY
    1. 范围：[-1, 1]
    2. 说明：绝对身体位置：Y。
11. MocopiBodyPositionZ
    1. 范围：[-1, 1]
    2. 说明：身体绝对位置：Z。
12. MocopiUpperArmLeftAngleY / MocopiUpperArmRightAngleY
    1. 范围：[-90, 90]
    2. 说明：上臂前后旋转。
13. MocopiUpperArmLeftAngleZ / MocopiUpperArmRightAngleZ
    1. 范围：[-180, 180]
    2. 说明：上臂上下旋转（360°旋转）。
14. MocopiLowerArmLeftAngleX / MocopiLowerArmRightAngleX
    1. 范围：[-180, 180]
    2. 说明：手腕旋转（360°旋转）。
15. MocopiLowerArmLeftAngleY / MocopiLowerArmRightAngleX
    1. 范围：[-90, 90]
    2. 说明：下臂前后旋转。
16. MocopiLowerArmLeftAngleZ / MocopiLowerArmRightAngleZ
    1. 范围：[-180, 180]
    2. 说明：下臂弯曲（360°旋转）。当上臂向内指向时，该值可为负数。
17. MocopiUpperLegLeftAngleY / MocopiUpperLegRightAngleY
    1. 范围：[-30, 30]
    2. 说明：大腿前后旋转。
18. MocopiUpperLegLeftAngleZ / MocopiUpperLegRightAngleZ
    1. 范围：[-30, 30]
    2. 说明：上腿左右旋转。
19. MocopiLowerLegLeftAngleY / MocopiLowerLegRightAngleY
    1. 范围：[-30, 30]
    2. 说明：下腿前后旋转。
20. MocopiLowerLegLeftAngleZ / MocopiLowerLegRightAngle
    1. 范围：[-30, 30]
    2. 说明：下腿左右旋转。

与网络摄像头/手机面捕跟踪结合(Combining with Webcam/iOS/Android Tracking)

在使用 mocopi 时，所有常规跟踪参数仍可正常工作。您可以将其与基于网络摄像头或智能手机的面部跟踪结合使用。

如果您想使用 mocopi 进行头部旋转跟踪，可以使用以下参数：mocopiAngleX、mocopiAngleY、mocopiAngleZ

当VTube Studio中的mocopi接收器关闭或未从mocopi追踪器接收数据时，这些参数将自动使用网络摄像头或智能手机追踪器提供的可用头部追踪数据。

当VTube Studio停止从mocopi追踪器接收数据时，所有mocopi追踪参数将自动归零。

故障排除与常见问题(Trouble Shooting)

如果有多个mocopi追踪器同时发送数据怎么办？

VTube Studio 每次仅接收来自一个 mocopi 追踪器的数据。任何额外发送数据的追踪器将被忽略。

当我将 mocopi 智能手机应用置于后台时，它停止发送数据。我该怎么办？

在 Android 系统中，根据设备不同，当应用未处于焦点状态时，系统会阻止其访问蓝牙或本地网络。此举旨在节省电量。这将导致在后台运行的 mocopi 应用与 mocopi 追踪器（蓝牙）或 VTube Studio（Wi-Fi）失去连接。要解决此问题，请确保在 Android 设置中关闭 mocopi 应用的所有省电选项，以允许其在后台无限制使用电池。