語言

VirtualDisplayFlags 列舉

定義

此列舉支援其成員值的位元組合。

[System.Flags]
public enum VirtualDisplayFlags
[<System.Flags>]
type VirtualDisplayFlags = 
繼承
VirtualDisplayFlags
屬性

欄位

名稱 值 Description
Public 1

虛擬展示旗幟:建立一個公開展示。

公開虛擬展示

當此旗標設定時,虛擬顯示為公開。

公共虛擬顯示器的行為與大多數連接系統的顯示器(如外部或無線顯示器)相同。 應用程式可以在顯示器上開啟視窗,系統也可能將其他顯示器的內容鏡像到該視窗上。

建立一個不侷限於自有內容的公開虛擬顯示,隱含地產生自動鏡像顯示。 請參閱VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR,了解誰可以建立自動鏡像顯示的限制。

當未設定此旗標時,虛擬顯示依照Display.FLAG_PRIVATE顯示旗標定義為私有。

私有虛擬顯示屬於創建它的應用程式。 只有擁有私有虛擬顯示器的擁有者,以及該顯示器上已經存在的應用程式,才被允許在上面放置視窗。 更精確地說,只有那些與原始建立私有虛擬顯示的應用程式擁有相同 UID 或已存在於該顯示器上的活動的程序,才被允許列舉或互動私有顯示。

Android 參考資料。android.hardware.display.DisplayManager.VIRTUAL_DISPLAY_FLAG_PUBLIC

Presentation 2

虛擬展示旗幟:建立簡報展示。

展示虛擬展示

當此旗標被設定時,虛擬顯示器會被註冊為簡報顯示,屬於簡報顯示類別。 應用程式可自動將內容投射至呈現顯示器,以提供更豐富的第二螢幕體驗。

當此旗標未設定時,虛擬顯示器不會被註冊為簡報顯示器。 應用程式仍可將內容投射到顯示器上,但通常不會自動投射。 此選項適合較特殊用途的顯示器。

Android 參考資料。android.hardware.display.DisplayManager.VIRTUAL_DISPLAY_FLAG_PRESENTATION

Secure 4

虛擬顯示旗標:建立一個安全的顯示。

安全虛擬顯示器

當此標誌被設定時,虛擬顯示器即被視為安全,依照Display.FLAG_SECURE顯示標誌定義。 來電者承諾採取合理措施,例如空中加密,以防止顯示內容被攔截或錄製到持久媒介上。

建立安全的虛擬顯示需要CAPTURE_SECURE_VIDEO_OUTPUT的許可。 此權限保留給系統元件使用,第三方應用程式無法使用。

當此旗標未被設定時,虛擬顯示被視為不安全。 若此顯示器顯示安全視窗的內容將被清空。

Android 參考資料。android.hardware.display.DisplayManager.VIRTUAL_DISPLAY_FLAG_SECURE

OwnContentOnly 8

虛擬顯示旗標:僅顯示本顯示器自身內容;不要鏡像其他顯示器的內容。

此旗幟與VIRTUAL_DISPLAY_FLAG_PUBLIC配合使用。 通常,公開的虛擬顯示器如果沒有自己的視窗,會自動鏡像預設顯示的內容。 當指定此標誌時,虛擬顯示器只會顯示自身內容,若沒有視窗則會被清空。

這面旗幟與VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR互斥。 若同時指定兩個標誌,則會套用僅限 own-content 的行為。

當VIRTUAL_DISPLAY_FLAG_PUBLIC與VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR尚未設定時,此旗幟的行為便被暗示。 此旗標僅用於在建立公開顯示時覆寫預設行為。

Android 參考資料。android.hardware.display.DisplayManager.VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY

AutoMirror 16

虛擬顯示旗標:允許在沒有內容顯示時,將內容鏡像到私人顯示器上。

這面旗幟與VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY互斥。 若同時指定兩個標誌,則會套用僅限 own-content 的行為。

當VIRTUAL_DISPLAY_FLAG_PUBLIC設定且VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY尚未設定時,該旗標的行為便會被隱含。 此旗標僅用於在建立私有顯示時覆寫預設行為。

建立自動鏡像虛擬顯示需要取得CAPTURE_VIDEO_OUTPUT或CAPTURE_SECURE_VIDEO_OUTPUT權限。 這些權限保留給系統元件使用,第三方應用程式無法使用。 或者,也可以使用適當的 MediaProjection 來建立自動鏡像虛擬顯示器。

Android 參考資料。android.hardware.display.DisplayManager.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR

備註

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於