Ready Player Me WebView is an extension to www.readyplayer.me avatar platform and is an optional part of the Ready Player Me Unity SDK, which helps you load and display avatars created on the website.
Please visit the online documentation and join our public discord
community.
:octocat: GitHub Discussions
Ready Player me Webview module requires, that you have core package installed. Please refer to the Quick Start guide for instructions on how to install the Unity Core module.
The installation steps for the Webview module can be found here.
Users can create Ready Player Me avatars seamlessly in a WebView displayed within a Unity application.
Ready Player Me Core: You need the Unity Ready Player Me Core for Unity installed in your project to retrieve avatars. See the Quickstart guide for instructions.
Deploying the app. In order to test your WebView app, you have to deploy it to a physical or virtual device. See the Unity documentation on how to do that.
Required permissions. The Ready Player Me WebView module requires the following permissions to enable all features:
We provide a script that will automatically add these permissions for Android called AndroidBuildProcessor.cs which is is enabled by default.
To disable this just add the following define to your project via the player settings for Android build target: RPM_DISABLE_WEBVIEW_PERMISSIONS
Creating a Scene with a WebView in your Unity project is the same for Android and iOS.
Samples/Ready Player Me WebView/\[VERSION_NUMBER\]/WebView
.NOTE: The WebView example scene will not load an avatar into the unity scene, it will just return and display the avatar URL on the screen. To load an avatar in the screen you can create an avatar loader script make use of the OnAvatarCreated event on the WebViewPanel.
Player > Other Settings > Identification
.
Player > Other Settings > Under Configuration > Camera Usage Description
and put some descriptive text in this mandatory field.Player > Other Settings > Under Configuration > Microphone Usage Description
and put some descriptive text in this mandatory field. Alternatively, you can build the APK and deploy it on your own. For release builds, see the Unity and Android documentation.
Player > Other Settings > Identification
.
com.YourCompanyName.YourProductName
.Signing Team ID
(not required for Debug builds to complete).Player > Other Settings > Under Configuration > Camera Usage Description
and put some descriptive text in this mandatory field.Player > Other Settings > Under Configuration > Microphone Usage Description
and put some descriptive text in this mandatory field.Unity-iPhone.xcodeproj
.As of WebView 2.0 a number of changes have been made to isolate the WebView module from the rest of the Ready Player Me Unity SDK.
This means that the classes and logic required to work with an iFrame (AKA a WebView), that is running Web Avatar Creator have now been moved to the Ready Player Me Core module. This change enables developers to utilize API's for working with any iFrame, without requiring the installation of our WebView package.
As such the following classes are now located in the Ready Player Me Core module:
If you have any scripts in your Unity project that reference these classes you will need to update the namespace to use ReadyPlayerMe.Core instead of ReadyPlayerMe.WebView, be sure to update the import statements in these scripts.
EG: using ReadyPlayerMe.WebView;
should be changed to using ReadyPlayerMe.Core;