Android源码之动态壁纸引擎
动态壁纸蛮好玩的，也没接触过，看官方有就拿了学习下，是第一次接触引擎 Engine，激动兴奋...效果做出来了，记录笔记，吼吼，跟大家交流学习， 废话不多说了，先看效果，再看源码，供大家交流学习，今天的效果如下图所示，因为手机开机后就要加载图片，所以就直接从开机启动完成后讲了，看图...
未开锁时立方体形式一：
开锁时立方体形式一与二：
简单的绘制效果，因为立方体都是下面这些图(由三角形拼成的)拼的，所以此处贴下这个效果图，效果制作的代码我放在形式一注释里面了，大家可以试下的，就是这个效果，临时引用的：
工程结构如下图所示：
因为形式一与形式二只是绘制点不一样，两个类都一样，防止篇幅过长(51有限制，超过80000字符就挂了，我已经超过了，这是第二边写了，所以形 式二代码就不贴了)，小马就直接贴形式一的代码与配置文件代码，详细的如有朋友要学习的话，下载下DEMO学习就是，小马基本的注释都加了，因为也在学习 阶段，如有地方不足的，希望大家直接留言，批评指出，小马肯定感谢...
立方体形式一控制类代码：
package xiaoma.cube1;
import android.graphics.Canvas;
import android.graphics.Paint;
import android.os.Handler;
import android.os.SystemClock;
import android.service.wallpaper.WallpaperService;
import android.view.MotionEvent;
import android.view.SurfaceHolder;
/**
* @Title: CubeWallpaper1.java
* @Package cube1
* @Description: 初识Android动态壁纸引擎
* @author XiaoMa
*/
/*
* 因为小马没接触过引擎，也无从下手学习，今天就拿官方的例子来试试刀了，
* 吼吼，刚开始不知道，看了下代码，里面有讲到WallPaperService
* 查询这个服务可以查到与之相关联的类与方法，如下面官方文档中讲的，大家
* 英语不好也可以用工具看个大概，英语不好的朋友记得多用工具学习下，小马
* 英语也不咋的....
* A wallpaper service is responsible for showing a live wallpaper behind
* applications that would like to sit on top of it. This service object itself
* does very little -- its only purpose is to generate instances of
* WallpaperService.Engine as needed. Implementing a wallpaper thus involves
* subclassing from this, subclassing an Engine implementation, and implementing
* onCreateEngine() to return a new instance of your engine
* 上面讲的大体是：一个类必须是WallpaperService引擎类的子类，而且里面必须重写
* onCreateEngine这个方法，要仔细看的话小马也看不懂英文，照着例子，看官方文档，
* 多猜多用工具查就行了，小马英语烂的可以让你吐血...我能看懂，你肯定能看懂
*/
public class CubeWallpaper1 extends WallpaperService {
/*常用的都是这样的，用一个handler来动态的去刷新UI，对吧?猜的，看下面代码到底是不是*/
private final Handler mHandler = new Handler();
/**
* 这个方法与Activity里面的一样，当这个类的服务被第一次创建时
* 调用，也就是说，这个方法只调用一次..
*/
@Override
public void onCreate() {
super.onCreate();
}
/**
* 与上面反的，销毁时调用，这个猜下，
* 不懂了查文档
*/
@Override
public void onDestroy() {
super.onDestroy();
}
/**
* 这个方法在类注释中写明了
* implementing onCreateEngine() to return a new instance of your engine
* 必须实现这个方法来返回我们自己定义引擎的一个实例
*/
@Override
public Engine onCreateEngine() {
return new CubeEngine();
}
/**
*
* @Title: CubeWallpaper1.java
* @Package cube1
* @Description: 自定义引擎类
* @author XiaoMa
*/
class CubeEngine extends Engine {
private final Paint mPaint = new Paint();
private float mOffset;
/*用户触摸位置*/
private float mTouchX = -1;
private float mTouchY = -1;
private long mStartTime;
/*屏幕中心坐标，记下，是中心不是原心(0，0)*/
private float mCenterX;
private float mCenterY;
private final Runnable mDrawCube = new Runnable() {
public void run() {
drawFrame();
}
};
private boolean mVisible;
CubeEngine() {
/*下面这几行就为了在屏幕中画立方体的线条而做准备*/
final Paint paint = mPaint;
paint.setColor(0xffffffff);//画笔颜色
paint.setAntiAlias(true);//抗锯齿
paint.setStrokeWidth(2);//线条粗细，猜的，不知道对不对
paint.setStrokeCap(Paint.Cap.ROUND);
paint.setStyle(Paint.Style.STROKE);
//系统启动完之后，开始绘制壁纸的时间，这个时间里面包含有系统睡眠时间
mStartTime = SystemClock.elapsedRealtime();
}
/**
* 大家发现这个onCreate与Activity的方法有什么不同了吧?
* 老规矩的，还是在初始化壁纸引擎的时候调用这个方法，并设置触
* 屏事件为可用
*/
@Override
public void onCreate(SurfaceHolder surfaceHolder) {
super.onCreate(surfaceHolder);
setTouchEventsEnabled(true);
}
@Override
public void onDestroy() {
super.onDestroy();
mHandler.removeCallbacks(mDrawCube);
}
/**
* 系统壁纸状态改变时会调用这个方法，如：
* 壁纸由隐藏转换为显示状态时会调用这个方法
*/
@Override
public void onVisibilityChanged(boolean visible) {
mVisible = visible;
/*下面这个判断好玩，就是说，如果屏幕壁纸状态转为显式时重新绘制壁纸，否则黑屏幕，隐藏就可以*/
if (visible) {
drawFrame();
} else {
mHandler.removeCallbacks(mDrawCube);
}
}
@Override
public void onSurfaceChanged(SurfaceHolder holder, int format,
int width, int height) {
super.onSurfaceChanged(holder, format, width, height);
//下面是来保存屏幕显示立方体的，也就是你能看到的正面图的中心位置
mCenterX = width / 2.0f;
mCenterY = height / 2.0f;
drawFrame();
}
/**
* 下面两个方法是为了方便调用SurfaceHolder交互来重写的
*/
@Override
public void onSurfaceCreated(SurfaceHolder holder) {
super.onSurfaceCreated(holder);
}
@Override
public void onSurfaceDestroyed(SurfaceHolder holder) {
super.onSurfaceDestroyed(holder);
mVisible = false;
mHandler.removeCallbacks(mDrawCube);
}
/**
* 当手动壁纸时根据偏移量重绘壁纸
*/
@Override
public void onOffsetsChanged(float xOffset, float yOffset, float xStep,
float yStep, int xPixels, int yPixels) {
mOffset = xOffset;
drawFrame();
}
/*
* 在这个地方保存触摸的位置，我们会在绘制壁纸的时候使用触摸值
*/
@Override
public void onTouchEvent(MotionEvent event) {
if (event.getAction() == MotionEvent.ACTION_MOVE) {
mTouchX = event.getX();
mTouchY = event.getY();
} else {
mTouchX = -1;
mTouchY = -1;
}
super.onTouchEvent(event);
}
/*
* 绘制立方体方法实现
*/
void drawFrame() {
final SurfaceHolder holder = getSurfaceHolder();
Canvas c = null;
try {
c = holder.lockCanvas();
if (c != null) {
drawCube(c);
drawTouchPoint(c);
}
} finally {
if (c != null)
holder.unlockCanvasAndPost(c);
}
// 在指定时间里重绘制，这个地方大家可以看效果图，如果你拖动过快的话，立方体
//每个顶点之间会有一个短暂的未连接延迟，就是在这个地方使用了延迟来绘制的
mHandler.removeCallbacks(mDrawCube);
if (mVisible) {
mHandler.postDelayed(mDrawCube, 1000 / 25);
}
}
/*
* 这个地方是以立方体某个顶点为起始端，绘制三条线
* 一堆数字，看着好晕
* 在这小马顺便贴在这个DEMO里面用到的基本的绘制，如下：
* graphics.Canvas有四种画矩形的方法。
canvas.drawRect(new RectF(10, 10, 300, 100), paint);
canvas.drawRect(10, 150, 300, 200, paint);
canvas.drawRect(new Rect(10, 250, 300, 300), paint);
第四种：画圆角的矩形
canvas.drawRoundRect(new RectF(10, 350, 300, 450), 10, 10, paint);
第二个和第三个参数为圆角的宽高。
有兴趣的朋友可以改下下面这些东西
*/
void drawCube(Canvas c) {
c.save();
c.translate(mCenterX, mCenterY);
c.drawColor(0xff000000);
drawLine(c, -400, -400, -400, 400, -400, -400);
drawLine(c, 400, -400, -400, 400, 400, -400);
drawLine(c, 400, 400, -400, -400, 400, -400);
drawLine(c, -400, 400, -400, -400, -400, -400);
drawLine(c, -400, -400, 400, 400, -400, 400);
drawLine(c, 400, -400, 400, 400, 400, 400);
drawLine(c, 400, 400, 400, -400, 400, 400);
drawLine(c, -400, 400, 400, -400, -400, 400);
drawLine(c, -400, -400, 400, -400, -400, -400);
drawLine(c, 400, -400, 400, 400, -400, -400);
drawLine(c, 400, 400, 400, 400, 400, -400);
drawLine(c, -400, 400, 400, -400, 400, -400);
c.restore();
}
/*
* 在屏幕中绘制三维空间的线
*/
void drawLine(Canvas c, int x1, int y1, int z1, int x2, int y2, int z2) {
/*
*因为大家都知道，壁纸是手机启动完成之后就已经开始绘制的，一般取时间什么的
*我们都用Timer System.currentTimeMillis() Calendar来取
*这个地方取系统级启动时间等的，记住这个类，SystemClock，方法自己查
*/
long now = SystemClock.elapsedRealtime();
/*取得三维坐标轴的旋转值*/
float xrot = ((float) (now - mStartTime)) / 1000;
float yrot = (0.5f - mOffset) * 2.0f;
float zrot = 0;
// rotation around X-axis ???
float newy1 = (float) (Math.sin(xrot) * z1 + Math.cos(xrot) * y1);
float newy2 = (float) (Math.sin(xrot) * z2 + Math.cos(xrot) * y2);
float newz1 = (float) (Math.cos(xrot) * z1 - Math.sin(xrot) * y1);
float newz2 = (float) (Math.cos(xrot) * z2 - Math.sin(xrot) * y2);
// rotation around Y-axis ???
float newx1 = (float) (Math.sin(yrot) * newz1 + Math.cos(yrot) * x1);
float newx2 = (float) (Math.sin(yrot) * newz2 + Math.cos(yrot) * x2);
newz1 = (float) (Math.cos(yrot) * newz1 - Math.sin(yrot) * x1);
newz2 = (float) (Math.cos(yrot) * newz2 - Math.sin(yrot) * x2);
// 3D-to-2D projection ???
float startX = newx1 / (4 - newz1 / 400);
float startY = newy1 / (4 - newz1 / 400);
float stopX = newx2 / (4 - newz2 / 400);
float stopY = newy2 / (4 - newz2 / 400);
c.drawLine(startX, startY, stopX, stopY, mPaint);
}
/*
* 按位屏幕手动时绘制一个白色的圈
*/
void drawTouchPoint(Canvas c) {
if (mTouchX >= 0 && mTouchY >= 0) {
c.drawCircle(mTouchX, mTouchY, 80, mPaint);
}
}
}
}
配置文件代码如下：
package="xiaoma.cube1"
android:versionCode="1"
android:versionName="1.0" >
android:label="@string/wallpapers"
android:icon="@drawable/ic_launcher">
android:label="@string/wallpaper_cube1"
android:name=".CubeWallpaper1"
android:permission="android.permission.BIND_WALLPAPER">
android:label="@string/wallpaper_cube2"
android:name=".CubeWallpaper2"
android:permission="android.permission.BIND_WALLPAPER">
android:label="@string/cube2_settings"
android:name=".CubeWallpaper2Settings"
android:theme="@android:style/Theme.Light.WallpaperSettings"
android:exported="true">
