前言

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

声明

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

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

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

正文

  一、结构

public class MediaController extends FrameLayout

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 boolean dispatchKeyEvent (KeyEvent event)

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

  参数

  event       被分发的事件

  返回值

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

  public void hide ()

  从屏幕中移除控制器。

  public boolean isShowing ()

  (译者注:判断媒体控制器是否处于可见状态。)

  public void onFinishInflate ()

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

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

  public boolean onTouchEvent (MotionEvent event)

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

  参数

  event       动作事件

  返回值

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

  public boolean onTrackballEvent (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 void setEnabled (boolean enabled)

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

  参数

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

  public void setMediaPlayer (MediaController.MediaPlayerControl player)

  (译者注:把这个媒体控制器设置到VideoView对象上。)

  public void setPrevNextListeners (View.OnClickListener next, View.OnClickListener prev)

  (译者注:设置"previous"和 "next"按钮的监听器函数。)

  public void show (int timeout)

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

  参数

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

  public void show ()

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

  四、补充

  文章精选

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

      调用android api播放视频

       Customize android VideoView (ii)

结束

  大家抱歉!年底非常忙,有所耽误进度,进来保持最低进度,争取年前(春节)也就是下周末前完成100篇的目标,感谢大家的支持,欢迎加入我们一起来坚持这项浩大的工程。

Android 中文API (94) —— MediaController相关推荐

  1. Android 中文 API 文档 (45) —— AbsoluteLayout.LayoutParams

    前言 本章内容是 android.widget.AbsoluteLayout.LayoutParams,版本为Android 2.2 r1,翻译来自"绵白糖",再次感谢" ...

  2. Android 中文API (92) —— MenuInflater

    前言 本章内容是android.view.MenuInflater,版本为Android 2.3 r1,翻译来自"獨鍆躌踄",欢迎大家访问他的博客:http://www.cnblo ...

  3. Android 中文 API (90) —— WindowManager

    一.结构 public interface WindowManager extends android.view.ViewManager android.view.WindowManager 二.概述 ...

  4. Android 中文API (70) —— BluetoothDevice[蓝牙]

    前言 本章内容是 android.bluetooth.BluetoothDevice,为Android蓝牙部分的章节翻译.蓝牙设备类,代表了蓝牙通讯国足中的远端设备.版本为 Android 2.3 r ...

  5. Android中文API(127) —— MessageQueue

    结构 继承关系 public class MessageQueue extends Object java.lang.Object android.os.MessageQueue 类概述 保存消息列表 ...

  6. android 中文 API (41) —— RatingBar.OnRatingBarChangeListener

    前言 本章内容是 android.widget.RatingBar.OnRatingBarChangeListener,版本为Android 2.2 r1,翻译来自madgoat,欢迎大家访问他的博客 ...

  7. Android 中文API (91) —— GestureDetector

    前言 本章内容是android.view.GestureDetector,版本为Android 2.3 r1,翻译来自"Haiya 胡蝶",再次感谢"Haiya 胡蝶&q ...

  8. Android 中文 API (93) —— BaseExpandableListAdapter

    前言 本章内容是android.widget.BaseExpandableListAdapter,版本为Android 2.3 r1,翻译来自"天涯明月刀",欢迎大家访问他的博客: ...

  9. Android 中文 API (19) —— TwoLineListItem

    一.结构 public class TwoLineListItem extends RelativeLayout java.lang.Object android.view.View android. ...

最新文章

  1. 从MySQL 5.6升级到8.0,Facebook付出了惨痛代价……
  2. assignment symbolic automaton verilog设计
  3. vscode怎么引用css_今天来安装一个骚气的 VS Code 主题
  4. WebApiClient百度地图服务接口实践
  5. jacoco入门_Android jacoco 代码覆盖率测试入门
  6. redirect_uri 域名与后配置不一致是什么意思_免费 amp; 无限的域名/企业邮箱
  7. 【shell编程基础0】bash shell编程的基本配置
  8. 第五:Python发送邮件时获取最新测试报告并发送邮件
  9. c++ 连接服务器源码,c++ socket最简单实例源码(含服务端以及客户端)
  10. .php on line 0,windows启动apache提示PHP Startup: in Unknown on line 0
  11. 实变函数与计算机有关系吗,《复变函数与实变函数》
  12. 四4层电梯三菱PLC程序带io表接线图
  13. maxscale跨库分片的限制
  14. JAVA音视频解决方案----开源jtt1078源码与沟通群
  15. 看懂555定时器,有哪些应用?
  16. Java个人网站设计与实现毕业
  17. 【小程序源码】团长头像制作小程序源码
  18. Cocos Creator ts版本使用protobuf
  19. stm32—酒精传感器的初步使用
  20. 伯恩光学赴港:背靠苹果、小米,能掀起多大资本浪花?

热门文章

  1. 分享:个人是怎么学习新知识的
  2. 为什么大家都推荐我学Linux
  3. Linq初级班 Linq To XML体验(基础篇)
  4. 烂泥:U盘安装Centos6.5
  5. 24个为Web开发人员准备的CSS3实用教程
  6. Ansible04-任务控制
  7. token拦截器阻止连接_如何防止广告拦截器阻止您的分析数据
  8. javascript_治愈JavaScript疲劳的研究计划
  9. glib 2.0 arm linux,glib源码安装使用方法
  10. L1-006 连续因子