Sunday, 15 December 2013

UnityPlayer as Subview with Transparent Background (iOS)

In a previous post I was experimenting with Android & Unity to be able to use Unity as subview overlaying a native UI made with Android... now I tried to do the same but with iOS.

Since Unity 4.2 it became easier to override unity ios view to do your own custom one and combine it with native views inside iOS application.

In this post I will outline the steps to have a simple unity scene with native controls using Unity 4.2 (basic license).

Unity Scene
  1. For simplicity I created a scene with a rotating cube and for the camera I set the color to (0,0,0,0) 
  2. Inside one of my "RotatingCube" gameobject's scripts I added a listener function that simply toggle the direction everytime it is called:
  3. void OnTogglePressed(string message)
         Debug.Log("Toggle direction");
         direction *= -1;
  4. Once all done save the scene and build for iOS to generate XCode project

The generated XCode project
  1. First thing to do is to support transparent background in unity view. To do that simply do a minor change to CreateSystemRenderingSurface method inside to have:
    surface->layer.opaque = NO;
  2. Create UIViewController (you can also subclass UnityViewControllerBase if you wish) with some native controls: In my case I simply added a UILabel and UIButton (which I will use to toggle rotation direction) 
  3. Create a subclass for UnityAppController (e.g. MyUnityAppController) where we will override some methods:
    // the header file
    #import "UnityView.h"
    #import "UnityAppController.h"
    @interface MyUnityAppController : UnityAppController
    // the implementation file
    #import "MyUnityAppController.h"
    #import "MyNativeViewController.h"
    @interface MyUnityAppController ()
    @implementation MyUnityAppController
    // I simply removed the user interaction from unityview
    - (UnityView*)initUnityViewImpl
        UnityView *unityView = [[UnityView alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
        unityView.userInteractionEnabled = NO;
        return unityView;
    // here I am using my UIViewController as _rootController
    - (void)createViewHierarchyImpl
     _rootView = _unityView;
     _rootController = [[MyNativeViewController alloc] init];
    // I had to override this method (although unity doesn't recommend it) to change one line 
    // instead of assigning _rootView as _rootViewController.view I've added it as a subview
    - (void)createViewHierarchy
     [self createViewHierarchyImpl];
     NSAssert(_rootView != nil, @"createViewHierarchyImpl must assign _rootView");
     NSAssert(_rootController != nil, @"createViewHierarchyImpl must assign _rootController");
     [_rootController.view addSubview:_rootView];
     if([_rootController isKindOfClass: [UnityViewControllerBase class]])
      [(UnityViewControllerBase*)_rootController assignUnityView:_unityView];
  5. Inside my UIViewController I set the UIButton to call "OnTogglePressed" method mentioned earlier when building the scene using UnitySendMessage method:
        UnitySendMessage("RotatingCube", "OnTogglePressed", "");
  7. Last thing to do is to change the appcontroller name inside from UnityAppController to MyUnityAppController then you should be able to see the cube scene with the label and the button:
Video of it in action:

There are few things which need to be investigated: for example whether we can have only a part of the screen for Unity Scene (similar to what I've done with Android). Setting unityview frame didn't give me expected results so I might need to dig deeper.
For now this seems to work using full screen.

If anyone have good ideas or did something similar please share! :-)


  1. This comment has been removed by the author.

  2. This is awesome! Thank you for sharing. Did you happen to dig a bit deeper on making the Unity Scene be something smaller than full screen? I also tried out messing with the the unityview frame but didn't get what I needed.

    1. Thanks Fernando.

      Didn't have the time or the chance yet.

  3. Sadly, this doesn't seem to work for Unity 5.2. Any idea how I can accomplish this?

  4. On iOS with Metal API you have to change the file to:

    CGFloat backgroundColor[] = {0,0,0,0};

    and add

    surface->layer.opaque = NO;

    Works for me on Uniti 5.2.

    1. Thanks for that. I didnt try with Unity 5.2 yet

  5. What are your settings in Unity, Are you sure it worked for you?

  6. Of course I am sure :)
    Maybe this snippet helps you.
    Does your iOS app runs unity with Metal and not with a fault back to OpenGL?

    extern "C" void CreateSystemRenderingSurfaceMTL(UnityDisplaySurfaceMTL* surface)

    MTLPixelFormat colorFormat = surface->srgb ? MTLPixelFormatBGRA8Unorm_sRGB : MTLPixelFormatBGRA8Unorm;

    surface->layer.presentsWithTransaction = NO;
    surface->layer.drawsAsynchronously = YES;
    CGFloat backgroundColor[] = {0,0,0,0};
    surface->layer.opaque = NO;
    surface->layer.backgroundColor = CGColorCreate(CGColorSpaceCreateDeviceRGB(), backgroundColor);
    surface->layer.device = surface->device;
    surface->layer.pixelFormat = colorFormat;
    //surface->layer.framebufferOnly = YES;
    surface->layer.framebufferOnly = NO;
    surface->colorFormat = colorFormat;