Как настроить таргетинг на форматы сжатия текстур в наборах Android App Bundle

Текстуры – это изображения, которые можно наносить на поверхность 3D-модели. Текстуры также используются в 2D-рендеринге для отрисовки таких элементов, как спрайты или фоны. На этой странице описаны популярные форматы сжатия текстур, используемые в играх, и способы их применения в наборах Android App Bundle. Прежде чем начать работу с этим руководством, прочитайте статьи О наборах Android App Bundle и Play Asset Delivery.

Фон

Обычно графические процессоры поддерживают набор форматов сжатия текстур. Формат сжатия текстур (или TCF) – это формат файлов, оптимизированный для графических процессоров. Графический процессор загружает и отрисовывает текстуру быстрее и с меньшим объемом памяти, чем если бы он использовал массив значений RGBA в памяти. Эта поддержка осуществляется на аппаратном уровне: производитель графического процессора встраивает в чип видеокарты компоненты, которые считывают, распаковывают и визуализируют поддерживаемые форматы.

Ниже приведены распространенные форматы сжатия текстур на современных мобильных устройствах.

  • ASTC – современный формат, который должен заменить предыдущие. Более гибкий, чем предыдущие форматы, благодаря поддержке блоков разного размера. Использование этого формата – хороший способ оптимизировать размер игры.
  • ETC2: поддерживается всеми устройствами, которые поддерживают OpenGL ES 3.0 и более поздние версии. Это почти все активные мобильные устройства Android.

Эти форматы поддерживаются на устройствах Android в следующих приблизительных пропорциях:

Формат сжатия текстур Процент устройств Google Play с поддержкой
ASTC > 80 %
ETC2 > 95 %

Графические процессоры настольных компьютеров, на которых запущено приложение Google Play Games для ПК, также поддерживают этот формат:

  • DDS или S3TC. Иногда называется BCn, DXTC или DXTn.

Устаревшие форматы сжатия текстур, которые больше не рекомендуются:

  • ETC1: поддерживается на большинстве устройств. Этот формат не поддерживает прозрачность, но в играх можно использовать второй файл текстуры для альфа-компонента.
  • PVRTC – популярный формат для игр на iOS, который также поддерживается на некоторых устройствах Android.

Поддержка ETC1 требуется только для игр, которые работают на очень старых устройствах или некоторых устройствах Android TV, не поддерживающих OpenGL ES 3.0 и более поздние версии.

Формат по умолчанию

Из-за большого количества доступных форматов (с разным уровнем поддержки устройств) может быть сложно выбрать, какие из них использовать при создании текстур для игры. В качестве меры предосторожности формат набора App Bundle позволяет выбрать формат сжатия текстур по умолчанию для каждого пакета объектов. Если устройство не поддерживает другие указанные форматы, устанавливаются объекты, использующие этот формат по умолчанию.

Если вы не настраиваете таргетинг на очень старые устройства, ETC2 – хороший выбор в качестве формата по умолчанию. Используйте форматы ETC2, поддерживаемые в OpenGL ES 3.0. Эти форматы также доступны в Vulkan Graphics API.

Формат ASTC поддерживает блоки сжатия разных размеров, что позволяет выбирать между качеством изображения и степенью сжатия. В зависимости от характера исходного материала для данной текстуры вы можете выбрать меньший или больший размер блока, чтобы сохранить приемлемое визуальное качество.

Если ваша игра поддерживает Google Play Игры на компьютере и использует Vulkan, добавьте текстуры S3TC. Форматы S3TC поддерживаются всеми графическими процессорами для настольных ПК.

Как создать набор App Bundle

Google Play использует наборы Android App Bundle, чтобы создавать и распространять APK-файлы, оптимизированные для конфигурации устройства каждого пользователя. Таким образом, пользователи скачивают только код и ресурсы, необходимые для запуска игры. В таких APK-файлах содержится один набор текстур, сжатых в оптимальном для устройства формате.

Если вы не используете Unity, создайте набор App Bundle с помощью Gradle. Опытные пользователи могут использовать bundletool.

Если ваша игра создана на Unity, поддержка наборов App Bundle с Play Asset Delivery доступна в Unity 2021.3 и более поздних версиях. Подробную информацию можно найти в документации Unity. Если вы используете более раннюю версию Unity, то можете создать набор App Bundle с помощью плагина Unity.

Использовать Gradle

  1. Обновите версию плагина Android Gradle в файле build.gradle проекта до 4.1 или более поздней (например, com.android.tools.build:gradle:4.1.0).

  2. Определите, на какие типы устройств вы хотите ориентироваться и какие форматы сжатия текстур они поддерживают. Подробнее о форматах…

  3. Создайте версии объектов для каждого формата сжатия текстур, выбранного на предыдущем шаге. Например, можно создать таблицы спрайтов с помощью такого ПО, как TexturePacker, или запустить скрипт, который преобразует необработанные объекты в объекты определенного формата (например, astc-encoder).

  4. Создайте пакеты объектов (см. Создание пакетов объектов на C++ или Java), которые содержат объекты игры и используются Play Asset Delivery. Например, можно создать по одному пакету объектов для каждого уровня или для разных частей игры.

  5. В пакетах объектов добавьте каталоги для каждого формата сжатия текстур, который вы хотите поддерживать. Добавьте поддерживаемые суффиксы к названиям каталогов текстур, которые соответствуют формату сжатия текстур, используемому для содержащихся в них файлов.

    Создайте каталог без суффикса в названии (например, common/src/main/assets/textures/). Поместите в него объекты текстур в формате по умолчанию. Этот формат по умолчанию поддерживается большинством устройств (например, ETC1 или ETC2). Если устройство не поддерживает другие указанные форматы (например, PVRTC и ASTC в таблице ниже), Google Play установит этот каталог.

    Каталог до Каталог после
    common asset pack:
    common/build.gradle
    common/src/main/assets/textures/...
    common asset pack:
    common/build.gradle
    common/src/main/assets/textures/...
    common/src/main/assets/textures#tcf_astc/...
    common/src/main/assets/textures#tcf_pvrtc/...
    level1 Пакет объектов:
    level1/build.gradle
    level1/src/main/assets/textures/...
    level1 Пакет объектов:
    level1/build.gradle
    level1/src/main/assets/textures/...
    level1/src/main/assets/textures#tcf_astc/...
    level1/src/main/assets/textures#tcf_pvrtc/...
    level2 Пакет объектов:
    level2/build.gradle
    level2/src/main/assets/textures/...
    level2 Пакет объектов:
    level2/build.gradle
    level2/src/main/assets/textures/...
    level2/src/main/assets/textures#tcf_astc/...
    level2/src/main/assets/textures#tcf_pvrtc/...
  6. Обновите файл build.gradle приложения, чтобы разделить пакеты объектов по текстурам.

    // In the app build.gradle file:
    android {
        ...
        bundle {
            texture {
                enableSplit true
            }
        }
    }
    
  7. В Android Studio выберите Build (Сборка) > Generate Signed Bundle / APK (Создать подписанный пакет/APK) или запустите задачу Gradle из командной строки, чтобы создать пакет.

Как использовать плагин Google Play для Unity

Скачайте плагин (или пакет) Unity для Play Asset Delivery, чтобы создать набор App Bundle с пакетами объектов, таргетированными на текстуры.

Подготовка объектов

Чтобы подготовить объекты текстур для создания набора App Bundle, выполните следующие действия:

  1. Упакуйте сцену и объекты в несколько наборов объектов Unity.

  2. Определите, на какие типы устройств вы хотите ориентироваться и какие форматы сжатия текстур они поддерживают. Подробнее о форматах…

  3. Измените скрипт сборки игры, чтобы он генерировал наборы AssetBundle несколько раз – по одному для каждого формата текстур, который вы хотите поддерживать. Пример скрипта:

    using Google.Android.AppBundle.Editor;
    using UnityEditor;
    
    public class MyBundleBuilder
    {
       [MenuItem("Assets/Build AssetBundles TCF variants")]
       public static void BuildAssetBundles()
       {
           // Describe the AssetBundles to be built:
           var assetBundlesToBuild = new []
           {
               new AssetBundleBuild
               {
                   assetBundleName = "level1-textures",
                   assetNames = new[] {"level1/character-textures", "level1/background-textures"}
               },
               new AssetBundleBuild
               {
                   assetBundleName = "level2-textures",
                   assetNames = new[] {"level2/character-textures", "level2/background-textures"}
               }
           };
    
           // Describe where to output the asset bundles and in which formats:
           var outputPath = "Assets/AssetBundles";
           var defaultTextureFormat = MobileTextureSubtarget.ETC2;
           var additionalTextureFormats = new[] { MobileTextureSubtarget.ASTC, MobileTextureSubtarget.PVRTC }
           var allowClearDirectory = true;
    
           // Generate asset bundles:
           AssetBundleBuilder.BuildAssetBundles(
               outputPath,
               assetBundlesToBuild,
               BuildAssetBundleOptions.UncompressedAssetBundle,
               defaultTextureFormat,
               additionalTextureFormats,
               allowClearDirectory);
    
           // While in this example we're using the UI to configure the
           // AssetBundles, you can use the value returned by BuildAssetBundles
           // to configure the asset packs, if you want to build the bundle
           // entirely using the scripting API.
       }
    }
    
  4. Убедитесь, что каждый объект текстуры выводится в каталог с правильным суффиксом в названии (например, #tcf_astc).

    Убедитесь, что в выходных данных есть каталог, в названии которого нет суффикса (например, Assets/AssetBundles/). В этом каталоге содержатся объекты текстур в формате по умолчанию. Этот формат по умолчанию должен поддерживаться большинством устройств (например, ETC2). Если устройство не поддерживает другие указанные форматы (например, ASTC в коде из предыдущего шага), Google Play установит этот каталог.

    Assets/AssetBundles.meta
    Assets/AssetBundles/AssetBundles
    Assets/AssetBundles/AssetBundles.manifest
    Assets/AssetBundles/AssetBundles.manifest.meta
    Assets/AssetBundles/AssetBundles.meta
    Assets/AssetBundles/samplescene
    Assets/AssetBundles/samplescene.manifest
    Assets/AssetBundles/samplescene.manifest.meta
    Assets/AssetBundles/samplescene.meta
    Assets/AssetBundles/texturesbundle
    Assets/AssetBundles/texturesbundle.manifest
    Assets/AssetBundles/texturesbundle.manifest.meta
    Assets/AssetBundles/texturesbundle.meta
    Assets/AssetBundles#tcf_astc.meta
    Assets/AssetBundles#tcf_astc/AssetBundles
    Assets/AssetBundles#tcf_astc/AssetBundles.manifest
    Assets/AssetBundles#tcf_astc/AssetBundles.manifest.meta
    Assets/AssetBundles#tcf_astc/AssetBundles.meta
    Assets/AssetBundles#tcf_astc/samplescene
    Assets/AssetBundles#tcf_astc/samplescene.manifest
    Assets/AssetBundles#tcf_astc/samplescene.manifest.meta
    Assets/AssetBundles#tcf_astc/samplescene.meta
    Assets/AssetBundles#tcf_astc/texturesbundle
    Assets/AssetBundles#tcf_astc/texturesbundle.manifest
    Assets/AssetBundles#tcf_astc/texturesbundle.manifest.meta
    Assets/AssetBundles#tcf_astc/texturesbundle.meta
    
  5. Выберите Google > Android > Assets Delivery.

  6. Нажмите Add Folder (Добавить папку), чтобы добавить папку, содержащую наборы объектов по умолчанию. Эти пакеты устанавливаются на устройства, которые не поддерживают другие заданные вами форматы.

    Убедитесь, что для AssetBundle задан режим доставки.

    Формат по умолчанию для доставки Unity AssetBundle

  7. Нажмите Add Folder (Добавить папку), чтобы добавить папку с наборами объектов, созданными для другого формата (например, ASTC). При необходимости повторите.

    Убедитесь, что для каждого набора AssetBundle задан режим доставки.

    Формат ASTC для доставки Unity AssetBundle

Сборка

Выберите Google > Build Android App Bundle (Google > Создать набор Android App Bundle), чтобы запустить сборку игры в Unity. Кроме того, он упаковывает AssetBundle в несколько пакетов объектов, где каждое название AssetBundle преобразуется в один пакет объектов.

Использование bundletool (для опытных пользователей)

Подробнее о bundletool рассказывается в статье Как создать набор App Bundle с помощью bundletool.

Чтобы создать набор App Bundle, выполните следующие действия:

  1. Скачайте bundletool из хранилища GitHub.

  2. Определите, на какие типы устройств вы хотите ориентироваться и какие форматы сжатия текстур они поддерживают. Подробнее о форматах…

  3. Создайте версии объектов для каждого формата сжатия текстур, выбранного на предыдущем шаге. Например, можно создать таблицы спрайтов с помощью такого ПО, как TexturePacker, или запустить скрипт, который преобразует необработанные объекты в объекты определенного формата (например, astc-encoder).

  4. Создайте пакеты объектов (см. Создание пакетов объектов на C++ или Java), которые содержат объекты игры и используются Play Asset Delivery. Например, можно создать по одному пакету объектов для каждого уровня или для разных частей игры.

  5. В разных пакетах объектов добавьте поддерживаемые суффиксы к названиям каталогов текстур, соответствующие формату сжатия текстур, который используется для файлов в каталоге.

    Создайте каталог без суффикса в названии (например, common/src/main/assets/textures/). Поместите в него объекты текстур в формате по умолчанию. Этот формат по умолчанию поддерживается большинством устройств (например, ETC1 или ETC2). Если устройство не поддерживает другие указанные форматы (например, PVRTC и ASTC в таблице ниже), Google Play установит этот каталог.

    Каталог до Каталог после
    common asset pack:
    common/build.gradle
    common/src/main/assets/textures/...
    common asset pack:
    common/build.gradle
    common/src/main/assets/textures/...
    common/src/main/assets/textures#tcf_astc/...
    common/src/main/assets/textures#tcf_pvrtc/...
    level1 Пакет объектов:
    level1/build.gradle
    level1/src/main/assets/textures/...
    level1 Пакет объектов:
    level1/build.gradle
    level1/src/main/assets/textures/...
    level1/src/main/assets/textures#tcf_astc/...
    level1/src/main/assets/textures#tcf_pvrtc/...
    level2 Пакет объектов:
    level2/build.gradle
    level2/src/main/assets/textures/...
    level2 Пакет объектов:
    level2/build.gradle
    level2/src/main/assets/textures/...
    level2/src/main/assets/textures#tcf_astc/...
    level2/src/main/assets/textures#tcf_pvrtc/...
  6. Добавьте параметр TCF в файл метаданных пакета приложения (BundleConfig.json). В поле value укажите TEXTURE_COMPRESSION_FORMAT.

    {
      ...
      "optimizations": {
        "splitsConfig": {
          "splitDimension": [
          ...
          {
             "value": "TEXTURE_COMPRESSION_FORMAT",
             "negate": false,
             "suffixStripping": {
               "enabled": true,
               "defaultSuffix": ""
              }
          }],
        }
      }
    }

    Задайте для suffixStripping.enabled значение true, чтобы удалить суффикс (например, #tcf_astc) из названий каталогов при создании пакетов объектов. Это позволяет игре считывать файлы из каталога с известным названием (например, level1/assets/textures). Некоторые игровые движки могут определять формат файла, поэтому игре не обязательно знать формат текстур, с которыми она была установлена.

    suffixStripping.defaultSuffix указывает суффикс каталога по умолчанию, когда bundletool генерирует автономный APK-файл для устройств с Android 5.0 (уровень API 21) и более ранними версиями. В примере таблицы выше на эти устройства устанавливается версия текстур по умолчанию. В большинстве случаев это ожидаемое поведение.

  7. Создайте набор App Bundle:

    bundletool build-bundle --config=BUILD_CONFIG.json \
      --modules=level1.zip,level2.zip,common.zip,base.zip --output=MY_BUNDLE.aab
    

Как проверить содержимое набора App Bundle

Если вы ещё этого не сделали, скачайте bundletool из хранилища GitHub.

Проверьте содержимое выходного набора App Bundle, создав из него APK-файлы и изучив их.

bundletool build-apks --output=APKS.apks --bundle=MY_BUNDLE.aab
zipinfo APKS.apks

Выходные данные должны быть похожи на эти:

toc.pb
splits/base-master.apk
splits/base-armeabi_v7a.apk
splits/…
asset-slices/level1-astc.apk
asset-slices/level1-other_tcf.apk
asset-slices/level1-pvrtc.apk

Эти названия указывают на то, что таргетинг TCF применяется правильно. Если вы извлечете содержимое APK-файла уровня (например, asset-slices/level1-astc.apk), то сможете убедиться, что в нем есть только один каталог с названием textures.

Тестирование набора App Bundle

Подключите устройство и установите нужные пакеты объектов.

bundletool install-apks --apks=APKS.apks

Эта команда устанавливает только те пакеты объектов, которые соответствуют спецификации устройства. К ним относятся ABI, плотность экрана, язык и наиболее подходящий формат сжатия текстур. Эта операция имитирует действия, которые Google Play выполняет для опубликованной игры.

Чтобы убедиться, что установлены правильные пакеты объектов, выполните одно из следующих действий:

  • Используйте команду bundletool extract-apks, чтобы вывести список APK, установленных на устройстве, в каталог, а затем проверьте этот каталог.

    1. Извлеките спецификацию устройства:

      bundletool get-device-spec --output=MY_DEVICE_SPEC.json
      
    2. Запустите bundletool extract-apks со следующими характеристиками устройства:

      bundletool extract-apks --apks=APKS.apks --device-spec=MY_DEVICE_SPEC.json \
          --output-dir out
      
    3. Выведите список файлов в каталоге out и убедитесь, что установлены нужные пакеты объектов. Названия пакетов объектов заканчиваются названием формата текстуры (например, level1-astc.apk).

  • Добавьте в игру инструкции для регистрации в журнале, которые выводят формат текстуры при ее загрузке.

  • Создайте тестовый набор текстур (например, замените текстуру одним ярким цветом для заданного формата). Запустите игру и убедитесь, что она работает.

Если в вашем приложении есть пакеты объектов on-demand или fast-follow, используйте решение для локального тестирования доставки объектов.

Поддерживаемые суффиксы для названий каталогов текстур

Google Play распознает следующие суффиксы в названиях каталогов текстур:

  • #tcf_astc для адаптивного масштабируемого сжатия текстур (ASTC)
  • #tcf_atc для сжатия текстур ATI (ATC)
  • #tcf_dxt1 для сжатия текстур S3 DXT1 (DXT1)
  • #tcf_latc для сжатия текстур Luminance-Alpha (LATC)
  • #tcf_paletted для сжатия текстур с палитрой;
  • #tcf_pvrtc для сжатия текстур PowerVR (PVRTC)
  • #tcf_etc1 для сжатия текстур Ericsson (ETC1)
  • #tcf_etc2 для Ericsson texture compression 2 (ETC2)
  • #tcf_s3tc для сжатия текстур S3 (S3TC)
  • #tcf_3dc для сжатия текстур ATI 3Dc (3Dc);

Правила показа в Google Play

Google Play проверяет строки расширения OpenGL и версию OpenGL, поддерживаемую устройством. Google Play использует эту информацию, чтобы определить, какой формат текстур из набора Android App Bundle подходит для устройства.

Google Play доставляет первый формат, поддерживаемый устройством, в порядке, указанном в таблице ниже.

Если устройство не поддерживает ни один из форматов текстур, включенных в набор App Bundle, Google Play доставляет текстуры в формате по умолчанию. Если вы не настраиваете таргетинг на определенные устройства, в качестве формата по умолчанию лучше выбрать ETC1 или ETC2. Информацию о том, как упаковать объекты в формате по умолчанию, можно найти в статьях Как использовать bundletool и Как использовать плагин Google Play для Unity.

Если объекты не упакованы в формат по умолчанию, Google Play помечает приложение как недоступное для устройства. В этом случае пользователи не смогут скачать приложение.

Формат (обозначается как tcf_xxxx) Поддерживается на устройствах со строкой расширения OpenGL.
astc GL_KHR_texture_compression_astc_ldr
pvrtc GL_IMG_texture_compression_pvrtc
S3TC GL_EXT_texture_compression_s3tc
dxt1 GL_EXT_texture_compression_dxt1
latc GL_EXT_texture_compression_latc
atc GL_AMD_compressed_ATC_texture
3dc GL_AMD_compressed_3DC_texture
etc2 Неприменимо. Устройство должно поддерживать OpenGL ES версии 3.0 или более поздней.
etc1 GL_OES_compressed_ETC1_RGB8_texture
палитра GL_OES_compressed_paletted_texture