Criar para Unity

Use este guia para incorporar o Play Asset Delivery ao seu projeto do Unity.

Visão geral

Os arquivos AssetBundle do Unity contêm recursos serializados que podem ser carregados pelo mecanismo do Unity enquanto o app está em execução. Esses arquivos são específicos da plataforma (por exemplo, criados para Android) e podem ser usados em combinação com pacotes de recursos. Geralmente, um arquivo AssetBundle é combinado em um único pacote que usa o mesmo nome do AssetBundle. Se você quiser mais flexibilidade na criação de um pacote de recursos, configure-o usando a API.

No ambiente de execução, use a classe Play Asset Delivery para Unity para recuperar um AssetBundle empacotado em um pacote de recursos.

Pré-requisitos

  1. Faça o download do plug-in (ou pacote) do Unity para o Play Asset Delivery.

  2. Crie AssetBundles no Unity.

Configurar AssetBundles usando a IU

  1. Configure cada AssetBundle em um pacote de recursos:

    1. Selecione Google > Android App Bundle > Asset Delivery Settings.
    2. Para selecionar pastas que contenham arquivos do AssetBundle diretamente, clique em Add Folder.

  2. Para cada pacote, mude o Delivery Mode para Install Time, Fast Follow ou On demand. Resolva erros ou dependências e feche a janela.

  3. Selecione Google > Build Android App Bundle para criar o pacote de apps.

  4. (Opcional) Configure seu pacote de apps para que ele seja compatível com diferentes formatos de compactação de textura.

Configurar pacotes de recursos usando a API

Você pode configurar a entrega de recursos pelos scripts de editor, que podem ser executados como parte de um sistema de compilação automatizado.

Use a classe AssetPackConfig para definir quais recursos incluir em uma compilação do Android App Bundle, bem como o modo de entrega dos recursos. Esses pacotes de recursos não precisam conter um 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);
}

Você também pode usar o método estático BuildBundle na classe Bundletool para gerar um Android App Bundle com pacotes de recursos, usando BuildPlayerOptions e AssetPackConfig.

A seguir

Integre o Play Asset Delivery ao código do seu jogo ou app usando o Unity.