AudioCaptureOperation.java

/*
 * PhoneGap is available under *either* the terms of the modified BSD license *or* the
 * MIT License (2008). See http://opensource.org/licenses/alphabetical for full text.
 * 
 * Copyright (c) 2011, IBM Corporation
 */ 
package com.phonegap.media;

import java.io.IOException;

import javax.microedition.io.Connector;
import javax.microedition.io.file.FileConnection;

import com.phonegap.file.File;
import com.phonegap.file.FileUtils;
import com.phonegap.util.Logger;

import net.rim.device.api.io.MIMETypeAssociations;
import net.rim.device.api.ui.UiApplication;

public class AudioCaptureOperation extends CaptureOperation {

    // content type
    public static final String CONTENT_TYPE = "audio/";
    
    // maximum duration to capture media (milliseconds)
    private long duration = 0;

    // file system listener
    private AudioCaptureListener listener = null;

    /**
     * Creates and starts an audio capture operation.
     * 
     * @param limit
     *            maximum number of media files to capture
     * @param duration
     *            maximum duration to capture media (milliseconds)
     * @param callbackId
     *            the callback to receive the files
     * @param queue
     *            the queue from which to retrieve captured media files
     */
    public AudioCaptureOperation(int limit, long duration, String callbackId, MediaQueue queue) {
        super(limit, callbackId, queue);

        if (duration > 0) {
            this.duration = duration;
        }

        // listener to capture image files added to file system
        this.listener = new AudioCaptureListener(queue);
        
        start();
    }

    /**
     * Registers file system listener and launches native voice notes recorder
     * application.
     */
    protected void setup() {
        // register listener for files being written
        synchronized(UiApplication.getEventLock()) {
            UiApplication.getUiApplication().addFileSystemJournalListener(listener);
        }
        
        // launch the native voice notes recorder application
        AudioControl.launchAudioRecorder();
    }

    /**
     * Unregisters file system listener and closes native voice notes recorder
     * application.
     */
    protected void teardown() {
        // remove file system listener
        synchronized(UiApplication.getEventLock()) {
            UiApplication.getUiApplication().removeFileSystemJournalListener(listener);
        }
        
        // close the native voice notes recorder application
        AudioControl.closeAudioRecorder();
    }

    /**
     * Retrieves the file properties for the captured audio recording.
     * 
     * @param filePath
     *            full path of the audio recording file
     */
    protected void processFile(String filePath) {
        Logger.log(this.getClass().getName() + ": processing file: " + filePath);
        
        File file = new File(FileUtils.stripSeparator(filePath));
        
        // grab file properties
        FileConnection fconn = null;
        try {
            fconn = (FileConnection) Connector.open(filePath, Connector.READ);
            if (fconn.exists()) {
                long size = fconn.fileSize();
                Logger.log(this.getClass().getName() + ": " + filePath + " size="
                        + Long.toString(size) + " bytes");                
                file.setLastModifiedDate(fconn.lastModified());
                file.setName(FileUtils.stripSeparator(fconn.getName()));
                file.setSize(size);
                file.setType(MIMETypeAssociations.getMIMEType(filePath));
            }
        }
        catch (IOException e) {
            Logger.log(this.getClass().getName() + ": " + e);
        }
        finally {
            try {
                if (fconn != null) fconn.close();
            } catch (IOException ignored) {}
        }
        
        addCaptureFile(file);
    }
}