🤳Adding AR Capabilities
Learn how to add AR capabilities to your cloud-connected Flutter project.
Now that you are successfully able to stream 3D content into Flutter and know how to make custom adjustments, it's time to add AR capabilities to your project.
To add AR capabilities, we will integrate Unity as a library into our Flutter project.
Unity provides a framework purpose-built for AR development called AR Foundation. It allows you to build across multiple mobile and wearable AR devices, such as Android with ARCore and iOS with ARKit.
1. Repository Setup
Clone our open-source Flutter + Unity + AR Foundation + echo3D example project.
2. Console Setup
Add a 3D model to the console.
Create a new Unity project.
Open the sample scene under echo3D/Examples/sample.unity
.
Set the API key in the Inspector of the echo3D game object.
3. Unity Project Build Settings
Android
Open the Build Settings window by clicking File > Build Settings....
Select Android and click Switch Platform.
Check Export Project.
Open the Player Settings window by clicking Player Settings...
Configure the folowing:
Other Settings > Rendering > Graphics APIs: OpenGLES3
Other Settings > Configuration > Scripting Backends: IL2CPP
Other Settings > Configuration > Target Architectures: ✔ ARMv7, ✔ ARM64
Notice what is your Minimum API Level. You may need it later.
Close the Player Settings window.
Click Add Open Scenes.
Click Export and save as unityExport.
iOS
Open the Build Settings window by clicking File > Build Settings....
Select iOS and click Switch Platform.
Click Add Open Scenes.
Click Export and save as unityProject.
4. Flutter Configuration
Import the project dependecies by running flutter pub get
from your terminal
Android
Copy your unityExport folder to <your_flutter_project>/android/unityExport
Run flutter pub run flutter_unity:unity_export_transmogrify
in your terminal
Open <your_flutter_project>/android/app/build.gradle
and make sure your project minSdkVersion equals to the one you defined for your Unity Project as Minimum API Level.
Open <your_flutter_project>/android/build.gradle
and, inside allprojects { repositories {} }
, add the following:
so it will look something like this:
Open <your_flutter_project>/android/settings.gradle
and add the following at the end of the file:include ':unityExport'
iOS
Copy your UnityProject folder to <your_flutter_project>/iOS/UnityProject
Open <your_flutter_project>/iOS/Runner.xcworkspace
in Xcode
Go to File > Add Files to "Runner", and add <your_flutter_project>/ios/UnityProject/Unity-iPhone.xcodeproj
Select Unity-iPhone/Data
, and, in the Inspectors pane, set the Target Membership to UnityFramework
Select Unity-iPhone
, select PROJECT : Unity-iPhone, and, in the Build Settings tab, configure the following:
Build Options > Enable Bitcode: No
Linking > Other Linker Flags: -Wl,-U,_FlutterUnityPluginOnMessage
Select Runner, select TARGETS : Runner, and, in the General tab, configure the following:
Frameworks, Libraries, and Embedded Content: UnityFramework.framework -> Embed & Sign
Open Runner/Runner/Info.plist
, and configure the following:
Key | Type | Value |
io.flutter.embedded_views_preview | Boolean | YES |
5. Run
Open your main.dart
file.
Find and replace the value <YOUR-PROJECT-KEY>
with your API key and uncomment the code line.
Find and replace the value <YOUR-ENTRY-ID>
with your model's entry ID and uncomment the code line.
Save the file and run the project on an phone.
Last updated