Adressierbare Szenen einschließen

Auf dieser Seite wird beschrieben, wie Sie den Android Performance Tuner konfigurieren, um Addressables-Szenen in Unity einzubeziehen.

Addressables ermöglichen es Entwicklern, Inhalte zur Laufzeit dynamisch zu laden. Dies kann auch Szenen umfassen, die beim Erstellen der APK-Datei nicht in den Build-Einstellungen von Unity vorhanden sind. Vor dem Android Performance Tuner 1.5.1 wurden diese Szenen vom Android Performance Tuner nicht erkannt und konnten in der Play Console nicht überprü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

Adressierbare Szenen hinzufügen

So sorgen Sie dafür, dass der Android Performance Tuner Ihre Addressables-Szenen erkennt:

1. Wenn Sie Ihre App testen möchten, rufen Sie Fenster > Android Performance Tuner > Einrichtung auf und öffnen Sie den Tab Addressables Settings (Einstellungen für Addressables).

   Abbildung 1: Einstellungsfenster für „Addressables“.

2. Klicken Sie auf die Schaltfläche Adressierbare Szenen aktualisieren.

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

Abbildung 2: Adressierbare Szenen vom Android Performance Tuner aufgelistet.

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

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

2. Geben Sie den Pfad zu Ihrem benutzerdefinierten Einstellungsobjekt einschließlich des Dateinamens in das Feld Objektpfad für Addressables-Einstellungen ein.

Wir empfehlen, die „Addressables“-Szenen zu aktualisieren, wenn das Szenenlayout halbfinal ist, um Probleme mit der Abwärtskompatibilität zu vermeiden.

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

Addressables-Szenen zurücksetzen

Sie können Ihre Addressables-Szenen zurücksetzen. Klicken Sie dazu auf dem Tab Addressables Settings (Einstellungen für Addressables) auf Reset Addressables Scenes (Adressierbare Szenen zurücksetzen). Dies beeinträchtigt jedoch die Kompatibilität mit der derzeit veröffentlichten Version der App.

Wenn das SetupConfig-Objekt dynamisch in der App aktualisiert wird, ohne einen neuen Release zu veröffentlichen, kommt es zu Fehlern in der Play Console, da die Szenenwert-Beziehungen nicht beibehalten werden.

„Addressables“-Szenen in Anmerkungen festlegen

Wenn Sie Standardanmerkungen verwenden, legt der Android Performance Tuner automatisch die richtige Szene fest. Wenn Sie benutzerdefinierte Annotationen verwenden, rufen Sie ConvertAddressableScenePathToAPTSceneIndex() auf:

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