Créer un Live Wallpaper sous Android

Créer un Live Wallpaper sous Android

• Un live wallpaper a un contenu dynamique, ce qui permet d�avoir des animations. C�est donc � vous de g�rer les diff�rentes �tapes de dessin sur le wallpaper. Pour cela, on utilise les deux classes Runnable et Handler.
  
  Le handler envoi le runnable (ici drawer) dans le messageQueue associ� � l�UI Thread afin qu�il soit ex�cut�. Ce runnable se charge de dessiner sur le wallpaper gr�ce � la m�thode draw() qu�on expliquera plus tard. R�p�ter plusieurs fois ce m�canisme nous permet d�avoir une animation.
  
  Quand le wallpaper doit s�arr�ter, la variable visible (qui stocke la visibilit� actuelle du wallpaper) passe � false dans les m�thodes onSurfaceDestroyed()�et �onVisibilityChanged() ce qui stoppera l�animation (m�thode handler.removeCallbacks(drawer).)
  
  Quand le wallpaper devient visible, la variable visible passe � true dans la m�thode �onVisibilityChanged() , ce qui relance l�animation du wallpaper (m�thode handler.post(drawer).)
  
  Voyons maintenant comment on dessine sur le wallpaper, la m�thode facilitant cette op�ration est la m�thode draw() :
  

  
  

  private void draw() {
   SurfaceHolder holder = getSurfaceHolder();
   Canvas canvas = null;
   try {
   canvas = holder.lockCanvas();
   if (canvas != null) {
   float x = (width * random.nextFloat());
   float y = (height * random.nextFloat());
   drawImage(canvas, x, y);
   }
   } finally {
   if (canvas != null)
   holder.unlockCanvasAndPost(canvas);
   }
   handler.removeCallbacks(drawer);
   if (visible) {
   //On re-poste le runnable apr�s un petit laps de temps
   handler.postDelayed(drawer, 4000);
   }
  }

  
  

  
  La m�thode qui permet de dessiner l�image dans le canvas est d�crite ci-dessous�:
  

  
  

  private void drawImage(Canvas canvas, float x, float y) {
   canvas.drawColor(Color.WHITE);
   canvas.drawBitmap(androidPic, x-(androidPic.getWidth()/2), y-(androidPic.getHeight()/2), null);
  }

  
  

  
  Sans oublier de d�clarer la variable qui repr�sente l�image qu�on veut dessiner�:
  

  
  

  Bitmap androidPic = BitmapFactory.decodeResource(getResources(), R.drawable.android);

  
  

  
  Explications :
  
  Nous avons utilis� un Canvas, ce qui nous permet de dessiner de mani�re r�p�titive sur la Surface du wallpaper. Cette surface est fournie par la classe ��SurfaceView��.
  
  Afin de manipuler cette surface on utilise l�interface SurfaceHolder. On obtient le canvas grace � la m�thode lockCanvas(), puis on dessine sur un point du canvas avec la m�thode drawImage().Ce point est obtenu al�atoirement gr�ce � ses coordonn�s (x,y).
  
  Enfin la m�thode unlockCanvasAndPost(canvas) est appel� pour que le canvas soit d�ssin� sur la surface du wallpaper.
  

  Gestion des �v�nements tactiles�:

  
  Cela se fait gr�ce � la m�thode onTouchEvent(MotioEvent event), cette m�thode poss�de le m�me comportement que la m�thode draw(), sauf que cette fois les coordonn�es du point o� s�effectue le dessin sont obtenus � l�endroit ou l�interaction utilisateur est effectu�e.
  

  
  

  @Override
  public void onTouchEvent(MotionEvent event) {
   float X = event.getX();
   float Y = event.getY();
   SurfaceHolder holder = getSurfaceHolder();
   Canvas canvas = null;
   try {
   canvas = holder.lockCanvas();
   if (canvas != null) {
   canvas.drawColor(Color.WHITE);
   drawImage(canvas, X, Y);
   }
   } finally {
   if (canvas != null)
   holder.unlockCanvasAndPost(canvas);
   }
   handler.removeCallbacks(drawer);
   if (visible) {
   handler.postDelayed(drawer, 4000);
   }
   super.onTouchEvent(event);
  }

  
  Ce qui donnera :
  

  import java.util.Random;
  import android.graphics.Bitmap;
  import android.graphics.BitmapFactory;
  import android.graphics.Canvas;
  import android.graphics.Color;
  import android.os.Handler;
  import android.service.wallpaper.WallpaperService;
  import android.view.MotionEvent;
  import android.view.SurfaceHolder;
  
  public class MyLiveWallpaper extends WallpaperService {
  
   private static Random random = new Random() ;
  
   @Override
   public Engine onCreateEngine() {
   return new LiveWallpaperEngine();
   }
  
   private class LiveWallpaperEngine extends Engine {
  
   private final Handler handler = new Handler();
   private final Runnable drawer = new Runnable() {
   @Override
   public void run() {
   draw();
   }
   };
  
   private boolean visible = true;
   private int width;
   private int height;
   Bitmap androidPic = BitmapFactory.decodeResource(getResources(), R.drawable.android);
  
   public LiveWallpaperEngine() {
   handler.post(drawer);
   }
  
   @Override
   public void onCreate(SurfaceHolder surfaceHolder) {
   super.onCreate(surfaceHolder);
   setTouchEventsEnabled(true);
   }
  
   @Override
   public void onDestroy() {
   super.onDestroy();
   handler.removeCallbacks(drawer);
   }
  
   @Override
   public void onSurfaceCreated(SurfaceHolder holder) {
   super.onSurfaceCreated(holder);
   }
  
   @Override
   public void onSurfaceChanged(SurfaceHolder holder, int format, int width, int height) {
   this.width = width;
   this.height = height;
   super.onSurfaceChanged(holder, format, width, height);
   }
  
   @Override
   public void onSurfaceDestroyed(SurfaceHolder holder) {
   super.onSurfaceDestroyed(holder);
   this.visible = false;
   handler.removeCallbacks(drawer);
   }
  
   @Override
   public void onVisibilityChanged(boolean visible) {
   this.visible = visible;
   if (visible) {
   handler.post(drawer);
   } else {
   handler.removeCallbacks(drawer);
   }
   }
  
   @Override
   public void onTouchEvent(MotionEvent event) {
   float X = event.getX();
   float Y = event.getY();
   SurfaceHolder holder = getSurfaceHolder();
   Canvas canvas = null;
   try {
   canvas = holder.lockCanvas();
   if (canvas != null) {
   canvas.drawColor(Color.WHITE);
   drawImage(canvas, X, Y);
   }
   } finally {
   if (canvas != null)
   holder.unlockCanvasAndPost(canvas);
   }
   handler.removeCallbacks(drawer);
   if (visible) {
   handler.postDelayed(drawer, 4000);
   }
   super.onTouchEvent(event);
   }
  
   private void draw() {
   SurfaceHolder holder = getSurfaceHolder();
   Canvas canvas = null;
   try {
   canvas = holder.lockCanvas();
   if (canvas != null) {
   float x = (width * random.nextFloat());
   float y = (height * random.nextFloat());
   drawImage(canvas, x, y);
   }
   } finally {
   if (canvas != null)
   holder.unlockCanvasAndPost(canvas);
   }
   handler.removeCallbacks(drawer);
   if (visible) {
   //On re-poste le runnable apr�s un petit laps de temps
   handler.postDelayed(drawer, 4000);
   }
   }
  
   // Permet de dessiner limage dans le canvas
   private void drawImage(Canvas canvas, float x, float y) {
   canvas.drawColor(Color.WHITE);
   canvas.drawBitmap(androidPic, x-(androidPic.getWidth()/2), y-(androidPic.getHeight()/2), null);
   }
   }
  }

  
  

  
  Derni�re �tape, on d�clare notre service dans l�AndroidManifest.xml avec l�action ��android.service.wallpaper.WallpaperService�� et la permission ��android.permission.BIND_WALLPAPER�� qui autorise l�utilisation du Live Wallpaper.
  Notons aussi l�ajout de la balise uses-feature , qui indique � Google Play que votre application contient un Live Wallpaper, pour que celle�ci soit visible qu�aux utilisateurs ayant un device supportant les live wallpapers.
  

  
  

  ?xml version="1.0" encoding="utf-8"?
  manifest 
   package="com.tuto.android"
   android_versionCode="1"
   android_versionName="1.0" 
  
   uses-sdk android_minSdkVersion="10" /
   uses-feature android_name="android.software.live_wallpaper"/uses-feature
  
   application
   android_label="@string/app_name"
   android_icon="@drawable/ic_launcher" 
  
   service 
   android_label="@string/my_live_wallpaper"
   android_name=".MyLiveWallpaper"
   android_permission="android.permission.BIND_WALLPAPER"
   intent-filter
   action android_name="android.service.wallpaper.WallpaperService"/action
   /intent-filter
   meta-data android_name="android.service.wallpaper"
   android_resource="@xml/mywallpaper"/meta-data
   /service
   /application
  
  /manifest

  
  Sans oublier le String.xml�:
  

  ?xml version="1.0" encoding="UTF-8"?
  resources
  
   string name="app_name"Live Wallpaper/string
   string name="my_live_wallpaper"My Live Wallpaper/string
   string name="wallpaper_description"My first live wallpaper/string 
  
  /resources

  
  

  
  

  Remarque�:

  
  Pour g�rer les pr�f�rences de votre wallepaper, cr�ez une Pr�f�renceActivity qui permettra de d�finir les configurations de votre fond d��cran. La r�cup�ration des valeurs de vos pr�f�rences s�effectue � l�aide des SharedPreference. Pour cela, ajoutez les lignes suivantes � votre ��wallpaper.xml��:
  

  
  

  android:settingsActivity="MyPreferenceActivity"/

  
  

  
  sans oublier de d�clarer votre activit� dans l�AndroidManifest.xml.
  
  Lancez maintenant votre application, s�lectionnez le Live Wallpaper que vous avez cr�� afin d�obtenir le r�sultat suivant�:
  
  


• 
  

  Cr�er un Live Wallpaper sous Android

  
  

  Conclusion

  
  Voila, j�esp�re que cet article vous � permis de mieux comprendre comment fonctionnent les live wallpapers,le code du projet est disponible ici.
  Maintenant place � votre imagination pour cr�er vos propre fond d��cran anim�s.

download
alternative link download