Adressierbare Szenen einschließen

Auf dieser Seite wird beschrieben, wie Sie den Android Performance Tuner so konfigurieren, dass Addressables-Szenen in Unity berücksichtigt werden.

Mit Addressables können Entwickler Inhalte zur Laufzeit dynamisch laden. Dazu können Szenen gehören, die in den Unity-Build-Einstellungen nicht vorhanden sind, wenn die APK-Datei erstellt wird. Vor Android Performance Tuner 1.5.1 wurden diese Szenen nicht vom Android Performance Tuner erkannt und konnten nicht in der Play Console geprüft werden.

Voraussetzungen

Für die Unterstützung von Addressables-Szenen gelten die folgenden Anforderungen:

• Android Performance Tuner 1.5.1 oder höher
• Unity 2019.3 oder höher
• Addressables-Paket 1.19.4 oder höher

Addressables-Szenen hinzufügen

Damit der Android Performance Tuner Ihre Addressables-Szenen erkennt, gehen Sie so vor:

1. Wenn Sie Ihre App testen möchten, rufen Sie Window > Android Performance Tuner > Setup auf und öffnen Sie den Tab Addressables Settings.

   Abbildung 1. Fenster „Addressables-Einstellungen“.

2. Klicken Sie auf die Schaltfläche Update Addressables Scenes (Addressables-Szenen aktualisieren).

Standardmäßig sind alle Szenen, die in der AddressableAssetSettingsDefaultObject enthalten sind, im Android Performance Tuner enthalten. Im Fenster wird nun eine Liste aller gefundenen Szenen zusammen mit ihrem in der Proto-Datei gespeicherten Wert angezeigt.

Abbildung 2. Addressables-Szenen, die vom Android Performance Tuner aufgeführt werden.

So ändern Sie das Addressable Settings Object, aus dem Szenen abgerufen werden:

1. Rufen Sie den Ordner Assets/AndroidPerformanceTuner_gen/Runtime/Resources auf und öffnen Sie das skriptfähige Objekt SetupConfig im Inspector.

2. Geben Sie im Feld Addressables Settings Object Path den Pfad zu Ihrem benutzerdefinierten Einstellungen-Objekt ein, einschließlich des Dateinamens.

Wir empfehlen, die Addressables-Szenen zu aktualisieren, wenn das Layout Ihrer Szenen fast fertig ist, um Probleme mit der Abwärtskompatibilität zu vermeiden.

Android Performance Tuner erfasst nur Daten für Szenen, die in der APK-Datei enthalten waren, die in die Play Console hochgeladen wurde.

Addressables-Szenen zurücksetzen

Sie können Ihre Addressables-Szenen zurücksetzen, indem Sie auf dem Tab Addressables Settings (Addressables-Einstellungen) auf Reset Addressables Scenes (Addressables-Szenen zurücksetzen) klicken. Dadurch wird jedoch die Kompatibilität mit der aktuell veröffentlichten Version der App beeinträchtigt.

Wenn Sie das SetupConfig-Objekt in der App dynamisch aktualisieren, ohne eine neue Version zu veröffentlichen, führt dies zu Fehlern in der Play Console, da die Beziehungen zwischen Szenen und Werten nicht beibehalten werden.

Addressables-Szenen in Anmerkungen festlegen

Wenn Sie Standardanmerkungen verwenden, wird die richtige Szene automatisch vom Android Performance Tuner festgelegt. Wenn Sie benutzerdefinierte Anmerkungen verwenden, rufen Sie ConvertAddressableScenePathToAPTSceneIndex() auf:

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