3 Replacing Launcher on G2

3.1 For Unity Developers

The following instructions shows how to configure Unity application as Kiosk Mode app.

The Android Manifest is an XML file which contains important metadata about the Android app.The exact .XML file is placed under the Unity project path: /Assets/Plugins/Android/. This includes the package name, activity names, main activity (the entry point to the app), configurations, Android version support, hardware features support, and permissions.

_images/321.png
  • Step1: Modify package name

    Change the package name of launcher application to “com.picovrtob.vrlauncher”, and change VersionCode to 3000, as shown below:

_images/2.1.png

Note: In all PicoNeo system and above PicoGoblinPUI version 2.3.0, when there is a launcher contains a package named “com.picovrtob.vrlauncher”, it is the system default launcher. To switch Picolauncher, users can modify home screen as PicoVRlauncher via 2D settings.

  • Step2: Modify Main Activity

    Change Main Activity as codes shown below:

    <category android:name=”android.intent.category.HOME” />

    <category android:name=”android.intent.category.DEFAULT” />

_images/2.2.png
  • Step3: Unity Packaging

    For Unity packaging, package name and version number of Player Settings must be consistent with AndroidManifest file.

  • Step4: Install New Launcher

    After you built the application, install and press Home button, the new launcher would be started.

Note:

After Kiosk Mode installation, controller will not be able to connect back to headset automatically when reboot.

To easily utilize controller, please check this link: http://static.appstore.picovr.com/docs/ControllerBinding/index.html and install the 3Dof controller binding app on device. This app will pair a specified controller with headset, and connect back to headset on reboot automatically.

3.2 For Unreal Developers

The following instructions shows how to configure Unreal application as Kiosk Mode app. Please also find demo project here: https://drive.google.com/open?id=1A8OP36bFgY4oNWV_S4sFJLxj9Op9LcEr

_images/6.2.png
  • Step3: Use xml file to add activity to AndroidManifest

    GameActivity of Unreal app needs to be updated with a separate xml file.

    Download AddActivity.xml file from this link: https://drive.google.com/open?id=1Mv_q1CiamJRyfs43hmXrKrd5EZAtCJ99

    And then copy this file to [ProjectPath]/Source/[ProjectName]/.

    (e.g. If project name is “Kiosk_mode_Demo” under C: disk, the path should be

    C:/Kiosk_mode_Demo/Source/Kiosk_mode_Demo)

  • Step4: Modify function of build script

    Under path [ProjectPath]/Source/[ProjectName]/ , find build script “[ProjectName].build.cs”. Then add following lines to the end of function “public [ProjectName](ReadOnlyTargetRules Target) : base(Target) “:

if (Target.Platform == UnrealTargetPlatform.Android)
    {
        PrivateDependencyModuleNames.AddRange(new string[] { "Launch" });
        AdditionalPropertiesForReceipt.Add(new ReceiptProperty("AndroidPlugin", ModuleDirectory + "/AddActivity.xml"));
    }
  • Step5: Install New Launcher

    After built the application, install and press Home button, the new launcher would be started.

Note:

After Kiosk Mode installation, controller will not be able to connect back to headset automatically when reboot.

To easily utilize controller, please check this link: http://static.appstore.picovr.com/docs/ControllerBinding/index.html and install the 3Dof controller binding app on device. This app will pair a specified controller with headset, and connect back to headset on reboot automatically.