Set up Unity Cloud Content Delivery for your Project

You can automatically export your Unity Forma builds to Unity Cloud Content Delivery to make them accessible to others in your organization.

Prerequisites

Before you start, make sure that you have a valid Unity ID account and subscription (or trial subscription) to Unity Cloud Content Delivery.

Setup and Build

You can configure Exports from Unity Forma to Unity Cloud Content Delivery automatically or manually.

Automatic

  1. In the Unity Forma interface, select to the Forma Export Tab.
  2. To add a new Build Profile, select Add.
  3. Select the Publish to CCD checkbox. Other options for setting up export to Unity Cloud Content Delivery appear.
  4. In the CCD Project ID field, select the settings icon.
    The Services General Settings window opens.
  5. In the Organizations drop-down, select the Organization you want to link to this Project.
  6. In the Projects drop-down, select the Project you want to link it to.
  7. Select the Link Project ID button.
  8. Close the Services General Settings window and return to your Build Profile.
  9. In the Bucket ID drop-down menu, select the Bucket ID a new bucket using the Bucket ID you want to use for this Build Profile.
  10. Select Build and then select Publish Products.

    Your first release appears in your Unity Cloud Content Delivery bucket, tagged as latest.

The Editor automatically adds the CloudContentDeliveryProductSource component to your configurator Scene before it builds the project. The component loads the latest products from the CCD bucket on startup.

Note: Products output build can be found under [PROJECT FOLDER]/ServerData. Building without selecting a publisher will use [PROJECT FOLDER]/Library/com.unity.addressables/aa/[PLATFORM TARGET].

Manual

You can manually set up export to Unity Cloud Content Delivery.

  1. From your Unity Cloud Content Delivery dashboard, select the Project you want to use (or add a new one).
  2. Save the Project ID. You will need it in later steps.
  3. Navigate to the API Key tab and note the API Key. You will need it in later steps.
  4. Navigate to the Buckets tab.
  5. Add a new bucket for your current Unity platform.
    Important: Addressable assets are only compatible with the platform on which they were built. For examples, Windows cannot load Android Addressable Assets).
  6. In the Unity Forma interface, select to the Forma Export Tab.
  7. To add a new Build Profile, select Add.
  8. Under the Product parameters, in the Publish Products drop-down, select Remote.
    .
  9. Select the Publish to CCD checkbox.
  10. In the API Key field, enter the API key that you noted from the CCD dashboard.
  11. In the Bucket drop-down, select the Bucket that you added.
  12. Select Build.

    Your first release appears in your Unity Cloud Content Delivery bucket, tagged as latest.

Loading Products

You can load your Products in the Build, or in the Unity Editor (advanced).

Loading Products in the Build

You load Products in the Build locally or remotely.

Local

The system automatically builds and moves Products in the StreamingAssets folder.

By default, the MixedProductSource component loads catalogs in this directory on startup.

Remote

The system automatically adds the CloudContentDeliveryProductSource component to your configurator Scene before it builds the Project.

The component loads the latest products from the CCD bucket on startup.

In the Unity Editor (Advanced)

Note: To access advanced settings for your Configurator, you must switch to the Unity Editor interface (Forma>Switch Mode).

To load remote product catalogs in the Editor, you must change the Play Mode Script in the Addressable Groups Window to Use Existing Build.


For more information for developers about Addressable Assets in Unity Forma, see Forma GameObjects

Product Source

To select a Product Source in the Editor, follow these steps:

  1. Select your Configurator GameObject and add the CloudContentDeliveryProuctSource.cs component.

  2. Enter your Project ID and Bucket ID. The default badge is latest, but you can specify your own.

  3. Add the Product Source to your Configurator Settings.

Now, the configurator always loads the latest version from your CCD bucket.