Schneller start mit dem beispielprojekt für die wechat mini program mega-erweiterung

Dieser artikel erklärt, wie sie schnell das beispielprojekt für die mega-erweiterung von wechat mini program ausführen. Sie lernen, wie sie:

Die entwicklungsplattform für das beispielprojekt einrichten und konfigurieren.
Beispielteile ausführen: nutzung der mega-cloud-basierten lokalisierung.

Voraussetzungen

Konsultieren sie die dokumentation ist mein lokalisierungsdienst bereits nutzbar?, um sicherzustellen, dass der lokalisierungsdienst korrekt erstellt und der mega-block hinzugefügt wurde.

Bestätigen sie, dass das mini-programm einem unternehmen zugeordnet ist

Wichtig

Die mega-erweiterung für mini-programme unterstützt nur mini-programme mit unternehmenszuordnung. Mini-programme mit privater zuordnung können die mega-mini-programm-erweiterung nicht nutzen.

Stellen sie sicher, dass unter mini-programm-backend unter einstellungen > grundlegende informationen > zuordnungsinformationen die angabe unternehmen oder einzelunternehmen angezeigt wird.

Da mega-funktionen als mini-programm-erweiterungen bereitgestellt werden, benötigen sie eine eigene mini-programm-instanz mit unternehmenszuordnung als host-umgebung.

Selbst um unser bereitgestelltes beispielprojekt auszuführen, müssen sie ihre eigene wechat mini-programm-app-id konfigurieren, um es im entwicklungswerkzeug zu debuggen und in der vorschau zu betrachten.

Beispielprojekt herunterladen

Navigieren sie zur seite zum herunterladen von entwicklungswerkzeugen.
Bestätigen sie die easyar-datenschutzrichtlinie und klicken sie auf herunterladen.
Entpacken sie das .zip-archiv lokal nach abschluss des downloads.

Beispielprojekt konfigurieren

Melden Sie sich im Entwicklertool für WeChat Mini Programs an.
Importieren Sie das Beispielprojekt mit dem Entwicklertool für WeChat Mini Programs.
- Öffnen Sie das Entwicklertool und klicken Sie auf die Importieren-Schaltfläche. Wählen Sie das lokale entpackte Verzeichnis aus.
- Stellen Sie sicher, dass die AppID mit der bei der Beantragung der Mega-Lizenz angegebenen AppID übereinstimmt. Der Entwicklungsmodus muss Mini Program sein. Klicken Sie auf Erstellen.
Anmerkung

Unterschiedliche AppIDs führen zu einem fehlgeschlagenen Lizenzprüfung
Konfigurieren Sie die Mega-Lizenz und Cloud-Dienste

Öffnen Sie die Datei miniprogram/components/sample-data/easyar-settings.ts. Tragen Sie die entsprechenden Felder in dieser Datei basierend auf den Informationen aus den Vorbereitungen ein:
- Mega-Lizenz
```
/** Ihre Mega-Lizenz für Mini Programs */
export const EasyARLicenseKey: string = "";
```
So erhalten Sie eine Mega-Lizenz für WeChat Mini Programs

Wählen Sie im EasyAR Developer Center Mega WeChat Mini Program aus.

Die Liste sollte die zu verwendende Mega WeChat Mini Program-Lizenz enthalten. (Falls keine verfügbare Lizenz vorhanden ist, prüfen Sie, ob Ihr Konto dasselbe ist wie das für die Erstellung der Mega-Positionierungsdatenbank verwendete Konto.)

Klicken Sie auf den Mini Program-Namen, um die Mega-Lizenz für dieses Mini Program zu erhalten (rechts zum Kopieren klicken und dann in die Datei easyar-settings.ts als Wert für EasyARLicenseKey einfügen). Stellen Sie sicher, dass die zugehörige AppID genau mit Ihrer WeChat Mini Program-AppID übereinstimmt.
- Cloud-Dienst API Key und Secret
```
/** Ihre Cloud-Dienst API Key und Secret */
export const EasyARAPIKey: string = "";
export const EasyARAPISecret: string = "";
```
So erhalten Sie Cloud-Dienst API Key und Secret

Wählen Sie im EasyAR Developer Center Cloud Service API KEY aus.

Falls Sie bereits zuvor einen Cloud-Dienst API Key und Secret erstellt haben, können Sie diese hier nacheinander rechts kopieren und in die Datei easyar-settings.ts als Werte für EasyARAPIKey bzw. EasyARAPISecret einfügen.

Falls Sie noch keinen API Key und Secret erstellt haben, gehen Sie folgendermaßen vor:

Wählen Sie im EasyAR Developer Center Cloud Service API KEY > API KEY erstellen.

Geben Sie einen Anwendungsnamen ein, wählen Sie die benötigten Cloud-Dienste aus: Mega Block und/oder Mega Landmark, und klicken Sie auf Bestätigen.
- Cloud-Dienst ServerAddress und AppID:
```
/** ServerAddress und AppID Ihrer Mega-Cloud-Positionierungsdatenbank */
export const MegaTrackerServerAddress: string = "";
export const MegaTrackerAppID: string = "";
```
So erhalten Sie ServerAddress und AppID der Mega-Cloud-Positionierungsdatenbank

Wählen Sie im EasyAR Developer Center Block Cloud Positioning und dann Ihre Mega Cloud Positioning Service Group aus.

Wählen Sie Ihre Mega-Cloud-Positionierungsdatenbank aus:

Klicken Sie auf Schlüssel. Kopieren Sie unten nacheinander die AppID und Server Address der Positionierungsdatenbank (rechts zum Kopieren klicken und dann in die Datei easyar-settings.ts als Werte für MegaTrackerAppID bzw. MegaTrackerServerAddress einfügen).

Beispiel auf dem gerät ausführen

Klicken Sie auf die Schaltfläche "Vorschau auf echtem Gerät" in der oberen Leiste des Entwicklungswerkzeugs für Mini-Programme und laden Sie es auf Ihr Entwicklungs-Handy, indem Sie den QR-Code scannen.

Vorsicht

Komponenten mit AR-Funktion des xr-frame können nicht direkt im Entwicklungswerkzeug simuliert werden.

Anmerkung

Wenn Sie das Beispielprojekt zum ersten Mal in den WeChat-Entwicklertools ausführen und noch keine Plugin-Berechtigungen haben, wird normalerweise ein Hinweis angezeigt. Sie können die automatische Autorisierung nutzen oder den Plugin-Onboarding-Prozess befolgen.
Klicken Sie auf EasyAR Mega Samples, um die AR-Szene des Beispielprojekts aufzurufen.

Anmerkung

Falls der Zugriff fehlschlägt, unterstützt Ihr Gerät möglicherweise die VisionKit-Komponente nicht. Details siehe Geräteeinschränkungen.
Der Hinweis EasyAR Session is initializing zeigt, dass die WeChat-Ebenenerkennung initialisiert wird.

Tipp

Testen Sie in gut beleuchteter Umgebung und vermeiden Sie einfarbige Wände/Böden.

Bewegen Sie das Gerät gleichmäßig über Oberflächen, um den Prozess zu beschleunigen.
Nach Abschluss halten Sie das Handy senkrecht. Bei erfolgreicher Positionierung erscheint Found im Debug-Modus und der Statusindikator (unten rechts) wechselt von Weiß zu Grün.