proceduraScopo
Questa procedura permette di scattare una fotografia sul dispositivo ed inviarla, come file JPG, all'applicazione mobile sviluppata con In.de.
Dopo aver scattato la foto se l'utente preme il bottone Usa l'immagine viene automaticamente inviata all'applicazione mobile e viene notificato l'evento OnFileUploaded. Se l'utente preme il bottone Annulla la Shell Nativa notifica comunque l'evento OnFileUploaded valorizzando a -1 il parametro Size.
Sintassi
Shell.takePicture(Filename, Quality, Width, Height, CameraRoll)
Argomenti
| File Name | Nome del file da assegnare all'immagine (es: Ordine15.jpg). Tale nome viene fornito all'evento OnFileUploaded. |
| Quality | Qualità dell'immagine (0-100) |
| Width | Parametro opzionale, larghezza dell'immagine. Se non viene specificato la larghezza dell'immagine è quella predefinita del dispositivo. |
| Height | Parametro opzionale, altezza dell'immagine. Se non viene specificato l'altezza dell'immagine è quella predefinita del dispositivo. |
| Camera Roll | Parametro introdotto a partire dalla versione 12.0 di Instant Developer. E' un valore booleano opzionale che permette di indicare alla shell nativa se si desidera recuperare una delle foto presenti nel rullino del dispositivo. Il valore predefinito, qualora non venga specificato un valore, è False (acquisizione foto tramite fotocamera). |
- Questa procedura è statica.
- Se si specifica solo una delle due dimensioni il sistema calcola automaticamente la dimensione mancante mantenendo le proporzioni dell'immagine.
-
Dopo aver premuto il bottone Usa la Shell Nativa:
- nel caso di applicazioni online la foto viene inviata al server web, salvata nella cartella temporanea e viene notificato l'evento OnFileUploaded. Il nome del file è quello fornito al metodo ed il parametro Save To contiene il percorso completo del file. E' quindi possibile utilizzare il metodo LoadBlobFile per caricare la foto sul database locale.
- nel caso di applicazioni offline la Shell Nativa notifica l'evento OnFileUploaded fornendo al parametro Save To l'intera fotografia come BLOB. E' quindi possibile utilizzare il metodo LoadBlobFile per caricare la foto sul database locale.
- Se l'utente annulla l'acquisizione della foto la Shell Nativa notifica l'evento OnFileUploaded fornendo il valore -1 al parametro Size.
- Dalla versione 18.0 sui dispositivi con Android Marshmallow o superiore qualora il parametro CameraRoll sia true viene richiesta preventivamente la permission per leggere da memoria esterna, mentre se è false vengono richieste le permission per accedere alla fotocamera e per scrivere su memoria esterna.
Ultima modifica: 13/05/2022 / Validità: da 11.0.4800