Funzioni varie
takeScreenshot
Cattura una schermata della vista di fotocamera corrente, includendo facoltativamente contenuti virtuali (in realtà aumentata).
|
Nome
|
Tipo
|
Descrizione
|
Obbligatorio/Opzionale
|
Default
|
|---|---|---|---|---|
|
params
|
Oggetto
|
Oggetto contenente la configurazione della schermata.
|
Obbligatorio
|
|
|
params.withAugmentation
|
Booleano
|
Attiva o disattiva l'inclusione di contenuti virtuali o in realtà aumentata nella schermata.
|
Obbligatorio
|
|
|
params.dataURL
|
Booleano
|
Attiva o disattiva l'aggiunta di un prefisso URI di dati (ad esempio, “data:image/png;base64,”) alla stringa di risultato.
|
Opzionale
|
true
|
|
params.imgFormat
|
Stringa
|
Formato dell'immagine. Sono supportati i seguenti tipi di file:
• .png
• .jpeg
|
Opzionale
|
"PNG"
|
|
params.imgWidth
|
Numero
|
Larghezza target (in pixel) dell'immagine acquisita.
|
Opzionale
|
|
|
params.imgHeight
|
Numero
|
Altezza target (in pixel) dell'immagine acquisita.
|
Opzionale
|
|
|
successCallback
|
Funzione
|
Chiamata quando l'operazione viene completata correttamente.
|
Opzionale
|
|
|
errorCallback
|
Funzione
|
Chiamata quando l'operazione ha esito negativo.
|
Opzionale
|
 |
• Se imgWidth o imgHeight non viene specificato:
◦ L'immagine viene acquisita alla risoluzione nativa della fotocamera.
◦ Se la risoluzione è inferiore alla metà della larghezza e dell'altezza dello schermo, l'immagine viene convertita ad almeno la metà della larghezza dello schermo moltiplicata per la metà dell'altezza dello schermo, al fine di evitare la presenza di bordi grigi nell'anteprima dell'esperienza.
◦ Se la risoluzione nativa raggiunge già questa soglia, l'immagine rimane invariata.
• Se viene fornita una sola dimensione (imgWidth o imgHeight), la dimensione mancante viene calcolata automaticamente per mantenere le proporzioni originali.
• Se vengono fornite entrambe le dimensioni (imgWidth e imgHeight):
◦ Una dimensione viene ricalcolata per mantenere le proporzioni originali.
◦ L'immagine finale rientra nei limiti specificati.
• Se dataURL è true, la stringa con codifica base64 è preceduta da un tipo MIME (ad esempio, "data:image/png;base64," o "data:image/jpeg;base64,")
• L'immagine viene restituita tramite successCallback.
|
scanForNextBarCode
Avvia lo scanner di codici a barre e attende il successivo codice a barre leggibile. Una volta rilevato un codice a barre, lo scanner si arresta e restituisce il risultato.
|
Nome
|
Tipo
|
Descrizione
|
Obbligatorio/Opzionale
|
|---|---|---|---|
|
successCallback
|
Funzione
|
Chiamata quando l'operazione viene completata correttamente.
|
Opzionale
|
|
errorCallback
|
Funzione
|
Chiamata quando l'operazione ha esito negativo.
|
Opzionale
|
|
|
• Una volta rilevato un codice a barre valido, la scansione si interrompe automaticamente.
• Il valore restituito in successCallback è la rappresentazione in formato stringa decodificata del codice a barre.
|
scanBarCodeScanning
Arresta lo scanner di codici a barre al momento in esecuzione se è attivo e non ha alcun effetto se lo scanner non è in esecuzione.
|
Nome
|
Tipo
|
Descrizione
|
Obbligatorio/Opzionale
|
|---|---|---|---|
|
successCallback
|
Funzione
|
Chiamata quando l'operazione viene completata correttamente.
|
Opzionale
|
|
errorCallback
|
Funzione
|
Chiamata quando l'operazione ha esito negativo.
|
Opzionale
|
|
|
• Questa funzione può essere utilizzata per annullare manualmente una scansione del codice a barre in corso avviata tramite scanForNextBarcode.
• Se al momento non è attiva alcuna scansione, la funzione ha esito positivo senza effetto.
• Inoltre, lo scanner si arresta automaticamente dopo un rilevamento positivo del codice a barre. Di conseguenza, la funzione è in genere necessaria solo per l'annullamento manuale.
|
setupTrackingEventsCommand
Registra un callback per ricevere gli aggiornamenti degli eventi di monitoraggio, ad esempio le modifiche alla posizione o all'orientamento di un target monitorato.
|
Nome
|
Tipo
|
Descrizione
|
Obbligatorio/Opzionale
|
|---|---|---|---|
|
successCallback
|
Funzione
|
Chiamata quando l'operazione viene completata correttamente.
|
Opzionale
|
|
errorCallback
|
Funzione
|
Chiamata quando l'operazione ha esito negativo.
|
Opzionale
|
|
|
• successCallback viene richiamata una volta per fotogramma mentre il monitoraggio è attivo.
• Ogni callback riceve una matrice di stringhe con i valori seguenti:
◦ trackerId - ID del tracker corrente (ID tracker).
◦ cameraPosition - Posizione della fotocamera nello spazio del tracker, come stringa in formato [x,y,z].
◦ cameraForward - Vettore di direzione verso avanti della fotocamera, nello spazio del tracker.
◦ cameraUp - Vettore di direzione verso l'alto della fotocamera, nello spazio del tracker.
◦ timestamp - Data e ora UNIX (in secondi) al momento del monitoraggio.
• errorCallback non è al momento in uso da questa funzione.
|
setDimensions
Imposta la larghezza e l'altezza di un'immagine 3D.
|
Nome
|
Tipo
|
Descrizione
|
Obbligatorio/Opzionale
|
|
|---|---|---|---|---|
|
id
|
Stringa
|
ID Studio dell'immagine 3D da aggiornare.
|
Obbligatorio
|
|
|
params
|
Oggetto
|
Oggetto contenente i valori delle dimensioni.
|
Obbligatorio
|
|
|
params.width
|
Numero
|
Larghezza target dell'immagine.
|
Opzionale
|
NaN
|
|
params.height
|
Numero
|
Altezza target dell'immagine.
|
Opzionale
|
NaN
|
|
successCallback
|
Funzione
|
Chiamata quando l'operazione viene completata correttamente.
|
Opzionale
|
|
|
errorCallback
|
Funzione
|
Chiamata quando l'operazione ha esito negativo.
|
Opzionale
|
|
|
• Questa funzione è supportata solo per i widget 3D che accettano immagini (Immagine 3D, Indicatore 3D ed Etichetta 3D).
• Se la larghezza o l'altezza è omessa o impostata su NaN, il valore mancante viene calcolato in base all'altra dimensione specificata mantenendo le proporzioni originali.
• Se sia la larghezza che l'altezza sono omesse o impostate su NaN, le dimensioni vengono determinate automaticamente dalle dimensioni native della texture.
|