Skip to content
LogoLogo

Unity SDK Troubleshooting

Platform and compatibility

Testing in the Unity Editor for Android and iOS

You can test the SDK using the Unity Editor for Android and iOS on both Mac and Windows. However, be aware that:

  • Native Android and iOS WebViews don't run in the editor.
  • The macOS WebView is used for the Mac Unity Editor.
  • The Windows WebView is used for the Windows Unity Editor.

For the most accurate testing, use an actual device or emulator.

IL2CPP support for Windows

The SDK doesn't support IL2CPP on the Windows platform.

"WebView is not supported on this platform" error

This error indicates that the WebView isn't properly set up for your target platform. Ensure that you've correctly installed and configured the WebView plugin for your specific platform. If the issue persists, check the documentation for platform-specific setup instructions.

Installation and setup

"The type or namespace name 'Shared' does not exist" error

This error often occurs when large files like .dll aren't properly downloaded. To resolve this:

  1. Download and install git-lfs from git-lfs.com.
  2. Clone the repository again or pull the latest changes.

If the issue persists, ensure that all project dependencies are correctly installed and that your Unity version is compatible with the SDK.

Authentication and login

WebView vs system browser for authentication

The SDK uses the system browser for authentication due to security considerations. If you have specific requirements for using a WebView, contact support to discuss potential alternatives.

In-app browser on mobile

The in-app browser is used for enhanced security, especially for single sign-on (SSO) purposes:

  • It runs on a separate process from the hosting game, preventing the game from accessing or modifying its content.
  • It's more resistant to malicious code injection.
  • WebViews can be more easily controlled by the hosting game, making them potentially less secure for authentication processes.

iOS "Wants to Use 'openfort.sdk' to Sign in" alert

This alert is system-generated by iOS when using ASWebAuthenticationSession for secure authentication. It can't be removed or modified as it's triggered by the operating system. For more information, see the Apple Developer Documentation.

Functionality

Minting and burning assets

The SDK supports various blockchain operations, including minting and burning assets. For specific implementation details, refer to the documentation on asset management or contact support for guidance.

Common errors

"TimeoutException: Exceed Timeout:00:01
"

This exception occurs when a function call takes longer than the default timeout of one minute to return a response. To resolve this:

  1. Check the bottom of the stack trace or logs to identify the specific function causing the timeout.
  2. Customize the timeout duration using the SetCallTimeout function if needed.
  3. Ensure your network connection is stable and that you're not experiencing unusually high latency.