Android Core

Android Torch App with Stroboscopic light Tutorial

In this post, we want to describe how to create a simple torch app in Android. It is a nice example, because we can explore some Android API about Android Camera. We will use Android Studio as IDE to develop the app. This app will not only use the flash light but we can implement a stroboscopic light too where the frequency can be changed. We can discover how to use some basic UI components like ToggleButton and SeekBar. We want to obtain an app that looks like:
 
 
 
 
 
 
android_torch_layout_strobo[4]

Android App layout

The first thing we have to do is defining the app layout. If you notice, when using Android Studio, it creates under layout directory a file named fragment_main.xml. We have to edit it and implement here our layout. At the beginning to keep things simple, we can suppose we have only the ToggleButton to turn the flash light on and off:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    android:paddingBottom="@dimen/activity_vertical_margin"
    tools:context="com.survivingwithandroid.tourch.MainActivity$PlaceholderFragment">

    <TextView
        android:text="@string/app_name"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:id="@+id/textView" />

    <TextView
        android:text="@string/torchon"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:id="@+id/textView"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="43dp" />

    <ToggleButton
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="torchonoff"
        android:id="@+id/toggleButton"
        android:layout_below="@+id/textView"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="15dp"
     />
...
</RelativeLayout>

In the IDE preview we have as result:

android_torch_layout[4]

Handling Camera flash light On and Off

Now we have to handle ToggleButton event. Looking in the source code, generated by our IDE, we have a class called MainActivity.java and there there is another inner class used to manage the fragment named PlaceHolderFragment. As we remember a fragment as a complex lifecycle that is reflected in some callback methods called by the system when the fragment moves to different states in its lifecycle. We can use onActivityCreated to get the reference to the smart phone Camera and get is parameters, so we have:

@Override
public void onActivityCreated(Bundle savedInstanceState) {
    super.onActivityCreated(savedInstanceState);
    try {
        Log.d("TORCH", "Check cam");
        // Get CAM reference
        cam = Camera.open();
        camParams = cam.getParameters();
        cam.startPreview();
        hasCam = true;
        Log.d("TORCH", "HAS CAM ["+hasCam+"]");
    }
    catch(Throwable t) {
        t.printStackTrace();
    }

}

At line 7, we open the connection to the Camera and at line 8 we get the default parameters, we will use them later to turn the flash light on and off. At the end at line 9, we call startPreview() to start capturing preview frames.

Now we are ready to handle ToggleButton event and change the flash light according to the event triggered. We can do it in the
onCreateView method, that is called when the OS gives to our fragment the chance to set its layout:

View rootView = inflater.inflate(R.layout.fragment_main, container, false);
// Let's get the reference to the toggle
ToggleButton tBtn = (ToggleButton) rootView.findViewById(R.id.toggleButton);
tBtn.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
    @Override
    public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
        Log.d("TORCH", "IS CHECKED ["+isChecked+"]");
        turnOnOff(isChecked);
    }
});

At line 1, we simply inflate the layout and look for the ToggleButton using its id. Then we handle the event when an user changes its status and we call turnOnOff method:

private void turnOnOff(boolean on) {

    if (on) 
        camParams.setFlashMode(Camera.Parameters.FLASH_MODE_TORCH);

    if (!on) 
        camParams.setFlashMode(Camera.Parameters.FLASH_MODE_OFF);

    cam.setParameters(camParams);
    cam.startPreview();
}

At line 3, we use the camera parameters to turn on and off the flash light using Camera.Parameters.FLASH_MODE_TORCH and Camera.Parameters.FLASH_MODE_OFF.

Android Manifest.xml

To enable our app to use the flash light, we have to modify Android Manifest.xml so that we can declare we want to use the flash light: we have to add:

<uses-permission android:name="android.permission.CAMERA"/>

The next step is filtering the device that can install our app in the Google Play. We want that only the devices that has the flash light can install the app, so we have to add this line to the Manifest.xml:

<uses-feature android:name="android.hardware.camera"/>

Implementing stroboscopic light

The last step is implementing the stroboscopic light. We want the user can select the light frequency, so that we will use a SeekBar. In the fragment layout we will add, then:

<TextView
    android:text="@string/freq"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:id="@+id/textView1"
    android:layout_centerHorizontal="true"
    android:layout_marginTop="43dp"
    android:layout_below="@id/toggleButton"/>

<SeekBar
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:id="@+id/seekBar"
    android:layout_below="@+id/textView1"
    android:layout_centerHorizontal="true"
    android:layout_marginTop="25dp"
    android:layout_marginLeft="25dp"
    android:layout_marginRight="25dp"
    android:max="100"/>

and handle the even when user moves the progress level. As we did before for the ToggleButton, we implement an event listener in the onCreateView method:

// Seekbar
SeekBar skBar = (SeekBar) rootView.findViewById(R.id.seekBar);
skBar.setOnSeekBarChangeListener(new SeekBar.OnSeekBarChangeListener() {
    @Override
    public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
        freq = progress;
    }

    @Override
    public void onStartTrackingTouch(SeekBar seekBar) {
    }

    @Override
    public void onStopTrackingTouch(SeekBar seekBar) {
    }
});

where at line 5 we get the current level. We have to modify the turnOnOff method because if we want to strobo light we have to start a thread that turns on and off the light:

private void turnOnOff(boolean on) {

    if (on) {
        if (freq != 0) {
            sr = new StroboRunner();
            sr.freq = freq;
            t = new Thread(sr);
            t.start();
            return ;
        }
        else
            camParams.setFlashMode(Camera.Parameters.FLASH_MODE_TORCH);
    }
    if (!on) {
       if (t != null) {
           sr.stopRunning = true;
           t = null;
           return ;
       }
        else
           camParams.setFlashMode(Camera.Parameters.FLASH_MODE_OFF);
    }

    cam.setParameters(camParams);
    cam.startPreview();
}

When the user turns on the ToggleButton and the frequency is not zero then we start a new Thread that will simply turns on and off the light:

private class StroboRunner implements Runnable {

    int freq;
    boolean stopRunning = false;

    @Override
    public void run() {
        Camera.Parameters paramsOn = PlaceholderFragment.this.cam.getParameters();
        Camera.Parameters paramsOff = PlaceholderFragment.this.camParams;
        paramsOn.setFlashMode(Camera.Parameters.FLASH_MODE_TORCH);
        paramsOff.setFlashMode(Camera.Parameters.FLASH_MODE_OFF);
        try {
            while (!stopRunning) {
                PlaceholderFragment.this.cam.setParameters(paramsOn);
                PlaceholderFragment.this.cam.startPreview();
                // We make the thread sleeping
                Thread.sleep(100 - freq);
                PlaceholderFragment.this.cam.setParameters(paramsOff);
                PlaceholderFragment.this.cam.startPreview();
                Thread.sleep(freq);
             }
            }
        catch(Throwable t) {}
    }
}
  • The source code will be available @github.

 

Francesco Azzola

He's a senior software engineer with more than 15 yrs old experience in JEE architecture. He's SCEA certified (Sun Certified Enterprise Architect), SCWCD, SCJP. He is an android enthusiast and he has worked for long time in the mobile development field.
Subscribe
Notify of
guest

This site uses Akismet to reduce spam. Learn how your comment data is processed.

1 Comment
Oldest
Newest Most Voted
Inline Feedbacks
View all comments
Tam Ka Wing
Tam Ka Wing
10 years ago

Can you please send the whole project onto the website or send the package to my email please.

Back to top button