Upgrade Guide

Version 3.2.0 (12-09-2023)

SDK version 3 upgrade guide.

If you have configured an Instanced Override (opens new window) of a Prefab containing an Ad Space Game Object, please follow this prerequisite step

Remove Obsolete Files

Delete the following folders from your project: FrameplaySDK/DLL, FrameplaySDK/Editor, FrameplaySDK/Example, FrameplaySDK/Materials, FrameplaySDK/Plugins, FrameplaySDK/Scripts, FrameplaySDK/Shaders and FrameplaySDK/Textures. Compile errors and missing assets will be fixed by the updated asset.

Import the Updated SDK Asset

1. Download the latest version of the Frameplay plugin from the downloads page (opens new window)
2. Open your project in the Unity editor.
3. Select Assets > Import Package > Custom Package and locate the FrameplayPlugin.unitypackage.
4. Make sure all files are selected and click Import.

Update Project Data

1. Select the editor menu Frameplay > Upgrade Frameplay Project Data
2. Select the editor menu Frameplay > Developer Settings

This completes the SDK upgrade. After successfully upgrading your project, the following logs will appear in the Console:

(Additional) Update Script References

If you have customized your integration with Frameplays API, you may need to update your scripts. The Frameplay SDK is now initialized by calling Frameplay.Session.Start(). We have provided an example script FrameplaySDK/Example/Scripts/FrameplayStartSession.cs that will initialize the SDK and register the in-game camera.

Please update your references to the Frameplay API. Full API details can be found here

TroubleShooting

If you encounter any issues while upgrading the SDK, please contact our Integration Team for support. Please attach the FrameplayUpgradeProject.xml file located at the root of your project.