Android SurfaceView

本文详细介绍了Android中的SurfaceView组件,包括其定义、特点、实现方法及典型应用场景。特别强调了SurfaceView如何支持双线程绘图机制,以提高游戏等高性能应用的表现。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

要了解SurfaceView我们先来看看官方的API文档:

  Provides a dedicated drawing surface embedded inside of a view hierarchy. You can control the format of this surface and, if you like, its size; the SurfaceView takes care of placing the surface at the correct location on the screen

  The surface is Z ordered so that it is behind the window holding its SurfaceView; the SurfaceView punches a hole in its window to allow its surface to be displayed. The view hierarchy will take care of correctly compositing with the Surface any siblings of the SurfaceView that would normally appear on top of it. This can be used to place overlays such as buttons on top of the Surface, though note however that it can have an impact on performance since a full alpha-blended composite will be performed each time the Surface changes.

  Access to the underlying surface is provided via the SurfaceHolder interface, which can be retrieved by calling getHolder().

  The Surface will be created for you while the SurfaceView's window is visible; you should implement surfaceCreated(SurfaceHolder) and surfaceDestroyed(SurfaceHolder) to discover when the Surface is created and destroyed as the window is shown and hidden.

  One of the purposes of this class is to provide a surface in which a secondary thread can render in to the screen. If you are going to use it this way, you need to be aware of some threading semantics:

  •All SurfaceView and SurfaceHolder.Callback methods will be called from the thread running the SurfaceView's window (typically the main thread of the application). They thus need to correctly synchronize with any state that is also touched by the drawing thread. 
  You must ensure that the drawing thread only touches the underlying Surface while it is valid -- between SurfaceHolder.Callback.surfaceCreated() and SurfaceHolder.Callback.surfaceDestroyed(). 
对应的中文翻译
  SurfaceView是视图(View)的继承类,这个视图里内嵌了一个专门用于绘制的Surface。你可以控制这个Surface的格式和尺寸。Surfaceview控制这个Surface的绘制位置。

  surface是纵深排序(Z-ordered)的,这表明它总在自己所在窗口的后面。surfaceview提供了一个可见区域,只有在这个可见区域内 的surface部分内容才可见,可见区域外的部分不可见。

  surface的排版显示受到视图层级关系的影响,它的兄弟视图结点会在顶端显示。这意味者 surface的内容会被它的兄弟视图遮挡,这一特性可以用来放置遮盖物(overlays)(例如,文本和按钮等控件)。注意,如果surface上面 有透明控件,那么它的每次变化都会引起框架重新计算它和顶层控件的透明效果,这会影响性能。

  你可以通过SurfaceHolder接口访问这个surface,getHolder()方法可以得到这个接口。surfaceview变得可见时,surface被创建;surfaceview隐藏前,surface被销毁。这样能节省资源。如果你要查看 surface被创建和销毁的时机,可以重载surfaceCreated(SurfaceHolder)和 surfaceDestroyed(SurfaceHolder)。

surfaceview的核心在于提供了两个线程:UI线程和渲染线程。这里应注意:

   1> 所有SurfaceView和SurfaceHolder.Callback的方法都应该在UI线程里调用,一般来说就是应用程序主线程。渲染线程所要访问的各种变量应该作同步处理。

   2> 由于surface可能被销毁,它只在SurfaceHolder.Callback.surfaceCreated()和 SurfaceHolder.Callback.surfaceDestroyed()之间有效,所以要确保渲染线程访问的是合法有效的surface。

接下说说自己的理解:

1、定义

可以直接从内存或者DMA等硬件接口取得图像数据,是个非常重要的绘图容器。

它的特性是:可以在主线程之外的线程中向屏幕绘图上。这样可以避免画图任务繁重的时候造成主线程阻塞,从而提高了程序的反应速度。在游戏开发中多用到SurfaceView,游戏中的背景、人物、动画等等尽量在画布canvas中画出。

2、实现

首先继承SurfaceView并实现SurfaceHolder.Callback接口
使用接口的原因:因为使用SurfaceView 有一个原则,所有的绘图工作必须得在Surface 被创建之后才能开始(Surface—表面,这个概念在 图形编程中常常被提到。基本上我们可以把它当作显存的一个映射,写入到Surface 的内容可以被直接复制到显存从而显示出来,这使得显示速度会非常快),而在Surface 被销毁之前必须结束。所以Callback 中的surfaceCreated 和surfaceDestroyed 就成了绘图处理代码的边界。

需要重写的方法

 (1)public void surfaceChanged(SurfaceHolder holder,int format,int width,int height){}

     //在surface的大小发生改变时激发

 (2)public void surfaceCreated(SurfaceHolder holder){}

     //在创建时激发,一般在这里调用画图的线程。

 (3)public void surfaceDestroyed(SurfaceHolder holder) {}

     //销毁时激发,一般在这里将画图的线程停止、释放。

整个过程:继承SurfaceView并实现SurfaceHolder.Callback接口 ----> SurfaceView.getHolder()获得SurfaceHolder对象 ---->SurfaceHolder.addCallback(callback)添加回调函数---->SurfaceHolder.lockCanvas()获得Canvas对象并锁定画布----> Canvas绘画 ---->SurfaceHolder.unlockCanvasAndPost(Canvas canvas)结束锁定画图,并提交改变,将图形显示。


3、SurfaceHolder
这里用到了一个类SurfaceHolder,可以把它当成surface的控制器,用来操纵surface。处理它的Canvas上画的效果和动画,控制表面,大小,像素等。
几个需要注意的方法:
(1)、abstract void addCallback(SurfaceHolder.Callback callback);
// 给SurfaceView当前的持有者一个回调对象。
(2)、abstract Canvas lockCanvas();
// 锁定画布,一般在锁定后就可以通过其返回的画布对象Canvas,在其上面画图等操作了。
(3)、abstract Canvas lockCanvas(Rect dirty);
// 锁定画布的某个区域进行画图等..因为画完图后,会调用下面的unlockCanvasAndPost来改变显示内容。
// 相对部分内存要求比较高的游戏来说,可以不用重画dirty外的其它区域的像素,可以提高速度。
(4)、abstract void unlockCanvasAndPost(Canvas canvas);
// 结束锁定画图,并提交改变。

4、实例

这里的例子实现了一个矩形和一个计时器

View Code 
 package xl.test;
 
 import android.app.Activity;
 import android.content.Context;
 import android.graphics.Canvas;
 import android.graphics.Color;
 import android.graphics.Paint;
 import android.graphics.Rect;
 import android.os.Bundle;
 import android.view.SurfaceHolder;
 import android.view.SurfaceView;
 
 public class ViewTest extends Activity {
     /** Called when the activity is first created. */
     @Override
     public void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(new MyView(this));
     }
     //视图内部类
     class MyView extends SurfaceView implements SurfaceHolder.Callback
     {
         private SurfaceHolder holder;
         private MyThread myThread; 
         public MyView(Context context) {
             super(context);
             // TODO Auto-generated constructor stub
             holder = this.getHolder();
             holder.addCallback(this);
             myThread = new MyThread(holder);//创建一个绘图线程
         }
 
         @Override
         public void surfaceChanged(SurfaceHolder holder, int format, int width,
                 int height) {
             // TODO Auto-generated method stub
             
         }
 
         @Override
         public void surfaceCreated(SurfaceHolder holder) {
             // TODO Auto-generated method stub
             myThread.isRun = true;
             myThread.start();
         }
 
         @Override
         public void surfaceDestroyed(SurfaceHolder holder) {
             // TODO Auto-generated method stub
             myThread.isRun = false;
         }
         
     }
     //线程内部类
     class MyThread extends Thread
     {
         private SurfaceHolder holder;
         public boolean isRun ;
         public  MyThread(SurfaceHolder holder)
         {
             this.holder =holder; 
             isRun = true;
         }
         @Override
         public void run()
         {
             int count = 0;
             while(isRun)
             {
                 Canvas c = null;
                 try
                 {
                     synchronized (holder)
                     {
                         c = holder.lockCanvas();//锁定画布,一般在锁定后就可以通过其返回的画布对象Canvas,在其上面画图等操作了。
                         c.drawColor(Color.BLACK);//设置画布背景颜色
                         Paint p = new Paint(); //创建画笔
                         p.setColor(Color.WHITE);
                         Rect r = new Rect(100, 50, 300, 250);
                         c.drawRect(r, p);
                         c.drawText("这是第"+(count++)+"秒", 100, 310, p);
                         Thread.sleep(1000);//睡眠时间为1秒
                     }
                 }
                 catch (Exception e) {
                     // TODO: handle exception
                     e.printStackTrace();
                 }
                 finally
                 {
                     if(c!= null)
                     {
                         holder.unlockCanvasAndPost(c);//结束锁定画图,并提交改变。
 
                     }
                 }
             }
         }
     }
 }

### Android SurfaceView 使用教程及常见问题解决方案 #### 一、SurfaceView 的基本概念 `SurfaceView` 创建了一个位于应用窗口之后的新窗口,在视图层次结构上仿佛穿了个“洞”,使得绘图层可以直接显示出来。这种机制意味着 `SurfaceView` 刷新时不需重绘整个应用程序窗口,因此效率较高[^3]。 #### 二、初始化与配置 为了正确使用 `SurfaceView` 进行视频播放或其他多媒体处理任务,开发者应当确保已经适当地设置了该组件的相关属性: - **布局文件定义** ```xml <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/container" android:layout_width="match_parent" android:layout_height="match_parent"> <SurfaceView android:id="@+id/surface_view" android:layout_width="wrap_content" android:layout_height="wrap_content"/> </FrameLayout> ``` - **Java/Kotlin 中的初始化** ```java public class VideoPlayerActivity extends AppCompatActivity { private SurfaceView mSurfaceView; private MediaPlayer mediaPlayer; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_video_player); mSurfaceView = findViewById(R.id.surface_view); // 获取并监听 SurfaceHolder 对象的变化事件 final SurfaceHolder holder = mSurfaceView.getHolder(); holder.addCallback(new SurfaceHolder.Callback() { public void surfaceCreated(SurfaceHolder sh){ try{ // 当表面创建成功后准备媒体播放器 prepareMediaPlayer(sh); }catch(Exception e){ Log.e("Error", "Unable to create media player"); } } public void surfaceChanged(SurfaceHolder sh, int format, int width, int height){} public void surfaceDestroyed(SurfaceHolder sh){mediaPlayer.release();} }); } private void prepareMediaPlayer(SurfaceHolder holder)throws Exception{ Uri videoUri = /* your uri */; mediaPlayer = new MediaPlayer(); mediaPlayer.setDisplay(holder); // 关联到指定的 SurfaceHolder 上 mediaPlayer.setDataSource(this, videoUri); mediaPlayer.prepareAsync(); // 非阻塞式加载资源 mediaPlayer.setOnPreparedListener(mp -> mp.start()); } } ``` 上述代码展示了如何通过 Java 初始化 `SurfaceView` 并关联至 `MediaPlayer` 实现简单的视频回放功能[^1]。 #### 三、解决仅有音频无图像的问题 如果在实际项目中遇到了仅能听到声音却看不到画面的情况,则可能是因为所选编码格式不被当前设备支持或者是由于未能恰当设定 `SurfaceView` 显示范围等因素引起。此时建议检查以下几点: - 确认使用的编解码库版本兼容目标平台; - 检查是否已调用了 `setFixedSize()` 方法来固定 `SurfaceView` 尺寸大小; - 如果采用自定义渲染逻辑,请验证是否有误置或遗漏重要参数传递给底层 API 函数。 #### 四、关于无法从 `SurfaceView` 抽取位图数据的现象解释 不同于常规 View 组件能够轻易地利用其 draw(Canvas canvas) 接口完成屏幕截图等功能,`SurfaceView` 却不具备这样的能力。这是因为它的绘制过程发生在独立于主线程之外的一个特殊线程里,而且并不参与标准 UI 渲染流程的一部分。对于希望捕获此类控件内部内容的应用场景来说,通常需要借助其他手段间接达成目的,例如直接访问摄像头帧缓冲区或是录制期间保存原始流文件后再做进一步加工处理[^2]。 #### 五、性能优化与其他注意事项 考虑到 `SurfaceView` 特殊的工作原理及其带来的局限性——诸如难以实施复杂动画效果转换以及不适合嵌入滚动容器内等问题,在设计界面时应充分权衡利弊做出合理抉择。另外值得注意的是,尽管可以通过调整 alpha 属性改变透明度,但这并不会影响到最终呈现在用户眼前的视觉表现形式;真正想要达到类似的效果往往涉及到更深层次的画面合成技术层面的操作[^4]。 最后提醒各位开发者关注官方文档更新情况及时掌握最新特性变动趋势,以便更好地应对可能出现的各种挑战[^5]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值