Zielbildverwaltung
Zielbilder (Targets) können auf zwei Arten verwaltet werden:
- Visuelle Verwaltung: Manuelle Pflege über das EasyAR Entwicklungszentrum.
- API-Automatisierungsverwaltung: Integration in eigene Geschäftssysteme oder Verwaltungs-Backends durch Aufruf von Web Service REST API.
Wichtig
Im Cloud-Erkennungsdienst sind Zielbildverwaltung und Bilderkennung unterschiedliche Anforderungen, die API hat zwei verschiedene Cloud-URL-Endpunkte.
Auswahl der Rechenzentrumsregion
Die Rechenzentrumsregion, in der die Bilddatenbank läuft, unterstützt folgende Auswahlmöglichkeiten:
- China-Shanghai
- USA-Silicon Valley
Methode 1: Zielbilder im EasyAR Entwicklungszentrum verwalten
Geeignet für kleine Tests oder schnelles manuelles Hochladen. Vorgehensweise:
- Melden Sie sich im EasyAR Entwicklungszentrum an und gehen Sie zu Cloud-Erkennungsverwaltung.
- Wählen Sie die Zielregion. Falls noch keine Bilddatenbank erstellt wurde, erstellen und aktivieren Sie bitte zuerst eine Cloud-Erkennungs-Bilddatenbank.
- Klicken Sie in der Bilddatenbankliste auf Verwalten, um zur Zielbild-Wartungsoberfläche zu gelangen und Bilder hochzuladen, zu ändern oder zu löschen.
Methode 2: Automatisierte Verwaltung mit REST API
Für Anwendungen, die viele Zielbilder verarbeiten müssen, wird die Verwendung der Web Service REST API empfohlen, um Automatisierungsprozesse in Ihrer Anwendung oder Ihrem Verwaltungs-Backend zu ermöglichen.
Vorbereitungsliste
Folgendes ist vorzubereiten. Bevor Sie mit der Verwaltung von Zielbildern beginnen, benötigen Sie eine neue Cloud-Erkennungs-Datenbankinstanz (Cloud Database).
- CRS AppId
- API-Schlüssel / API-Geheimnis oder Token
- Cloud-URL
- Server-URL: URL-Adresse für die Zielbildverwaltung, https verwendet Port 443
- Client-URL: URL-Adresse für den Bilderkennungsdienst, https verwendet Port 8443
Wichtig
Hinweis zur Portunterscheidung: Der API-Endpunkt für die Zielverwaltung (443) und der API-Endpunkt für die Cloud-Erkennung (8443), der von Mobilgeräten/Unity aufgerufen wird, sind zwei verschiedene Kanäle. Bitte achten Sie bei der Konfiguration auf die Unterscheidung.
So erhalten Sie die Listenelemente
- Anzeige der CRS AppId:
Entwicklungszentrum -> Cloud-Erkennungsverwaltung -> Bilddatenbank auswählen -> Verwalten -> Schlüssel
- Anzeige von API-Schlüssel / API-Geheimnis:
Entwicklungszentrum -> Cloud-Dienst-API-Schlüssel -> Kopieren
Falls Sie noch keinen API-Schlüssel haben, erstellen Sie einen API-Schlüssel und wählen Sie dabei unbedingt die Berechtigung Cloud-Erkennung (CRS) aus. Weitere Informationen zu API-Schlüsseln und Berechtigungssteuerung finden Sie im Thema Einführung in API-Schlüssel
- Anzeige des Tokens:
Entwicklungszentrum -> Cloud-Dienst-API-Schlüssel -> Verwalten -> Gültigkeitsdauer auswählen -> Token generieren -> Kopieren
Wenn Sie die Gültigkeitsdauer des Tokens anpassen möchten, können Sie sich an der Methode UAC API – Token erstellen orientieren und das ursprüngliche APIKey und APISecret verwenden, um ein Token zu erstellen
- Anzeige der Cloud-URL:
Für die Zielbildverwaltung in der Bilddatenbank wird die Server-URL mit Port 443 verwendet, Server-URL
Entwicklungszentrum -> Cloud-Erkennungsverwaltung -> Bilddatenbank auswählen -> Verwalten -> Schlüssel -> Bilddatenbankverwaltung
Integrationsleitfaden für mehrere Endgeräte
In realen Workflows ist die Zielbildverwaltung typischerweise in den Geschäftsservern des Entwicklers, auf Mobilgeräten oder in Unity integriert:
Geschäftsplattform: Bietet Beispielcode für gängige Server-Entwicklungssprachen (Curl/Java/NodeJS/PHP) zum Aufruf der API, um Entwicklern das automatische Hochladen von Zielbildern und die Aktualisierung von Metadaten (Meta) zu ermöglichen.
Mobilgeräte (Unity/Mobile): Bietet Beispielcode für die Zielbildverwaltung basierend auf Unity, Entwickler implementieren ihre eigene Methode zum Fotografieren und Hochladen von Zielbildern.
Beispielcode ausführen
Die folgende Abbildung zeigt die Verwendung eines Java-Beispielcodes. Tragen Sie im Beispielcode Ihre eigenen vorbereiteten Listenelemente ein und führen Sie dann Main aus.
Verwandte Themen:
Nächstes Thema:
Anmerkung
In realen Workflows wird empfohlen, beim Erstellen von Zielbildern Best Practices zu befolgen. Es wird empfohlen, dies sorgfältig zu lesen.