Table of Contents

Creazione di nuovi obiettivi immagine | POST /targets

Carica immagini di riconoscimento per creare nuovi obiettivi immagine

Action

POST /targets

Autenticazione

Richiesta

Http Header

Content-Type=application/json

HTTP Header: Authorization (quando si utilizza l'autenticazione tramite token API Key)

Parametri della richiesta

Campo Tipo Obbligatorio Descrizione
image String(base64) Sì Stringa codificata base64 del contenuto dell'immagine, supporta formati JPG e PNG. Dimensione massima dell'immagine 2MB.
active String No "1" abilita l'obiettivo, "0" disabilita l'obiettivo. Predefinito "1".
name String Sì Nome dell'obiettivo, supporta solo lettere inglesi, punteggiatura inglese, numeri. Lunghezza minima 1 carattere, massima 64 caratteri.
size String (Float) Sì Larghezza dell'immagine di riconoscimento (unità cm). L'altezza verrà calcolata automaticamente dal sistema in base all'immagine caricata. La dimensione corrisponde al contenuto virtuale. Predefinito 20.
meta String Sì Utilizzato generalmente per memorizzare informazioni sui contenuti AR, formato stringa di testo, predefinito "". Ad esempio: informazioni JSON sull'oggetto riconosciuto, codifica base64 dell'immagine o URL di download di file grandi su cloud storage. Massimo 2MB.
type String (Float) Sì Deve essere impostato obbligatoriamente sulla stringa "ImageTarget", rispettando esattamente maiuscole/minuscole.
allowSimilar String No Se consentire forzatamente l'aggiunta in presenza di immagini simili, predefinito 0. Le immagini simili potrebbero influenzare il riconoscimento, si consiglia di usare il valore predefinito.
Nota
  • image dimensione massima 2MB
  • meta dimensione massima 2MB

Esempio di richiesta

    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"
    }

Esempio di risposta

    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
    }

Campi della risposta

Campo Descrizione
statusCode Codice di stato 0 indica autenticazione corretta, vedi codici di stato
result Messaggio di errore o informazioni sull'immagine obiettivo
timestamp Orario del server al momento della risposta. Formato timestamp Unix, in millisecondi
result.targetId ID univoco dell'immagine obiettivo
result.trackingImage Stringa codificata base64 dell'immagine di tracciamento
result.name Nome dell'obiettivo
result.size Larghezza immagine di riconoscimento (unità cm). L'altezza verrà calcolata automaticamente dal sistema. La dimensione corrisponde al contenuto virtuale sovrapposto
result.meta Informazioni aggiuntive codificate base64, ad esempio stringa JSON codificata base64
result.type Fisso a ImageTarget
result.active "1" abilitato, "0" disabilitato

Codici di errore

Vedi codici di stato ed errori

Istruzioni per l'uso di meta

  • Associare URL video
    • Per ogni obiettivo di riconoscimento, è possibile memorizzare in meta l'URL video associato a quell'obiettivo specifico
    • Dopo il riconoscimento, l'app utilizza l'URL in meta per connettersi al server, scaricare e riprodurre il video, es. https://my_server/my_videos/my_video_001.mp4
  • Associare modelli 3D
    • Per ogni obiettivo, è possibile memorizzare in meta modelli 3D o asset Unity associati
    • Codificare il modello in base64 prima di memorizzarlo in meta, oppure memorizzarne l'URL nei metadati
    • Al riconoscimento, l'app renderizzerà il modello 3D sull'obiettivo rilevato