static function BuildStreamedSceneAssetBundle (levels : string[], locationPath : String, target : BuildTarget) : String

Parameters

Returns

String - String with an error message, empty on success.

Description

Builds one or more scenes and all their dependencies into a compressed asset bundle.

The scene AssetBundle can be built for any target platform and always creates a single compressed unity3d file.

The scene can be downloaded and loaded using the WWW class. You can use WWW.LoadFromCacheOrDownload to cache the downloaded scene after it has been downloaded.

// Build a streamed unity3d file. This contain one scene that can be downloaded
// on demand and loaded once its asset bundle has been loaded.

@MenuItem ("Build/BuildWebplayerStreamed")
static function MyBuild(){
    var levels : String[] = ["Assets/Level1.unity"];
    BuildPipeline.BuildStreamedSceneAssetBundle( levels, "Streamed-Level1.unity3d", BuildTarget.WebPlayer); 
}

When downloading the built compressed file, you need to call WWW.assetBundle in order to make the scene available to the Application.LoadLevel() and Application.LoadLevelAdditive() functions.

function Start () {
    // Download compressed scene. If version 5 of the file named "Streamed-Level1.unity3d" was previously downloaded and cached.
    // Then Unity will completely skip the download and load the decompressed scene directly from disk.
    var download = WWW.LoadFromCacheOrDownload ("http://myWebSite.com/Streamed-Level1.unity3d", 5);
    yield download;
    
    // Handle error
    if (download.error != null)
    {
        Debug.LogError(download.error);
        return;
    }
    
    // In order to make the scene available from LoadLevel, we have to load the asset bundle.
    // The AssetBundle class also lets you force unload all assets and file storage once it is no longer needed.
    var bundle = download.assetBundle;
    
    // Load the level we have just downloaded
    Application.LoadLevel ("Level1");
}