$ npm install @wowmaking/react-native-unity --save

1. Install package via npm
2. Move your Unity project to unity folder at project root

1. Add following line at your unity/Packages/manifest.json

   {..."com.wowmaking.react-native-unity": "file:../../node_modules/@wowmaking/react-native-unity/unity" }

2. Right-click at you Hierarchy menu, then click Create Empty, rename new game object (example: UICommandsDelegate). IMPORTANT! Remember the name of new game object, that needed to initialize JavaScript lib.
3. Add script RNCommadsDelegate.cs to new game object (step 2) (location: Packages/react-native-unity/Runtime/Scripts)
4. To receive commands from JavaScript, you must create another game object, or use existing. Commands receiver object must implements IRNCommandsReceiver interface

   usingWowmaking.RNU; publicclassNewGameObject : MonoBehaviour, IRNCommandsReceiver{... }

5. Set your object as commands receiver to RNBridge on Awake

   usingWowmaking.RNU; publicclassNewGameObject : MonoBehaviour, IRNCommandsReceiver{privatevoidAwake(){RNBridge.SetCommandsReceiver(this)} }

6. Implement IRNCommandsReceiver interface by adding HandleCommand method

   usingWowmaking.RNU; publicclassNewGameObject : MonoBehaviour, IRNCommandsReceiver{privatevoidAwake(){RNBridge.SetCommandsReceiver(this)} publicvoidHandleCommand(RNCommandcommand){switch (command.name){// command.Resolve(new{}) || command.Reject(new{}) } } }

   IMPORTANT! Call Resolve or Reject method of received RNCommand instance to remove it from JavaScript thread

If you want to test your app at xcode simulator, you need following next steps:

1. Go to Menu -> Edit -> Project setings... -> Player -> iOS -> Other Settings
2. Remove check from Auto Graphics API
3. Add OpenGLES3 to Graphics APIs list by clicking +
4. Find Target SDK setting and select Simulator SDK

You ready to debug your app at simulator!

1. Run pod install
2. Add RNUProxy.xcodeproj to your workspace: Menu -> File -> Add Files to [workspace_name]... -> [project_root]/node_modules/@wowmaking/react-native-unity/ios/RNUProxy/RNUProxy.xcodeproj
3. Build Unity app to [project_root]/unity/builds/ios
4. Add Unity-iPhone.xcodeproj to your workspace: Menu -> File -> Add Files to [workspace_name]... -> [project_root]/unity/builds/ios/Unity-iPhone.xcodeproj
5. Add UnityFramework.framework to Embedded Binaries:
   • select your_app target in workspace
   • in General / Embedded Binaries press +
   • select Unity-iPhone/Products/UnityFramework.framework
   • remove UnityFramework.framework from Linked Frameworks and Libraries ( select it and press - )
   • in Build Phases move Embedded Binaries before Compile Sources ( drag and drop )
6. Add following lines to your project main.m file (located at same folder with AppDelegate)

#import<UIKit/UIKit.h> +++ #import <RNUnity/RNUnity.h> #import"AppDelegate.h"intmain(int argc, char * argv[]){@autoreleasepool{+++ [RNUnity setArgc:argc]; +++ [RNUnity setArgv:argv]; returnUIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]))} }

7. Add following lines to your project AppDelegate.m file

#import"AppDelegate.h" #import<React/RCTBridge.h> #import<React/RCTBundleURLProvider.h> #import<React/RCTRootView.h> +++ #import <RNUnity/RNUnity.h> @implementationAppDelegate - (BOOL)application:(UIApplication *)applicationdidFinishLaunchingWithOptions:(NSDictionary *)launchOptions{+++ [RNUnity launchWithOptions:launchOptions]; // IMPORTANT to add this before react view creation RCTBridge *bridge = [[RCTBridge alloc] initWithDelegate:selflaunchOptions:launchOptions]; ... } +++ - (void)applicationWillResignActive:(UIApplication *)application{[[[RNUnity ufw] appController] applicationWillResignActive: application]} +++ - (void)applicationDidEnterBackground:(UIApplication *)application{[[[RNUnity ufw] appController] applicationDidEnterBackground: application]} +++ - (void)applicationWillEnterForeground:(UIApplication *)application{[[[RNUnity ufw] appController] applicationWillEnterForeground: application]} +++ - (void)applicationDidBecomeActive:(UIApplication *)application{[[[RNUnity ufw] appController] applicationDidBecomeActive: application]} +++ - (void)applicationWillTerminate:(UIApplication *)application{[[[RNUnity ufw] appController] applicationWillTerminate: application]} @end

8. In AppDelegate.m file make background color of React root view transparent

rootView.backgroundColor = [[UIColor alloc] initWithRed:1.0fgreen:1.0fblue:1.0falpha:0];

9. Add RNUProxy and UnityFramework to your project scheme. Select your project scheme -> Edit scheme... -> Build -> Click + -> Select RNUProxy/UnityFramework from list -> move UnityFramework before your app (drag and drop) and RNUProxy before UnityFramework

1. Add ndk support into android/app/build.gradle

   defaultConfig{... ndk{abiFilters "armeabi-v7a", "arm64-v8a" } }

2. Append the following lines to android/settings.gradle:

   include ':unityLibrary' project(':unityLibrary').projectDir=newFile('..\\unity\\builds\\android\\unityLibrary')

3. Insert the following lines inside the dependencies block in android/app/build.gradle:

    implementation project(':unityLibrary') implementation files("${project(':unityLibrary').projectDir}/libs/unity-classes.jar")

4. Change parent activity in MainActivity.java from ReactActivity to UnityReactActivity

   importcom.wowmaking.rnunity.UnityReactActivity; publicclassMainActivityextendsUnityReactActivity{... }

5. Add strings to res/values/strings.xml

   <stringname="game_view_content_description">Game view</string> <stringname="unity_root">unity_root</string>

6. Update .MainActivity into AndroidManifest.xml

   <activityandroid:name=".MainActivity" ... android:configChanges="mcc|mnc|locale|touchscreen|keyboard|keyboardHidden|navigation|orientation|screenLayout|uiMode|screenSize|smallestScreenSize|fontScale|layoutDirection|density"android:hardwareAccelerated="true"android:launchMode="singleTask" >

7. Setup minSdkVersion greater than or equal to 19
8. Remove <intent-filter>...</intent-filter> from AndroidManifest.xml at unityLibrary to leave only integrated version.

import{Unity,UnityResponderView}from'@wowmaking/react-native-unity';// Don't forget to initialize with name of GameObject, that you create at `Unity`->`Step 2`Unity.init('UICommandsDelegate');constApp=()=>{return(<View> <!-- UnityResponderView provide all touch events to Unity --> <UnityResponderView/><TouchableonPress={()=>Unity.execCommand('command_name',{/* any specific command data */})}>Press ME!</Touchable></View>);};

1. init - initialize react-native-unity lib Params:

   • delegateName (string) - name of Unity GameObject, that was created at Unity->Step 2

   Usage:

   Unity.init('UICommandsDelegate');

2. execCommand - send command to Unity Params:

   • name (string) - Unity command name
   • data (Object, optional) - Unity command data

   Return Promise Usage:

   Unity.execCommand('command_name',{a: 1,b: 'b',})

3. addEventListener - add listener of Unity events Params: - type (string) - type of Unity event - listener (function) - function, that's calling on Unity event receiving

   Usage:

   Unity.addEventListener('event_type',(e)=>{console.warn(e);});

4. removeEventListener - remove Unity event listener Params: - type (string) - type of Unity event - listener (function) - specific listener to remove

   Usage:

   Unity.addEventListener('event_type',listener});

1. void HandleCommand(RNCommand command) - method, that calls from JavaScript Params:
   • command (RNCommand) - command object, received from JavaScript

1. name (string) - name of received command
2. data ('object') - data of received command

1. Resolve - invoke on successful command execution Params:

   • data (object, optional) - object, that will receive JavaScript

   Usage:

   command.Resolve(new{text="test", });

2. Reject - invoke on unsuccessful command execution Params:

   • data (object, optional) - object, that will receive JavaScript

   Usage:

   command.Reject(new{text="test", });

1. SetCommandsReceiver - set commands reveiver to bridge Params:

   • cReceiver (IRNCommandsReceiver) - game object, that implements IRNCommandsReceiver interface

   Usage:

   privatevoidAwake(){RNBridge.SetCommandsReceiver(this)}

2. SendEvent - send event to JavaScript Params:

   • name (string) - event name, that receive JavaScript
   • data (object) - data object, that receive JavaScript listeners