MediaProjectionManager.GetMediaProjection(Int32, Intent) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
MediaProjection
擷取從成功的螢幕擷取要求取得的 。
[Android.Runtime.Register("getMediaProjection", "(ILandroid/content/Intent;)Landroid/media/projection/MediaProjection;", "")]
public Android.Media.Projection.MediaProjection? GetMediaProjection (int resultCode, Android.Content.Intent resultData);
[<Android.Runtime.Register("getMediaProjection", "(ILandroid/content/Intent;)Landroid/media/projection/MediaProjection;", "")>]
member this.GetMediaProjection : int * Android.Content.Intent -> Android.Media.Projection.MediaProjection
參數
- resultCode
- Int32
來自的結果碼 Activity#onActivityResult(int, int, Intent)
onActivityResult(int, int, Intent)
。
- resultData
- Intent
來自的結果數據 Activity#onActivityResult(int, int, Intent)
onActivityResult(int, int, Intent)
。
傳回
從成功的螢幕擷取要求取得的媒體投影,如果螢幕擷取要求的結果不是 Activity#RESULT_OK RESULT_OK
,則為 null。
- 屬性
備註
MediaProjection
擷取從成功的螢幕擷取要求取得的 。 要求的結果碼和數據會透過覆寫 Activity#onActivityResult(int, int, Intent) onActivityResult(int, int, Intent)
來提供,這會在使用 #createScreenCaptureIntent()
啟動活動之後呼叫。
從 Android android.os.Build.VERSION_CODES#R R
開始,如果您的應用程式要求 android.Manifest.permission#SYSTEM_ALERT_WINDOW SYSTEM_ALERT_WINDOW
許可權,且使用者尚未明確拒絕許可權,則許可權將會自動授與,直到投影停止為止。 許可權可讓您的應用程式在所擷取的畫面頂端顯示使用者控件。
以 SDK 版本或更新版本 android.os.Build.VERSION_CODES#Q Q
為目標的應用程式在執行前景服務時,必須叫 getMediaProjection
用和維護擷取工作階段 (MediaProjection#createVirtualDisplay(String, int, int, int, int, Surface, android.hardware.display.VirtualDisplay.Callback, Handler) MediaProjection#createVirtualDisplay
)。 應用程式必須在 c>& 中會屬性設定為<android.content.pm.ServiceInfo#FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
android.R.attr#foregroundServiceType foregroundServiceType
lt;service&燃氣輪機;<應用程式指令清單檔的 /c> 元素。
針對以 SDK 版本或更新版本 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE U
為目標的應用程式,用戶必須先將具有啟動投影許可權的應用程式授與應用程式,才能啟動具有 類型的 android.content.pm.ServiceInfo#FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
前景服務。 此外,應用程式必須先以該類型啟動前景服務,再在這裡呼叫此 API,否則除非它是具特殊許可權的應用程式,否則它會收到 SecurityException
來自此 API 呼叫的 。 應用程式可以透過 #createScreenCaptureIntent()
和 Activity#startActivityForResult(Intent, int)
(或類似的 API) 要求許可權。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。