Table of Contents

Erstellen neuer Bildziele | POST /targets

Laden Sie Erkennungsbilder hoch, um neue Bildziele zu erstellen

Aktion

POST /targets

Authentifizierung

Erforderlich

Http-Header

Content-Type=application/json

HTTP-Header: Authorization (bei Authentifizierung mit API-Key-Token)

Anfrageparameter

Feld Typ Erforderlich Beschreibung
image String(base64) Ja Base64-kodierter String des Bildinhalts, unterstützt JPG- und PNG-Formate. Maximale Bildgröße 2MB.
active String Nein "1" aktiviert das Ziel, "0" deaktiviert es. Standardwert ist "1".
name String Ja Zielname, nur englische Buchstaben, Satzzeichen und Zahlen erlaubt. Länge: min. 1 Zeichen, max. 64 Zeichen.
size String (Float) Ja Breite des Erkennungsbildes (in cm). Die Höhe wird automatisch berechnet. Die Größe entspricht der virtuellen Inhaltsgröße. Standard 20.
meta String Ja Dient zur Speicherung von AR-Inhaltsinformationen, Textstring-Format. Standard: "". Max. 2MB. Z.B.: JSON-Informationen des Objekts, Base64-kodierte Bilder oder Cloud-Speicher-URLs.
type String Ja Muss exakt als "ImageTarget" festgelegt werden (Groß-/Kleinschreibung beachten).
allowSimilar String Nein Erlaubt das Hinzufügen bei ähnlichen Bildern. Standard 0. Ähnliche Bilder können die Erkennung beeinträchtigen.

[!HINWEIS]

  • image: Maximal 2MB
  • meta: Maximal 2MB

Anfragebeispiel

    POST /targets/ HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
        "active":"1",
        "name":"easyar",
        "size":"5",
        "meta":"496fbbabc2b38ecs3460a...",
        "type":"ImageTarget",
        "timestamp": 1514736000000,
        "appKey": "test_app_key",
        "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
    }

Antwortbeispiel

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "statusCode": 0,
        "result": {
          "target": {
            "targetId":"e61db301-e80f-4025-b822-9a00eb48d8d2",
            "trackingImage":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM..."，
            "name": "easyar",
            "size": "5",
            "meta": "496fbbabc2b38ecs3460a...",
            "type": "ImageTarget",
            "modified":1514735000000
            "active":"1"，
            "trackableRate": 0,
            "detectableRate": 0,
            "detectableDistinctiveness"：0,
            "detectableFeatureCount", 0,
            "trackableDistinctiveness", 0,
            "trackableFeatureCount", 0,
            "trackableFeatureDistribution", 0,
            "trackablePatchContrast", 0,
            "trackablePatchAmbiguity", 0
          }
        },
        "timestamp": 1514736000000
    }

Antwortfelder

Feld Beschreibung
statusCode Statuscode 0 = erfolgreich. Weitere Codes unter Statuscodes
result Fehlermeldung oder Zielbildinformationen
timestamp Serverzeitpunkt der Antwort (Unix-Zeitstempel in Millisekunden)
result.targetId Eindeutige ID des Zielbildes
result.trackingImage Base64-kodierter String des Tracking-Bildes
result.name Zielname
result.size Breite des Erkennungsbildes (in cm). Höhe wird automatisch berechnet.
result.meta Base64-kodierte Zusatzinformationen (z.B. JSON-String)
result.type Immer "ImageTarget"
result.active "1" aktiviert, "0" deaktiviert

Fehlercodes

Siehe Status- und Fehlercodes

Meta verwendungshinweise

  • Video-URLs verknüpfen
    • Speichern Sie Video-URLs im meta-Feld, die mit dem Ziel verknüpft sind
    • Nach der Erkennung lädt die App das Video von der URL, z.B. https://my_server/my_videos/my_video_001.mp4
  • 3D-Modelle verknüpfen
    • Speichern Sie 3D-Modelle oder Unity-Ressourcen im meta-Feld
    • Verwenden Sie Base64-Kodierung oder speichern Sie Modell-URLs
    • Bei Erkennung wird das 3D-Modell auf dem Ziel gerendert