Use case: Load a scene from the cloud

This use case outlines the basics of setting up a streaming-ready scene. Use this use case to learn how to stream a scene from the cloud.

Prerequisites

To accomplish this use case, you require the following:

  • Install the Data Streaming package on a new or existing Unity project (refer to Installation).
  • Add these packages to the manifest.json:
  {
    "dependencies": {
      // Add these lines:
      // Replace "<x.y.z>" with the version you wish to install
      "com.unity.cloud.identity": "<x.y.z>",
      "com.unity.cloud.storage": "<x.y.z>"
      // Other dependencies...
    }
  }

Overview

To accomplish this use case, do the following:

  1. Upload a scene
  2. Create a cloud streaming behavior
  3. Set up a new scene

Upload a scene

To upload a scene, follow these steps:

  1. Log into the Unity Cloud Portal.

  2. Select New to create a scene.

    Screen capture that displays adding a new scene

  3. Name the scene My First Scene and select Create.

  4. Select files to upload a file.

    Screen capture that displays uploading a file for your scene

Create a cloud streaming behavior

To create a cloud streaming behavior, follow these steps:

  1. Open your Unity project.
  2. Go to the Assets folder in the Project window.
  3. Right Click and Select Create > C# Script.
  4. Rename the new script as CloudDataStreaming.
  5. Open the CloudDataStreaming script and replace the content with the following:

Set up a new scene

To set up a new scene, follow these steps:

  1. Create a new scene.
  2. Create a GameObject called Streamer.
  3. Select Add Component in the Inspector window and add the Cloud Data Streaming component.
  4. Copy the scene id part of the scene details on the Unity Cloud Portal.
  5. Paste the Scene ID in the Cloud Data Streaming inspector field.
  6. Add a Camera in your scene if one doesn't exist.
  7. Set the CloudDataStreaming Component Camera value to your scene camera.
  8. Select Play to view your project load in front of the camera.*
  • If the scene does not load in front of the camera, select the menu item Edit / Frame Streamed Scene.