Meta Unity Starter Samples

The Crashlytics sample uses the C# unsafe keyword to force crashes for testing purposes. This is disabled by default in Unity and must be enabled in the Android Player Settings:

Edit > Project Settings... > Player > Android settings > Allow 'unsafe' code

To explore the samples within the Unity Editor:

1. Ensure you are using Unity 6000.0.66f2 or a newer version.
2. In the Unity Project window, navigate to Assets/StarterSamples/Usage.
3. Open individual scenes.
4. Press the Play button in the Unity Editor to test the scene functionality.

To use the Firebase sample, you must first integrate the Firebase SDK into your Unity project. Follow these steps:

1. Follow the official Firebase Unity Setup guide (steps 1 through 4).
2. From your downloaded firebase_unity_sdk, import the following packages into your project:
   • dotnet4/FirebaseAnalytics.unitypackage
   • dotnet4/FirebaseCrashlytics.unitypackage
3. If prompted, ensure you enable the Android Auto-Resolver.
4. Replace the template google-services.json file in your project with your own configuration file downloaded from the Firebase console.

After the Firebase SDKs are correctly installed and configured, you must activate the sample logic via the Oculus menu:

Oculus > Samples > Firebase > Enable Firebase Sample

Before integrating, ensure your project uses the same Meta SDK version as the samples.

Option 1: Copying the directory

1. Copy the Assets/StarterSamples directory directly into your project's Assets folder.

Option 2: Using a UnityPackage

1. Open the Unity-StarterSamples project in Unity.
2. Right-click the Assets/StarterSamples folder and select Export Package....
3. Save the .unitypackage file.
4. Open your target project.
5. Go to Assets > Import Package > Custom Package... from the menu bar.
6. Select the saved package and click Open.

You can test the samples on a physical device using two methods:

Method 1: Build the Starter Scene APK

Use the built-in menu to generate a single APK that allows you to cycle through different sample scenes on the device:

1. In Unity, navigate to Meta > Samples > Build Starter Scene.
2. This builds an APK containing the Starter Scene.

Method 2: Manual APK Deployment

1. Locate the StartScene.apk file within the Unity-StarterSamples folder.
2. Copy the APK to your device using Meta Quest Developer Hub.

To get the source code for the Unity Starter Samples, clone the repository using Git.

git clone https://github.com/oculus-samples/Unity-StarterSamples.git

This project requires the following Meta SDKs. You can find them in the Unity Asset Store.

Specific dependency versions are defined in the project's Packages/manifest.json and include:

• Meta XR Core SDK