?
Dieses Dokument verwendet PHP-Handbuch für chinesische Websites Freigeben
MediaController
版本：Android 2.3 r1
?
結構
繼承關系
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)的狀態(tài)以保持控件的同步。
通過編程來實例化使用這個類。這個媒體控制器將創(chuàng)建一個具有默認設置的控件，并把它們放到一個窗口里漂浮在你的應用程序上。具體來說，這些控件會漂浮在通過setAnchorView()指定的視圖上。如果這個窗口空閑3秒那么它將消失，直到用戶觸摸這個視圖的時候重現(xiàn)。
當媒體控制器是在一個XML布局資源文件中創(chuàng)建的時候，像show()和 hide()這些函數(shù)是無效的。媒體播放器將根據(jù)這些規(guī)則去顯示和隱藏：
- 在調用setPrevNextListeners()函數(shù)之前，"previous"和 "next"按鈕都是隱藏的。
- 如果setPrevNextListeners()函數(shù)被調用但傳入的監(jiān)聽器參數(shù)是null，那么"previous"和 "next"按鈕是可見的但是處于禁用狀態(tài)。
- "rewind" 和 "fastforward"按鈕是顯示的，如果不需要可以使用構造函數(shù)MediaController(Context, boolean)將boolean設置為false。
?
公共方法
public boolean dispatchKeyEvent (KeyEvent event)
在焦點路徑上分發(fā)按鈕事件到下一個視圖。該路徑從視圖樹的頂端遍歷到當前獲得焦點的視圖。如果當前視圖已獲得焦點，就分發(fā)給自身。否則，就分發(fā)到下一個節(jié)點的焦點路徑上。這個方法也可以激發(fā)任何一個按鍵消息監(jiān)聽器。
參數(shù)
event ????? 被分發(fā)的事件
返回值
如果這個事件被處理了返回true，否則返回false。
?
public void hide ()
從屏幕中移除控制器。
?
public boolean isShowing ()
（譯者注：判斷媒體控制器是否處于可見狀態(tài)。）
?
public void onFinishInflate ()
XML文件加載視圖完成時調用。這個函數(shù)在加載的最后階段被調用，所有的子視圖已經被添加。
即使子類重寫了onFinishInflate方法，也應該始終確保調用父類方法，以便我們調用。
?
public boolean onTouchEvent (MotionEvent event)
實現(xiàn)這個方法來處理觸摸屏幕引發(fā)的事件。
參數(shù)
event ????? 動作事件
返回值
如果這個事件被處理了返回true，否則返回false。
?
public boolean onTrackballEvent (MotionEvent ev)
實現(xiàn)這個方法處理軌跡球的動作事件，軌跡球相對運動的最后一個事件能用MotionEvent.getX() 和 MotionEvent.getY()函數(shù)獲取。這些都是標準化的，用1表示用戶按下一個DPAD按鍵。（因此他們將經常使用小數(shù)值表示，為軌跡球提供更多的的細微運動信息） （譯者注：DPAD按鍵事件:
KeyEvent.KEYCODE_DPAD_CENTER（居中）、KeyEvent.KEYCODE_DPAD_DOWN（向下）、KeyEvent.KEYCODE_DPAD_LEFT（向左）、KeyEvent.KEYCODE_DPAD_RIGHT（向右）、KeyEvent.KEYCODE_DPAD_UP（向上）作比較。分別表示居中、下移、左移、右移、上移的操作。
相關鏈接：onTrackBallEvent方法簡介
）
參數(shù)
ev ?? 動作事件
返回值
??? ???????? 如果這個事件被處理了返回true，否則返回false。
?
?
public void setAnchorView (View view)
設置這個控制器綁定(anchor/錨)到一個視圖上。例如可以是一個VideoView對象，或者是你的activity的主視圖。
參數(shù)
view ? 將視圖來綁定控制器時可見
?
public void setEnabled (boolean enabled)
設置視圖對象的有效狀態(tài)。這也可以改變子類的有效狀態(tài)。
參數(shù)
enabled 如果要讓這個視圖對象可用就設置為true，否則設置為false。
?
public void setMediaPlayer (MediaController.MediaPlayerControl player)
（譯者注：把這個媒體控制器設置到VideoView對象上。）
?
public void setPrevNextListeners (View.OnClickListener next, View.OnClickListener prev)
（譯者注：設置"previous"和 "next"按鈕的監(jiān)聽器函數(shù)。）
?
public void show (int timeout)
在屏幕上顯示這個控制器。它將在閑置’超時 (timeout)’毫秒到達后自動消失。
參數(shù)
timeout 這個參數(shù)以毫秒為單位。如果設置為0將一直顯示到調用hide()函數(shù)為止。
?
public void show ()
在屏幕上顯示這個控制器。它將在3秒以后自動消失。
?
補充
文章精選
[推薦][Android學習指南]Android多媒體(Media)
調用android api播放視頻
Customize android VideoView (ii)
?