Uwzględnij sceny z adresami

Na tej stronie opisujemy, jak skonfigurować narzędzie Android Performance Tuner, aby uwzględniało sceny Addressables w Unity.

Adresowalne zasoby umożliwiają programistom dynamiczne wczytywanie treści w czasie działania aplikacji. Mogą one obejmować sceny, które nie są obecne w ustawieniach kompilacji Unity podczas tworzenia pliku APK. Przed wersją 1.5.1 narzędzie Android Performance Tuner nie rozpoznawało tych scen i nie można było ich sprawdzić w Konsoli Play.

Wymagania

Obsługa scen z obiektami adresowalnymi wymaga spełnienia tych warunków:

• Android Performance Tuner w wersji 1.5.1 lub nowszej
• Unity w wersji 2019.3 lub nowszej
• Pakiet Addressables w wersji 1.19.4 lub nowszej

Dodawanie scen z Addressables

Aby narzędzie Android Performance Tuner rozpoznawało sceny Addressables:

1. Gdy będziesz gotowy(-a) do przetestowania aplikacji, wybierz Window > Android Performance Tuner > Setup i otwórz kartę Addressables Settings.

   Rysunek 1. Okno ustawień Addressables.

2. Kliknij przycisk Update Addressables Scenes (Aktualizuj sceny z zasobami adresowalnymi).

Domyślnie wszystkie sceny zawarte w AddressableAssetSettingsDefaultObject są uwzględniane w Android Performance Tuner. W oknie wyświetli się lista wszystkich znalezionych scen wraz z ich wartościami zapisanymi w pliku proto.

Rysunek 2. Sceny z adresami wymienione przez narzędzie Android Performance Tuner.

Aby zmienić obiekt ustawień adresowalnych, z którego pobierane są sceny:

1. Otwórz folder Assets/AndroidPerformanceTuner_gen/Runtime/Resources i w inspektorze otwórz obiekt skryptowy SetupConfig.

2. W polu Addressables Settings Object Path (Ścieżka do obiektu ustawień Addressables) wstaw ścieżkę do niestandardowego obiektu ustawień, w tym nazwę pliku.

Aby uniknąć problemów ze zgodnością z wcześniejszymi wersjami, zalecamy aktualizowanie scen Addressables, gdy układ scen jest w połowie gotowy.

Android Performance Tuner zbiera dane tylko o scenach, które były obecne w pliku APK przesłanym do Konsoli Play.

Resetowanie scen z reklamami z możliwością kierowania

Sceny Addressables możesz zresetować, klikając Reset Addressables Scenes (Zresetuj sceny Addressables) na karcie Addressables Settings (Ustawienia Addressables). Powoduje to jednak utratę zgodności z obecnie opublikowaną wersją aplikacji.

Dynamiczne aktualizowanie obiektu SetupConfig w aplikacji bez publikowania nowej wersji spowoduje błędy w Konsoli Play, ponieważ relacje między sceną a wartością nie zostaną zachowane.

Ustawianie scen Addressables w adnotacjach

Jeśli używasz domyślnych adnotacji, Android Performance Tuner automatycznie ustawi prawidłową scenę. Jeśli używasz niestandardowych adnotacji, wywołaj funkcję ConvertAddressableScenePathToAPTSceneIndex():

tuner.SetCurrentAnnotation(new Annotation
{
    Scene = (Scene) tuner.ConvertAddressableScenePathToAPTSceneIndex(scenePath),
    Difficulty = Difficulty.Medium
});