Troubleshooting

This section discusses common problems encountered when using the Unity Plugin. If the Unity Plugin does not work properly, refer to the following information to troubleshoot.

Common problems

1. Avatar does not move (motion data cannot be received)
2. Data cannot be received using UDP
3. Update of the Unity Plugin (overwrite import) failed

Avatar does not move (motion data cannot be received)

1. Check that the development environment meets the requirements.
2. Check that the IP address of the mocopi app connection destination is the IP address of the platform on which the sample app was built.
3. Check that the port number for sending and receiving UDP matches.
4. Check that the mocopi app transmission format is set to "mocopi (UDP)."
5. If there are no problems with the settings above, refer to Data cannot be received using UDP.

Data cannot be received using UDP

UDP transmissions may be blocked at the firewall.

Check the firewall settings of the development environment OS and make sure that communication is permitted at the port number that receives UDP transmission from the mocopi app. If the communication is blocked, set it to be permitted.

The following is a Windows configuration example. The settings differ between the Unity Editor and the application being built.

Receiving the data via UDP with the Unity Editor

1. Open the "Windows Firewall with Advanced Security" in Windows.
2. Click [Inbound Rules] to display the list.
3. Right-click "Unity {version} Editor" and open the Properties.
4. Add a check mark to the network which corresponds to the development environment under "Profiles" in the [Advanced] tab.
5. Check that the "Protocol type" field in the "Protocols and Ports" tab is set to "Any" or "UDP."
   If it is not set to "Any" or "UDP," change the setting.

Receiving the data via UDP with the application being built

1. Open the "Windows Firewall with Advanced Security" in Windows.
2. Click [Inbound Rules] to display the list.
3. Click [New Rule...].
   The "New Inbound Rule Wizard" window appears.
4. Select [Port] and click the [Next] button.
5. Select [UDP] and "All local ports" and click the [Next] button.
6. Select [Allow the connection] and click the [Next] button.
7. Add a check mark to the network that corresponds to the development environment and click the [Next] button.
8. Enter any name in the "Name" field and click the [Next] button.

Update of the Unity Plugin (overwrite import) failed

Before starting the Unity project, delete the Unity Plugin and import it again using the following procedure.

1. Start the Unity Hub.
2. Click [...] for the target project and then click [Show in Explorer].
3. Delete the "MocopiReceiver" folder in "Project name\Assets."