Cómo compilar para Unity

Usa esta guía a fin de incorporar Play Asset Delivery a tu proyecto de Unity.

Descripción general

Los archivos AssetBundle de Unity contienen elementos serializados que el motor de Unity puede cargar mientras se ejecuta la app. Esos archivos son específicos de cada plataforma (por ejemplo, compilados para Android) y se pueden usar junto con paquetes de elementos. Por lo general, se empaqueta un archivo AssetBundle en un solo paquete de elementos, con el mismo nombre que el AssetBundle. Si quieres más flexibilidad para crear un paquete de elementos, configura el paquete con la API.

Durante el tiempo de ejecución, usa la clase Play Asset Delivery para Unity a fin de recuperar un archivo AssetBundle incluido en un paquete de elementos.

Requisitos previos

  1. Obtén el complemento (o paquete) de Unity para Play Asset Delivery.

  2. Crea archivos AssetBundle en Unity.

Cómo configurar archivos AssetBundle con la IU

  1. Configura cada archivo AssetBundle en un paquete de elementos:

    1. Selecciona Google > Android App Bundle > Asset Delivery Settings.
    2. Para seleccionar carpetas que contengan directamente archivos AssetBundle, haz clic en Add Folder.

  2. Para cada paquete, cambia el modo de entrega en Delivery Mode a Install Time, Fast Follow u On Demand. Resuelve los errores o dependencias y cierra la ventana.

  3. Selecciona Google > Build Android App Bundle para compilar el paquete de aplicación.

  4. Opcional: Configura el paquete de aplicación para que sea compatible con diferentes formatos de compresión de texturas.

Cómo configurar paquetes de elementos con la API

Puedes configurar Asset Delivery a través de secuencias de comandos del editor, que se pueden ejecutar como parte de un sistema de compilación automatizado.

Usa la clase AssetPackConfig para definir qué elementos incluirás en una compilación de Android App Bundle y el modo de entrega de los elementos. Esos paquetes de elementos no necesitan contener un AssetBundle.

public void ConfigureAssetPacks {
   // Creates an AssetPackConfig with a single asset pack, named
   // examplePackName, containing all the files in path/to/exampleFolder.
   var assetPackConfig = new AssetPackConfig();
   assetPackConfig.AddAssetsFolder("examplePackName",
                                   "path/to/exampleFolder",
                                   AssetPackDeliveryMode.OnDemand);

   // Configures the build system to use the newly created assetPackConfig when
   // calling Google > Build and Run or Google > Build Android App Bundle.
   AssetPackConfigSerializer.SaveConfig(assetPackConfig);

   // Alternatively, use BundleTool.BuildBundle to build an App Bundle from script.
   BuildBundle(new buildPlayerOptions(), assetPackConfig);
}

También puedes usar el método estático BuildBundle en la clase Bundletool para generar un Android App Bundle con paquetes de elementos, dadas BuildPlayerOptions y AssetPackConfig.

Siguiente paso

Integra Play Asset Delivery en el código de tu app o juego con Unity.