MediaSession 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。
[Android.Runtime.Register("android/media/session/MediaSession", DoNotGenerateAcw=true)]
public sealed class MediaSession : Java.Lang.Object
[<Android.Runtime.Register("android/media/session/MediaSession", DoNotGenerateAcw=true)>]
type MediaSession = class
inherit Object
- 繼承
- 屬性
備註
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。
當應用程式想要發布媒體播放資訊或處理媒體鍵時,應建立 MediaSession。 一般來說,應用程式只需一個會話即可播放所有播放,但也可以建立多個會話,以提供更細緻的媒體控制。
一旦建立一個會話,該會話的擁有者可能會將其傳達 #getSessionToken() session token 給其他程序,讓他們能夠建立 MediaController 一個與該會話互動。
要接收指令、媒體鍵及其他事件,必須將 a Callback 設定為 #setCallback(Callback)。 要讓該會話能被其他應用程式(包括系統應用程式 #setActive(boolean) setActive(true) )發現,必須呼叫。
當應用程式完成播放後,必須呼叫 #release() 以清理會話並通知所有控制器。
MediaSession 物件是執行緒安全的。
的 android.media.session.MediaSessionJava 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
| 名稱 | Description |
|---|---|
| MediaSession(Context, String, Bundle, String) |
建立一個與呼叫應用程式不同會話擁有者的新會話。 |
| MediaSession(Context, String, Bundle) |
建立一個新的會話。 |
| MediaSession(Context, String) |
建立一個新的會話。 |
欄位
| 名稱 | Description |
|---|---|
| FlagHandlesMediaButtons |
在會話上設定此旗標,表示它能處理媒體按鈕事件。 |
| FlagHandlesTransportControls |
在會話上設定此旗標,表示它透過 |
屬性
| 名稱 | Description |
|---|---|
| Active |
查看本次會話目前的活躍狀態。 |
| Class |
回傳此 |
| Controller |
這次遊戲要買一個控制器。 |
| CurrentControllerInfo |
取得發送當前請求的控制者資訊。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 (繼承來源 JavaObject) |
| JniPeerMembers |
取得用於存取此 Java 綁定成員的 JNI 元資料。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| SessionToken |
取得一個 token 物件,讓應用程式用來建立與此會話互動的 。 |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 Object) |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 Object) |
方法
| 名稱 | Description |
|---|---|
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 (繼承來源 JavaObject) |
| Equals(Object) |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetBitmapSizeLimit(Context) |
從指定的情境取得媒體元資料位圖大小限制 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Release() |
當應用程式完成播放後,必須呼叫此程序。 |
| SendSessionEvent(String, Bundle) |
向所有正在聆聽此會話的 MediaController 發送專有事件。 |
| SetCallback(MediaSession+Callback, Handler) |
設定回撥以接收 MediaSession 的更新。 |
| SetCallback(MediaSession+Callback) |
設定回撥以接收 MediaSession 的更新。 |
| SetExtras(Bundle) |
設定一些可以與 |
| SetFlags(MediaSessionFlags) |
為這次會談設置任何旗幟。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetMediaButtonBroadcastReceiver(ComponentName) |
設定應接收媒體按鈕的 manifest 宣告 |
| SetMediaButtonReceiver(PendingIntent) |
為媒體按鈕接收器設定待處理意圖,允許在會話結束後重新播放。 |
| SetMetadata(MediaMetadata) |
更新目前的元資料。 |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 (繼承來源 JavaObject) |
| SetPlaybackState(PlaybackState) |
更新目前的播放狀態。 |
| SetPlaybackToLocal(AudioAttributes) |
設定本場次音訊的屬性。 |
| SetPlaybackToRemote(VolumeProvider) |
將此會話設定為使用遠端磁碟處理。 |
| SetQueue(IList<MediaSession.QueueItem>) |
更新遊戲佇列中的物品清單。 |
| SetQueueTitle(ICharSequence) |
設定遊戲隊列的標題。 |
| SetQueueTitle(String) |
設定遊戲隊列的標題。 |
| SetRatingType(RatingStyle) |
設定本場次使用的評分風格。 |
| SetSessionActivity(PendingIntent) |
為本次會話設定啟動 UI 的意圖。 |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒,通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
允許與媒體控制器、音量鍵、媒體按鈕及傳輸控制互動。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |