Table of Contents

Gestion des images cibles

Les images cibles (Targets) peuvent être gérées de deux manières :

  • Gestion visuelle : Connectez-vous au centre de développement EasyAR pour une maintenance manuelle.
  • Gestion automatisée par API : Intégrez dans votre propre système métier ou interface d'administration en appelant Web Service REST API.
Important

Dans le service de reconnaissance cloud, la gestion des images cibles et la reconnaissance d'images sont deux besoins distincts, l'API correspondant à deux entrées Cloud URL différentes.

Choix de la région du centre de données

Les centres de données prenant en charge l'exécution des exemples de galerie incluent les régions suivantes :

  • Chine-Shanghai
  • États-Unis-Silicon Valley

Méthode 1 : Gérer les images cibles dans le centre de développement EasyAR

Convient pour des tests à petite échelle ou des téléchargements manuels rapides. Étapes :

  1. Connectez-vous au centre de développement EasyAR, accédez à Gestion de la reconnaissance cloud.
  2. Sélectionnez la région cible. Si aucune galerie n'a été créée, créez-en une nouvelle et activez la galerie de reconnaissance cloud.
  3. Cliquez sur Gérer dans la liste des galeries pour accéder à l'interface de maintenance des images cibles et effectuer des téléchargements, modifications ou suppressions.

create-web

Méthode 2 : Utiliser REST API pour une gestion automatisée

Pour les applications nécessitant de traiter un grand nombre d'images cibles, il est recommandé d'utiliser Web Service REST API afin d'automatiser les flux dans votre application ou interface d'administration.

Liste de préparation

Voici les éléments à préparer. Avant de commencer à gérer les images cibles, vous devez préparer une nouvelle instance de base de données cloud (Cloud Database)

  • CRS AppId
  • Clé API / Secret API ou Token
  • Cloud URL
    • URL côté serveur : URL de gestion des images cibles, port 443 pour https
    • URL côté client : URL du service de reconnaissance d'images, port 8443 pour https
Important

Explication de la distinction des ports : L'entrée API de gestion des cibles (443) et l'entrée API de reconnaissance cloud appelée par mobile/Unity (8443) sont deux canaux différents, veuillez absolument les distinguer lors de la configuration.

Comment obtenir les éléments de la liste

  • Méthode de consultation du CRS AppId :
    Centre de développement -> Gestion de la reconnaissance cloud -> Sélectionner une galerie -> Gérer -> Clés

m1-appid

  • Méthode de consultation de la Clé API / Secret API :
    Centre de développement -> APIKey des services cloud -> Copier

m1-apikey

    Si vous n'avez pas encore de Clé API, créez-en une en cochant impérativement la permission reconnaissance cloud (CRS). Pour en savoir plus sur API Key et le contrôle des permissions, consultez le sujet Introduction à API Key

m1-apikey-cr

  • Méthode de consultation du Token :
    Centre de développement -> APIKey des services cloud -> Gérer -> Sélectionner la durée de validité -> Générer Token -> Copier

m1-token

    Si vous devez personnaliser la durée de validité du Token, vous pouvez vous référer à la méthode UAC API —— Créer un Token, en utilisant la clé API originale et le Secret API pour créer le Token

  • Méthode de consultation de Cloud URL :
    La gestion des images cibles dans la galerie utilise l'URL côté serveur port 443, Server-end URL
    Centre de développement -> Gestion de la reconnaissance cloud -> Sélectionner une galerie -> Gérer -> Clés -> Gestion de la galerie

m1-server-url

Guide d'intégration multi-plateformes

Dans les flux de travail réels, la gestion des images cibles est généralement intégrée dans le serveur métier du développeur, ou dans le mobile ou Unity :

  • Plateforme de services métier : Fournit des exemples de code d'appel API dans des langages de développement serveur courants (Curl/Java/NodeJS/PHP), aidant les développeurs à automatiser le téléchargement des images cibles et la mise à jour des métadonnées (Meta).

  • Mobile (Unity/Mobile) : Fournit un exemple de code de gestion des images cibles basé sur Unity, permettant aux développeurs d'implémenter leur propre méthode de capture photo et téléchargement de l'image cible.

Exécuter l'exemple de code

L'illustration ci-dessous montre l'utilisation d'un exemple de code Java. Dans l'exemple de code, remplissez les éléments de votre liste de préparation, puis exécutez Main

m1-java

Sujets connexes :

Prochain sujet :

Note

Dans les flux de travail réels, il est recommandé de suivre les meilleures pratiques lors de la création d'images cibles, veuillez lire attentivement.