JoystickView - A custom Android View to simulates a Joystick in Android

JoystickView is an Android Custom View that simulates a joystick interactive applications for Android's Apps, as a simple objective, this view allows you to access the values ​​of ANGLE , POWER and DIRECTION of movements on virtual joystck.

Exhibition on a simple Android View

INSTALATION

Quick Usage

1º Step: Download the JAR file at download
2º Step: Create a folder called "libs" on the root of your project and place the JAR file into.

It's enough to refer and user the JoystickView library

Advanced Usage

If you want to change or upgrade some feature of the library, you should do:

Go to the official project page on github JoystickView.

1º Step: Clone the project or download this project to your workspace eclipse IDE, then:

2º Step Go to eclipse' menu FILE, after IMPORT.

3º Step: Now click in "Existing Project into Workspace"

4º Step: Click in Browse e search the source code folder where you placed after clone ou download.

5º Step: Setup with Next or/and Finish, ant the JoystickView is ready to you use in your applications.

6º Step: IMPORT - JoystickView in your applications.

To use JoystickView in your applications, simply add the lib to the classpath of your application:


7º Passo: Click with right button on your project go to PROPERTIES -> ANDROID and the ADD.

8º Step: Select JoystickView lib and click OK to finish.

USO

From this point you can inflate the JoystickView in your layouts or referencing it in your Activities.

This is an implementation of a custom android view that works like a Joystick, this view controls two variables, angle motion and power motion of the screen touch.

import com.zerokol.views.JoystickView;

import com.zerokol.views.JoystickView.OnJoystickMoveListener;
import android.app.Activity;
import android.os.Bundle;
import android.widget.TextView;

public class JoystickViewDemoActivity extends Activity {
     private TextView angleTextView;
     private TextView powerTextView;
     private TextView directionTextView;
     // Importing as others views
     private JoystickView joystick;

     @Override
     public void onCreate(Bundle savedInstanceState) {
          super.onCreate(savedInstanceState);
          setContentView(R.layout.main);

          angleTextView = (TextView) findViewById(R.id.angleTextView);
          powerTextView = (TextView) findViewById(R.id.powerTextView);
          directionTextView = (TextView) findViewById(R.id.directionTextView);
          // referring as others views
          joystick = (JoystickView) findViewById(R.id.joystickView);

          // Listener of events, it'll return the angle in graus and power in percents
          // return to the direction of the moviment
          joystick.setOnJoystickMoveListener(new OnJoystickMoveListener() {
               @Override
               public void onValueChanged(int angle, int power, int direction) {
                    angleTextView.setText(" " + String.valueOf(angle) + "°");
                    powerTextView.setText(" " + String.valueOf(power) + "%");
                    switch (direction) {
                         case JoystickView.FRONT:
                              directionTextView.setText(R.string.front_lab);
                              break;

                         case JoystickView.FRONT_RIGHT:
                              directionTextView.setText(R.string.front_right_lab);
                              break;

                         case JoystickView.RIGHT:
                              directionTextView.setText(R.string.right_lab);
                               break;

                         case JoystickView.RIGHT_BOTTOM:
                              directionTextView.setText(R.string.right_bottom_lab);
                              break;

                         case JoystickView.BOTTOM:
                              directionTextView.setText(R.string.bottom_lab);
                              break;

                         case JoystickView.BOTTOM_LEFT:
                              directionTextView.setText(R.string.bottom_left_lab);
                              break;

                         case JoystickView.LEFT:
                              directionTextView.setText(R.string.left_lab);
                              break;

                         case JoystickView.LEFT_FRONT:
                              directionTextView.setText(R.string.left_front_lab);
                              break;

                         default:
                              directionTextView.setText(R.string.center_lab);
                    }
               }
          }, JoystickView.DEFAULT_LOOP_INTERVAL);
     }
}

In your XML layout:

This work is licensed under a Creative Commons Attribution 3.0 Unported License.