Simple Unity 3D WebView is a straightforward 3D WebView library designed for the Android platform, enabling seamless integration of web content within Unity projects.

This release includes key improvements for compatibility and developer experience:

• Support for Unity 2023.1 and Later Adapted to breaking changes in UnityPlayer introduced in Unity 2023.1 and newer versions.
• No More Subclassing of UnityPlayerActivity The implementation no longer relies on subclassing UnityPlayerActivity or UnityPlayerGameActivity, improving cross-version compatibility.
• Android Code Now Packaged as AAR All Android-side JVM code is consolidated into a single .aar file, streamlining integration and enhancing build efficiency.

1. Install the package (Official Manual).
2. Go to File > Build Settings, select Android as the platform, and click Switch Platform.
3. Click Player Settings, then under Publishing Settings > Build, enable both Custom Main Manifest and Custom Main Gradle Template. Note the paths shown.
4. Open the generated AndroidManifest.xml at the specified path and make the following changes:
   • Add the following tag inside the <manifest> element:

     <uses-permission android:name="android.permission.INTERNET" />

   • Inside the <application> element, add:

     android:networkSecurityConfig="@xml/network_security_config"
     android:hardwareAccelerated="true"

5. Open the generated mainTemplate.gradle at the same path and modify it as follows:
   • In the dependencies block, add:

     implementation "org.jetbrains.kotlin:kotlin-stdlib:2.0.21"

• AndroidManifest.xml Sample
• mainTemplate.gradle Sample

1. Install the package (Official Manual).
2. Go to File > Build Settings, select Android as the platform, and click Switch Platform.
3. In Player Settings, under Other Settings > Configuration, check GameActivity and uncheck Activity.
4. Under Publishing Settings > Build, enable both Custom Main Manifest and Custom Main Gradle Template. Note the paths shown.
5. Open the generated AndroidManifest.xml and make the following changes:
   • Remove the <activity> tag for UnityPlayerActivity.
   • Add the following tag inside the <manifest> element:

     <uses-permission android:name="android.permission.INTERNET" />

   • Inside the <application> element, add:

     android:networkSecurityConfig="@xml/network_security_config"
     android:hardwareAccelerated="true"

6. Open the generated mainTemplate.gradle and add the following line in the dependencies block:

   implementation "org.jetbrains.kotlin:kotlin-stdlib:2.0.21"

• AndroidManifest.xml Sample
• mainTemplate.gradle Sample

1. Create a RawImage object on a suitable Canvas, and add the PointerEventSource component.

2. Add the WebViewManager component to a GameObject, and update the Inspector as follows:

   • Assign the previously created RawImage to both Web View Image and Pointer Event Source.
   • Set Texture Width to the width (in pixels) of the texture used to render the web content.
   • Set Interval MSec to the update interval of the texture in milliseconds.
   • Set Default Url to the initial URL to load (leave blank to skip automatic loading).
   • Set Normalized Touch Slop to adjust the drag sensitivity, normalized by texture size. (Note: this setting is currently not fully functional.)

3. Depending on the target device, add any required input or interaction components (e.g., XR Interaction Toolkit, Oculus Interaction SDK) to enable UI interaction.

Sample prefabs are available in Assets/SamplePrefabs for reference.

• Click and drag on the RawImage to perform touch interactions.

  • Additionally, attach UI input components (e.g., XR Interaction Toolkit, Oculus Interaction SDK) appropriate to your target device to enable interaction with the web view.
    • Specifically, the system responds to Unity UI events such as IPointerExitHandler, IPointerDownHandler, IPointerUpHandler, and IDragHandler in the UnityEngine.EventSystems namespace.

• You can control browser behavior through the public methods of the WebViewManager component:

  • void LoadUrl(string url): Loads the specified URL.
  • void Reload(): Reloads the current page.
  • void GoBack(): Navigates back in the browser history.
  • void GoForward(): Navigates forward in the browser history.
  • void SetKeyboardInputEnabled(bool isEnabled): Enables or disables keyboard input.
  • void EvaluateJavascript(string script): Executes JavaScript in the current page.

• To start or stop screen updates, enable or disable the WebViewManager component itself:

  • webViewManager.enabled = true; enables texture updates.
  • webViewManager.enabled = false; stops texture updates.

The WebViewManager component provides UnityEvents for communicating from JavaScript running inside the WebView:

• urlChanged: Invoked when the current page URL changes.

  • Signature: UnityEvent<string> — receives the new URL as a string.

• dataReceived: Invoked when JavaScript calls Android.sendJsonData(...).

  • Signature: UnityEvent<ReceivedData> — receives a structured data object from JavaScript.

To send data from the web page, call the following in JavaScript:

Android.sendJsonData('YOUR_TYPE', JSON.stringify({ id: 100, name: 't34400' }));

This will trigger the dataReceived event on the WebViewManager. The event receives a ReceivedData object with the following structure:

namespace WebView
{
    [System.Serializable]
    public struct ReceivedData
    {
        public string type;
        public string data;
    }
}

using UnityEngine;
using WebView;

public class TestComponent : MonoBehaviour
{
    private const string MY_SCRIPT = 
        "const data = { id: 100, name: 't34400' };" +
        "try {" +
        "   const dataJson = JSON.stringify(data);" +
        "   Android.sendJsonData('YOUR_TYPE', dataJson);" +
        "} catch(e) {" +
        "   console.error(e.message);" +
        "}";

    [SerializeField] private WebViewManager webViewManager;

    // Register this method to WebViewManager.dataReceived in the Inspector
    public void OnDataReceived(ReceivedData received)
    {
        if (received.type == "YOUR_TYPE")
        {
            var idNameData = JsonUtility.FromJson<IdNameData>(received.data);
            Debug.Log($"ID: {idNameData.id}, Name: {idNameData.name}");
        }
    }

    private void Update()
    {
        // Call Android.sendJsonData() in JavaScript
        webViewManager.EvaluateJavascript(MY_SCRIPT);
    }

    [System.Serializable]
    public struct IdNameData
    {
        public int id;
        public string name;
    }
}

To handle the urlChanged event, define a method like public void OnUrlChanged(string url) and register it in the Inspector.

1. Open Assets/Plugins/Android/res.androidlib/res/xml/network_security_config.xml (cannot be displayed in the UnityEditor; open through other means).
2. Add <domain includeSubdomains="true">[hostname]</domain> to the tag.
   • By default, only localhost has this feature enabled.

• The output from WebView's JavaScript console is logged to Logcat with the tag WebViewConsole.
• WebView texture transfer from Android native to Unity is simple and CPU-based, so heavy processing may occur with large texture sizes or excessively frequent updates.
• Text input with the keyboard is supported for input and textarea tags but may be somewhat unstable.
• If you are developing a project using OpenXR, uncheck Force Remove Internet under Project Settings > OpenXR > Meta Quest Support.
  • In Unity OpenXR package versions prior to 1.9.1, there is a bug where, even if this checkbox is unchecked, the Internet permission is removed. To address this issue, either update the OpenXR version in Packages/manifest.json to 1.9.1, or use Post Gradle during the build process to remove the OpenXR permission and then re-add it to the manifest.

• When using on Meta Quest, add the following permission to AndroidManifest.xml:

  <uses-feature android:name="oculus.software.overlay_keyboard" 
                android:required="true" />

The Android-side implementation bundled as an .aar is open source and available here:

• View AAR Source Code

MIT License

The button icons used in the sample prefabs are borrowed from Evericons under the CC0 1.0 Universal license. We sincerely appreciate their generosity and the availability of these icons for use in our project.