前言

　　本章内容是android.widget.MediaController，版本为Android 2.3 r1，翻译来自"唐明"，再次感谢"唐明" ！期待你一起参与Android 中文API的翻译，联系我over140@gmail.com。

声明

　　欢迎转载，但请保留文章原始出处:)

　　　　博客园：http://www.cnblogs.com/

　　　　Android中文翻译组：http://goo.gl/6vJQl

正文

　　一、结构

public classMediaController extendsFrameLayout

java.lang.Object

android.view.View

android.view.ViewGroup

android.widget.FrameLayout

android.widget.MediaController

　　二、类概述

　　一个包含媒体播放器(MediaPlayer)控件的视图。包含了一些典型的按钮，像"播放(Play)/暂停(Pause)", "倒带(Rewind)", "快进(Fast Forward)"与进度滑动器(progress slider)。它管理媒体播放器(MediaController)的状态以保持控件的同步。

　　通过编程来实例化使用这个类。这个媒体控制器将创建一个具有默认设置的控件，并把它们放到一个窗口里漂浮在你的应用程序上。具体来说，这些控件会漂浮在通过setAnchorView()指定的视图上。如果这个窗口空闲3秒那么它将消失，直到用户触摸这个视图的时候重现。

　　当媒体控制器是在一个XML布局资源文件中创建的时候，像show()和hide()这些函数是无效的。媒体播放器将根据这些规则去显示和隐藏：

　　　　 *在调用setPrevNextListeners()函数之前，"previous"和"next"按钮都是隐藏的。

　　　　 * 如果setPrevNextListeners() 函数被调用但传入的监听器参数是null ，那么"previous" 和"next" 按钮是可见的但是处于禁用状态。

　　　　 * "rewind" 和 "fastforward" 按钮是显示的，如果不需要可以使用构造函数 MediaController(Context, boolean) 将 boolean 设置为 false 。

　　三、公共方法

　　public booleandispatchKeyEvent(KeyEvent event)

　　在焦点路径上分发按钮事件到下一个视图。该路径从视图树的顶端遍历到当前获得焦点的视图。如果当前视图已获得焦点，就分发给自身。否则，就分发到下一个节点的焦点路径上。这个方法也可以激发任何一个按键消息监听器。

　　参数

　　event被分发的事件

　　返回值

　　如果这个事件被处理了返回true，否则返回false。

　　public voidhide()

　　从屏幕中移除控制器。

　　public booleanisShowing()

　　（译者注：判断媒体控制器是否处于可见状态。）

　　public voidonFinishInflate()

　　XML文件加载视图完成时调用。这个函数在加载的最后阶段被调用，所有的子视图已经被添加。

　　即使子类重写了onFinishInflate方法，也应该始终确保调用父类方法，以便我们调用。

　　public booleanonTouchEvent(MotionEvent event)

　　实现这个方法来处理触摸屏幕引发的事件。

　　参数

　　event动作事件

　　返回值

　　如果这个事件被处理了返回true，否则返回false。

　　public booleanonTrackballEvent(MotionEvent ev)

　　实现这个方法处理轨迹球的动作事件，轨迹球相对运动的最后一个事件能用MotionEvent.getX()和MotionEvent.getY()函数获取。这些都是标准化的，用1表示用户按下一个DPAD按键。（因此他们将经常使用小数值表示，为轨迹球提供更多的的细微运动信息）（译者注：DPAD按键事件: KeyEvent.KEYCODE_DPAD_CENTER（居中）、KeyEvent.KEYCODE_DPAD_DOWN（向下）、KeyEvent.KEYCODE_DPAD_LEFT（向左）、KeyEvent.KEYCODE_DPAD_RIGHT（向右）、KeyEvent.KEYCODE_DPAD_UP（向上）作比较。分别表示居中、下移、左移、右移、上移的操作。相关链接：onTrackBallEvent方法简介）

　　参数

ev动作事件

　　返回值

　如果这个事件被处理了返回true，否则返回false。

　　public void setAnchorView (View view)

　　设置这个控制器绑定(anchor/锚)到一个视图上。例如可以是一个VideoView对象，或者是你的activity的主视图。

　　参数

　　view 将视图来绑定控制器时可见

　　public voidsetEnabled(boolean enabled)

　　设置视图对象的有效状态。这也可以改变子类的有效状态。

　　参数

　　enabled如果要让这个视图对象可用就设置为true，否则设置为false。

　　public voidsetMediaPlayer(MediaController.MediaPlayerControl player)

　　（译者注：把这个媒体控制器设置到VideoView对象上。）

　　public voidsetPrevNextListeners(View.OnClickListener next, View.OnClickListener prev)

　　（译者注：设置"previous"和"next"按钮的监听器函数。）

　　public voidshow(int timeout)

　　在屏幕上显示这个控制器。它将在闲置’超时(timeout)’毫秒到达后自动消失。

　　参数

　　timeout这个参数以毫秒为单位。如果设置为0将一直显示到调用hide()函数为止。

　　public voidshow()

　　　　在屏幕上显示这个控制器。它将在 3 秒以后自动消失。

　　四、补充

　　文章精选

　　[推荐][Android学习指南]Android多媒体(Media)

　　　　　　调用android api播放视频

　　　　　　Customize android VideoView (ii)

Android(安卓)中文API （94） —— MediaController

前言

更多相关文章

随机推荐