Laden

Legen Sie fest, worauf Ihre Besucher warten, wenn sich Ihr Projekt öffnet, und richten Sie den Startbildschirm ein.

Besucher warten nur einmal, ganz am Anfang. Was Sie dann laden, entscheidet am stärksten darüber, wie schnell sich Ihr Projekt beim Öffnen anfühlt.

Wie Assets ankommen

Ein Asset kommt auf eine von drei Arten an:

• Vorgeladen: Es wird geholt, bevor sich die Szene öffnet. Der Startbildschirm wartet darauf. Nutzen Sie das für alles, was in den ersten Sekunden zu sehen ist.
• Verzögert: Die Szene öffnet sich ohne das Asset, und es erscheint, sobald es angekommen ist. Nutzen Sie das für Inhalte, die erst später im Projekt vorkommen.
• Gestreamt: Es wird direkt aus dem Netz abgespielt und nie ganz heruntergeladen. Nutzen Sie das für Video und Audio.

Nur Video und Audio können streamen

Nur Video und Audio können abspielen, bevor sie vollständig angekommen sind. Ein Modell, eine Textur oder eine Schrift muss vollständig da sein, bevor sie sich nutzen lässt. Sie zu verzögern heißt nur: Die Szene öffnet sich, ohne zu warten, und das Asset erscheint, sobald es bereit ist.

Projektstandard und Asset-Einstellungen

Der Schalter Projekt vorladen in den Projekteinstellungen ist der Standard für alle Assets. Jedes Asset kann ihn überschreiben. Fahren Sie in Projekt-Assets mit der Maus über eine Datei: In ihrer Zeile erscheinen zwei Schaltflächen.

• Immer vorladen: Die Szene wartet immer auf diese Datei, egal was im Projekt eingestellt ist.
• Immer streamen: Die Szene wartet nie auf sie. Video und Audio werden gestreamt, andere Dateien werden verzögert.
• Ist keine der beiden aktiv, folgt die Datei Projekt vorladen.

Klicken Sie erneut auf eine Schaltfläche, um sie auszuschalten. Solange eine davon aktiv ist, bleiben die Schaltflächen in der Zeile sichtbar.

Bei neuen Video- und Audio-Assets ist Immer streamen von Anfang an aktiv, denn auf ein ganzes Video zu warten, bevor sich die Szene öffnet, bringt nichts. Alle anderen neuen Assets folgen der Projekteinstellung.

Stellen Sie es an der Datei ein

Die Ladeeinstellung gehört zum Asset, nicht zu den Objekten, die es nutzen. Zwei Objekte, die sich eine Datei teilen, laden sie deshalb immer gleich.

Ein guter Ausgangspunkt

Für die meisten Projekte:

1. Stellen Sie die Modelle und Texturen der ersten Szene auf Vorladen, dazu jede Schrift, die sofort zu sehen ist.
2. Stellen Sie alles, was zu späteren Szenen gehört, auf Verzögert.
3. Lassen Sie alle Videos und Audiodateien streamen. Das ist bereits der Standard.

Ihre Besucher warten einmal kurz, und danach hält das Projekt nie wieder zum Laden an.

Startbildschirm

Bevor Ihre Szene erscheint, können Besucher zwei Bildschirme sehen:

• einen, den sie antippen, um zu beginnen;
• einen, der sich füllt, während die Assets ankommen.

Beide richten Sie in den Projekteinstellungen ein: Hintergrund, Logo, Start-Schaltfläche und ihre Beschriftung, die Onboarding-Hinweise und den Stil der Ladeanzeige.

Behalten Sie die Start-Schaltfläche, wenn Ihr Projekt Ton hat

Browser spielen keinen Ton ab, bevor der Besucher mit der Seite interagiert hat. Bei AR-Berechtigungen ist es genauso: Sie werden nur erteilt, wenn sie direkt beim Antippen angefragt werden. Ohne Schaltfläche zum Drücken spielt Ihr erster Ton nicht, und die Kamera-Abfrage erscheint vielleicht nie.

Ein eigener Startbildschirm

Der eingebaute Startbildschirm ist eine Vorlage. Für einen eigenen schreiben Sie ein Start-Skript. Es steuert beide Bildschirme. Außerdem legt es sein eigenes Einstellungs-Panel fest, sodass die Leute, die es nutzen, Felder ausfüllen, statt Code zu bearbeiten.

init((ctx: PreloadContext) => {
  // Einstellungs-Panel festlegen. Läuft, bevor etwas gezeichnet wird: nur festlegen, nie zeichnen.
  ctx.on('describe', (p) => {
    p.section('look', { en: 'Look' });
    p.color('tint', { label: { en: 'Background' }, default: '#101014', section: 'look' });
    p.text('caption', { label: { en: 'Caption' }, default: '', localized: true, section: 'look' });
    p.boolean('hideWhenReady', { label: { en: 'Hide when ready' }, default: true });
  });

  ctx.on('launch', () => {
    /* den Bildschirm zeigen, den man zum Starten antippt */
  });

  ctx.on('loading', () => {
    /* den Bildschirm zeigen, der sich füllt */
  });

  ctx.on('progress', ({ loaded, total, percent }) => {
    /* den eigenen Fortschrittsbalken aktualisieren */
  });

  ctx.on('ready', () => {
    /* alles ist angekommen */
  });
});

Ereignis	Wann es auslöst
describe	das Einstellungs-Panel wird aufgebaut, zur Laufzeit und im Editor
start	die Laufzeitumgebung startet
launch	es ist Zeit, den Bildschirm zum Antippen zu zeigen
loading	es ist Zeit, den Bildschirm zu zeigen, der sich füllt
progress	Assets kommen an: loaded, total, percent
ready	alles Nötige ist angekommen
error	etwas ist schiefgegangen

Einstellungen lassen sich lokalisieren. So funktioniert ein Start-Skript in jeder Sprache, die Ihr Projekt unterstützt.

Die Szene direkt beim Antippen starten

Was Ihre Szene startet, muss direkt im Klick-Handler der Schaltfläche aufgerufen werden. Berechtigungen für Geräteausrichtung und Kamera werden nur erteilt, wenn sie direkt beim Antippen angefragt werden. Starten Sie die Szene erst im nächsten Frame, sind sie verloren.

Ein fehlerhaftes Start-Skript sperrt niemanden aus

Wirft Ihr Start-Skript einen Fehler, wird stattdessen der eingebaute Bildschirm gezeigt.

Was nicht geladen werden muss

• Eine Szene ohne Physik wartet nicht auf sie.
• Instanzierte Kopien und Partikel machen den Download kaum größer, egal wie viele es sind.

Besucher warten nie auf Dinge, die sie nicht brauchen. Mehr dazu unter Warum AR Clip.

---

Weiter: Gemeinsame Pakete — die Code-Pakete, die Sie importieren können.