Fotocamera e Galleria Fotografica

Titanium è dotato di una API estrememente semplice e potente per l’accesso alla fotocamera e alla galleria delle immagini. Con la stessa funzione infatti possiamo scattare foto o girare filmati, e abbiamo la possibilità di accedere al file risultante per poterne elaborare il contenuto, salvarlo sul filesystem oppure inviarlo sulla rete.

Il metodo per chiamare la fotocamera è Titanium.Media.showCamera e come argomento richiede un oggetto CameraOptionsType contenente le proprietà e i metodi di callback per gestire i tre possibili eventi legati all’uso della fotocamera: esito positivo, eventuale situazione di errore e annullameno dell’operazione. Per accedere alla galleria chiameremo invece il metodo Titanium.Media.openPhotoGallery, che come argomento vuole un oggetto di tipo PhotoGalleryOptionsType.

Quello che rende interessante questa API è che i due oggetti che possiamo passare come argomento hanno una struttura simile e quindi possono, con i dovuti accorgimenti, essere considerati intercambiabili.

La struttura della chiamata pertanto è:

var options = {
		success : function(event) {
			// l'operazione è andata a buon fine
		},
		cancel : function() {
			// l'operazione è stata annullata
		},
		error : function(error) {
			// si è verificato un errore
		},
		saveToPhotoGallery : true,
		allowEditing : true,
		mediaTypes : [Ti.Media.MEDIA_TYPE_VIDEO, Ti.Media.MEDIA_TYPE_PHOTO]
	};
	Titanium.Media.showCamera(options); // attiva la fotocamera
	// oppure...  
	Titanium.Media.openPhotoGallery(options); // attiva la gallery

Esaminiamo in dettaglio i metodi e le proprietà a disposizione:

• saveToPhotogallery: se impostato a true, la foto o il video verranno salvati nella gallery.
• allowEditing: questo parametro è valido solo su iOS, e specifica se il contenuto appena ottenuto dalla fotocamera può essere editato con gli strumenti di sistema forniti dal device.
• mediaTypes: anche questo parametro è valido solo su iOS, e specifica la natura del contenuto che vogliamo catturare.
• success: è la callback che verrà chiamata quando la fotocamera avrà terminato con successo l’operazione. Riceve un parametro event che contiene informazioni sulla natura del contenuto multimediale che è stato catturato (o selezionato).

  
  success : function(event) {
  			// l'operazione è andata a buon fine
  			if (event.mediaType == Ti.Media.MEDIA_TYPE_PHOTO) {
  				$.image.image = event.media;
  			}
  }
  

  L’esempio precedente illustra una callback che verifica se l’operazione di cattura è andata a buon fine e il tipo di media è una fotografia; in caso affermativo, l’immagine catturata verrà visualizzata dall’oggetto $.image (di tipo Ti.UI.ImageView).
• cancel: è la callback che viene chiamata se l’utente annulla l’operazione.
• error: è la callback che viene eseguita quando si verifica un errore.

  
  error : function(err) {
  			// si è verificato un errore
  			if (error.code == Titanium.Media.NO_CAMERA) {
  				alert("no available camera");
  			} else {
  				alert('errore ' + JSON.stringify(err));
  			}
  }
  

  In questo esempio, se il device non è disponibile (come nel caso del simulatore iOS che non dispone di fotocamera) viene mostrato un messaggio di errore. Per gestire tutti gli altri tipi di errore, verrà mostrato un popup con l’oggetto errore in formato JSON.

Se usiamo Android, dobbiamo fare attenzione al fatto che la funzione Titanium.Media.showCamera non permette di registrare video, per cui occorrerà ricorrere alla creazione di un Intent.

Registrare un video su Android

In questo esempio abbiamo una view Alloy con due pulsanti e un oggetto Ti.Media.VideoPlayer. Registreremo il video alla pressione del pulsante Record e lo visualizzeremo alla pressione del pulsante Play. Il videoplayer ha una proprietà url che conterrà l’indirizzo locale del video che verrà registrato.

<Alloy>
	<Window class="container">
		<Button id="record" title="Record" top="0" onClick="onRecord"></Button>
		<Button id="play" title="Play"  onClick="onPlay" visible="false"></Button>
		<VideoPlayer id="player" ns="Ti.Media" bottom="2" url=""
		height="300" width="300" backgroundColor="blue" autoplay="false" />
	</Window>
</Alloy>

Per registrare il video creeremo un Intent la cui azione associata è la registrazione un video. Utilizzeremo questo Intent per avviare una Activity che avrà il compito di far partire la registrazione e di ritornare all’app in caso di successo (o fallimento). Se l’operazione avrà esito positivo, il video sarà memorizzato nella gallery del dispositivo e avrà una URI per poterlo indirizzare. Passando la URI al videoplayer potremo visualizzare la registrazione appena effettuata.

function onRecord() {
	// intent 
	var intent = Titanium.Android.createIntent({
		action : 'android.media.action.VIDEO_CAPTURE'
	});
	// start activity
	$.index.activity.startActivityForResult(intent, function(e) {
		if (e.resultCode == Ti.Android.RESULT_OK) {
			if (e.intent.data != null) {
				var videoURL = e.intent.data;
				// success e.intent.data contains the Video URI
				if (videoURL != null) {
					$.play.visible = true;
					// assign url to videoplayer
					$.player.url = videoURL;
				}
			} else {
				Ti.API.error('Error retrieving the video URI');
			}
		} else if (e.resultCode == Ti.Android.RESULT_CANCELED) {
			Ti.API.trace('recording was canceled');
		} else {
			Ti.API.error('error recording the video');
		}
	});
};
function onPlay() {
	// play recorded video
	$.player.play();
};
$.index.open();

Il codice sorgente degli esempi utilizzati è allegato a questo articolo e disponibile su GitHub: potrete scaricare l’app per fotocamera e gallery ed il registratore di filmati per Android.