Skip to content

Unity Engine Integration

Note: Unity is a cross-platform game development engine supporting iOS, Android, Windows, and more. If you are developing an iOS app with Unity, you need to use the Unity bridge files provided by the iOS SDK.

Integration Steps

  1. Download the iOS SDK XCFramework
  1. Download the Unity bridge files
  1. Add to your Unity project

    • Drag the Framework and bridge files into your Unity project's iOS plugin directory (Assets/Plugins/iOS/)
  2. Use in Unity C# code

csharp
// Initialize SDK
[DllImport("__Internal")]
private static extern void unity_iLocalizeInitBuild(string appKey, string language, bool isInternationalizing, bool isBuildDebug);

// Get translation string
[DllImport("__Internal")]
private static extern string unity_iLocalizeGetStringDefault(string code, string defaultStr);

// Switch language
[DllImport("__Internal")]
private static extern void unity_iLocalizeUpdateLanguage(string language);

// Usage example
unity_iLocalizeInitBuild("YOUR_APP_KEY", "zh-cn", true, false);
string text = unity_iLocalizeGetStringDefault("110100", "Default text");

Available Functions

All Unity bridge functions are prefixed with unity_:

  • unity_iLocalizeInit - Initialize (simplified)
  • unity_iLocalizeInitBuild - Initialize (full version, supports debug mode)
  • unity_setOnILocalizeInitializedCallback - Set initialization callback
  • unity_iLocalizeGetStringDefault - Get translation string (with default value)
  • unity_iLocalizeUpdateLanguage - Switch language
  • unity_iLocalizeSetLogEnable - Toggle logging
  • unity_iLocalizeEvaluateString - Evaluate string
  • unity_iLocalizeUpdateUserInfo - Update user info
  • unity_iLocalizeCheckStringOverflow - Check string overflow

Note: Unity bridge files are part of the iOS SDK and provide a C-language interface, allowing Unity's C# code to call iOS SDK functions.