Açıklama
Ekran meta verilerini sorgulamak için system.display
API'yi kullanın.
İzinler
system.display
Türler
ActiveState
Ekranın sistem tarafından algılanıp kullanıldığını belirten bir numaralandırma. Ekran, sistem tarafından algılanmazsa (bağlantısı kesilmiş veya uyku modu nedeniyle bağlantısı kesilmiş olarak kabul edilirse) "etkin değil" olarak kabul edilir. Bu durum, örneğin tüm ekranların bağlantısı kesildiğinde mevcut ekranı korumak için kullanılır.
Enum
"inactive" (etkin değil)
Bounds
Özellikler
-
yükseklik
sayı
Ekranın piksel cinsinden yüksekliği.
-
sol
sayı
Sol üst köşenin x koordinatı.
-
ilk yarı
sayı
Sol üst köşenin y koordinatı.
-
genişlik
sayı
Ekranın piksel cinsinden genişliği.
DisplayLayout
Özellikler
-
id
dize
Ekranın benzersiz tanımlayıcısıdır.
-
ofset
sayı
Bağlı kenar boyunca ekranın ofseti. 0, en üstteki veya en soldaki köşelerin hizalandığını gösterir.
-
parentId
dize
Üst ekranın benzersiz tanımlayıcısı. Bu kökse boş olur.
-
position
Bu ekranın üst öğeye göre düzen konumu. Bu, kök için yoksayılır.
DisplayMode
Özellikler
-
deviceScaleFactor
sayı
Görüntüleme modu cihaz ölçek faktörü.
-
yükseklik
sayı
Cihazdan bağımsız (kullanıcı tarafından görülebilen) piksel cinsinden görüntüleme modu yüksekliği.
-
heightInNativePixels
sayı
Yerel piksel cinsinden görüntüleme modu yüksekliği.
-
isInterlaced
boole isteğe bağlı
Chrome 74 ve sonraki sürümlerBu mod aralıklıysa doğru değerini, sağlanmamışsa false (yanlış) değerini alır.
-
isNative
boolean
Mod, ekranın yerel moduysa doğru değerini alır.
-
isSelected
boolean
Görüntü modu seçiliyse doğru değerini alır.
-
refreshRate
sayı
Chrome 67 ve sonraki sürümlerHertz cinsinden görüntü modu yenileme hızı.
-
uiScale
numara isteğe bağlı
Chrome 70'ten itibaren kullanımdan kaldırıldıdisplayZoomFactor
hareketini kullanınGörüntü modu kullanıcı arayüzü ölçek faktörü.
-
genişlik
sayı
Cihazdan bağımsız (kullanıcının görebileceği) pikseller cinsinden görüntü modu genişliği.
-
widthInNativePixels
sayı
Yerel piksel cinsinden görüntüleme modu genişliği.
DisplayProperties
Özellikler
-
boundsOriginX
numara isteğe bağlı
Ayarlanırsa ekranın mantıksal sınırları başlangıç noktasını x ekseni boyunca günceller.
boundsOriginY
ile birlikte uygulandı. Ayarlanmazsa veboundsOriginY
ayarlanmışsa varsayılan olarak geçerli değere ayarlanır. Görüntüleme kaynağını güncellerken bazı kısıtlamaların uygulanacağını, bu nedenle nihai sınırların kaynağının kümeden farklı olabileceğini unutmayın. Son sınırlar,getInfo
kullanılarak alınabilir. Sınırların kaynağı birincil ekranda değiştirilemez. -
boundsOriginY
numara isteğe bağlı
Ayarlanırsa y ekseni boyunca ekranın mantıksal sınırlarının başlangıç noktasını günceller.
boundsOriginX
parametresiyle ilgili dokümanlara bakın. -
displayMode
DisplayMode isteğe bağlı
Chrome 52 ve sonraki sürümlerAyarlanırsa görüntü modunu bu değere uygun moda günceller. Diğer parametreler geçersizse bu, uygulanmaz. Görüntü modu geçersizse uygulanmaz ve bir hata ayarlanır, ancak diğer özellikler uygulanmaya devam eder.
-
displayZoomFactor
numara isteğe bağlı
Chrome 65 ve sonraki sürümlerAyarlanırsa ekranla ilişkili yakınlaştırmayı günceller. Bu zum, düzenleme ve yeniden boyama yaparak yalnızca piksel piksel genişletmeden daha kaliteli bir yakınlaştırma sağlar.
-
isPrimary
boole isteğe bağlı
Doğru değerine ayarlanırsa ekranı birincil yapar. Yanlış değerine ayarlanırsa işlem yok. Not: Ayarlandığında ekran, diğer tüm mülkler için birincil olarak kabul edilir (ör.
isUnified
ayarlanabilir ve sınırlar başlangıç noktası ayarlanamayabilir). -
isUnified
boole isteğe bağlı
Chrome 59 ve sonraki sürümlerYalnızca Chrome OS. Doğru değerine ayarlanırsa görüntüleme modunu birleştirilmiş masaüstü olarak değiştirir (ayrıntılar için
enableUnifiedDesktop
sayfasına bakın). Bu politika yanlış değerine ayarlanırsa birleştirilmiş masaüstü modu devre dışı bırakılır. Bu yalnızca birincil ekran için geçerlidir. Değer sağlanırsa mirroringSourceId sağlanmamalıdır ve diğer özellikler yoksayılır. Sağlanmazsa hiçbir etkisi olmaz. -
mirroringSourceId
string isteğe bağlı
Chrome 68'den itibaren kullanımdan kaldırıldısetMirrorMode
hesabını kullanın.Yalnızca Chrome OS. Ayarlanırsa ve boş bırakılmazsa yalnızca bu ekran için yansıtma etkinleştirilir. Aksi takdirde, yansıtma tüm ekranlar için devre dışı bırakılır. Bu değer, yansıtılacak kaynak ekranın kimliğini belirtmelidir ve bu kimlik, setDisplayProperties'e iletilen kimlikle aynı olmamalıdır. Ayarlanırsa başka bir özellik ayarlanamaz.
-
fazla tarama
Insets isteğe bağlı
Ayarlanırsa ekranın fazla tarama eklerini sağlanan değerlere ayarlar. Fazla tarama değerlerinin negatif veya ekran boyutunun yarısından daha büyük olmayabileceğini unutmayın. Fazla tarama, dahili monitörden değiştirilemez.
-
rotasyon
numara isteğe bağlı
Ayarlanırsa ekranın dönüşünü günceller. Yasal değerler [0, 90, 180, 270] şeklindedir. Döndürme, ekranın dikey konumuna göre saat yönünde ayarlanır.
DisplayUnitInfo
Özellikler
-
activeStateChrome 117 ve sonraki sürümler
Ekran sistem tarafından algılanıp kullanılıyorsa etkin olur.
-
availableDisplayZoomFactors
numara[]
Chrome 67 ve sonraki sürümlerEkran için ayarlanabilecek yakınlaştırma faktörü değerlerinin listesi.
-
sınırlar
Ekranın mantıksal sınırları.
-
displayZoomFactor
sayı
Chrome 65 ve sonraki sürümlerEkranın mevcut yakınlaştırma ve varsayılan yakınlaştırma oranı. Örneğin, değer 1% 100 yakınlaştırmaya, 1,5 değeri% 150 yakınlaştırmaya eş değerdir.
-
dpiX
sayı
X ekseni boyunca inç başına piksel sayısı.
-
dpiY
sayı
Y ekseni boyunca inç başına piksel sayısı.
-
EID
Edid isteğe bağlı
Chrome 67 ve sonraki sürümlerNOT: Bu özellik yalnızca Chrome OS Kiosk uygulamaları ve Web kullanıcı arayüzü için kullanılabilir.
-
hasTouchSupport
boolean
Chrome 57 ve sonraki sürümlerBu ekranla ilişkilendirilmiş bir dokunmatik giriş cihazı varsa doğru değerini alır.
-
id
dize
Ekranın benzersiz tanımlayıcısıdır.
-
isEnabled
boolean
Bu ekran etkinse doğru değerini alır.
-
isPrimary
boolean
Bu, birincil ekransa True (doğru) değerini alır.
-
isUnified
boolean
Chrome 59 ve sonraki sürümlerBirleştirilmiş masaüstü modundayken tüm ekranlarda doğru değerini alır.
enableUnifiedDesktop
belgelerine bakın. -
mirroringDestinationIds
dize[]
Chrome 64 ve sonraki sürümlerYalnızca Chrome OS. Kaynak ekranının yansıtıldığı ekranların tanımlayıcıları. Yansıtılan ekran yoksa boş bırakın. Bu, tüm ekranlar için aynı değere ayarlanır. Bu,
mirroringSourceId
içermemelidir. -
mirroringSourceId
dize
Yalnızca Chrome OS. Yansıtma etkinse yansıtılmakta olan ekranın tanımlayıcısı. Yansıtma etkinse boştur. Bu ayar, tüm ekranlar (yansıtılan ekran dahil) için ayarlanır.
-
modesChrome 52 ve sonraki sürümler
Kullanılabilir görüntü modlarının listesi. Mevcut modda isSelected=true olacaktır. Yalnızca Chrome OS'te kullanılabilir. Diğer platformlarda boş bir dizi olarak ayarlanacak.
-
ad
dize
Kullanımı kolay bir ad (ör. "HP LCD monitör").
-
fazla tarama
Ekranın sınırları dahilinde ekranın ek öğeleri. Şu anda yalnızca ChromeOS'te kullanıma sunulmuştur. Diğer platformlarda boş ek olarak ayarlanacaktır.
-
rotasyon
sayı
Ekranın saat yönünde, dikey konuma göre derece cinsinden dönüşü. Şu anda yalnızca ChromeOS'te kullanıma sunulmuştur. Diğer platformlarda 0 olarak ayarlanır. Cihaz fiziksel tablet durumundayken -1 değeri otomatik döndürme olarak yorumlanır.
-
workArea
Ekranın, ekran sınırları içindeki kullanılabilir çalışma alanı. Görev çubuğu ve başlatıcı gibi ekranın işletim sistemi için ayrılmış alanları çalışma alanına dahil değildir.
Edid
Özellikler
-
manufacturerId
dize
3 karakterli üretici kodu. Bkz. Böl. 3.4.1 sayfa 21. v1.4'te gereklidir.
-
productId
dize
2 baytlık üretici tarafından atanmış kod, Bölüm 3.4.2 sayfa 21. v1.4'te gereklidir.
-
yearOfManufacture
sayı
Üretici yılı, Sn. 3.4.4 sayfa 22. v1.4'te gereklidir.
GetInfoFlags
Özellikler
-
singleUnified
boole isteğe bağlı
Doğru değerine ayarlanırsa, birleştirilmiş masaüstü modundayken
getInfo
tarafından yalnızca birDisplayUnitInfo
döndürülür (bkz.enableUnifiedDesktop
). Varsayılan olarak false (yanlış) değerini alır.
Insets
Özellikler
-
ikinci yarı
sayı
Y ekseninin alt sınıra olan mesafesi.
-
sol
sayı
X ekseninin sol sınıra olan mesafesi.
-
sağ ok
sayı
X ekseninin sağ sınıra olan mesafesi.
-
ilk yarı
sayı
Y ekseninin üst sınıra olan mesafesi.
LayoutPosition
Düzen konumu (ör. ekranın bağlı olduğu üst öğenin kenarı).
Enum
"top"
"right" (sağ)
"bottom"
"left"
MirrorMode
Ayna modu (ör. bir ekranın diğer ekranlara nasıl yansıtıldığının farklı yolları).
Enum
"off"
Varsayılan modu (genişletilmiş veya birleştirilmiş masaüstü) belirtir.
"normal"
Varsayılan kaynak ekranının diğer tüm ekranlara yansıtılacağını belirtir.
"mixed"
Belirtilen kaynak ekranın, sağlanan hedef ekranlara yansıtılacağını belirtir. Diğer tüm bağlı ekranlar genişletilir.
MirrorModeInfo
Özellikler
-
mirroringDestinationIds
string[] isteğe bağlı
Yansıtılan hedefin kimlikleri gösterilir. Bu yalnızca "karma" için geçerlidir.
-
mirroringSourceId
string isteğe bağlı
Yansıtma kaynak ekranının kimliği. Bu yalnızca "karma" için geçerlidir.
-
mod
Ayarlanması gereken ayna modu.
Point
Özellikler
-
x
sayı
Noktanın x koordinatı.
-
y
sayı
Noktanın y koordinatı.
TouchCalibrationPair
Özellikler
-
displayPoint
Görüntüleme noktasının koordinatları.
-
touchPoint
Görüntüleme noktasına karşılık gelen temas noktasının koordinatları.
TouchCalibrationPairQuad
Özellikler
-
pair1
Dokunma kalibrasyonu için gereken ilk dokunma ve görüntüleme noktası çifti.
-
pair2
Dokunma kalibrasyonu için ikinci dokunma ve görüntüleme noktası çifti gerekir.
-
pair3
Dokunmatik kalibrasyonu gerçekleştirmek için üçüncü dokunma ve görüntüleme noktası çifti gerekiyor.
-
pair4
Dokunma kalibrasyonu için gereken dördüncü dokunma ve görüntüleme noktası çifti.
Yöntemler
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
)
Ekranın dokunma kalibrasyonunu sıfırlar ve ekranla ilişkili tüm dokunma kalibrasyon verilerini temizleyerek varsayılan durumuna geri getirir.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
)
Bir ekranın dokunma kalibrasyon çiftlerini ayarlar. Bu pairs
, dokunmatik ekranı, startCustomTouchCalibration() işlevinde çağrılan id
ile görüntülemek üzere kalibre etmek için kullanılır. Bu yöntemi çağırmadan önce her zaman startCustomTouchCalibration
işlevini çağırın. Başka bir dokunma kalibrasyonu devam ediyorsa hata mesajı görüntülenir.
Parametreler
-
çiftler
Ekranı kalibre etmek için kullanılan nokta çiftleri.
-
sınırlar
Dokunma kalibrasyonu yapıldığında ekranın sınırları.
bounds.left
vebounds.top
değerleri yoksayılır.
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
)
Birleştirilmiş masaüstü özelliğini etkinleştirir/devre dışı bırakır. Yansıtma etkinken etkinleştirilirse, yansıtma işlevi kapatılana kadar masaüstü modu değişmez. Aksi takdirde, masaüstü modu hemen birleştirilmiş moda geçer. NOT: Bu özellik yalnızca Chrome OS Kiosk uygulamaları ve Web kullanıcı arayüzü için kullanılabilir.
Parametreler
-
etkin
boolean
Birleşik masaüstü etkinleştirilecekse doğru değerini döndürür.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
)
Tüm ekranlar için düzen bilgilerini ister. NOT: Bu özellik yalnızca Chrome OS Kiosk uygulamaları ve Web kullanıcı arayüzü için kullanılabilir.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(layouts: DisplayLayout[]) => void
-
düzenler
-
İlerlemeler
-
Promise<DisplayLayout[]>
Chrome 91 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
)
Takılı tüm ekran cihazlarıyla ilgili bilgileri ister.
Parametreler
-
flags
GetInfoFlags isteğe bağlı
Chrome 59 ve sonraki sürümlerBilgilerin nasıl döndürüleceğini etkileyen seçenekler.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
İlerlemeler
-
Promise<DisplayUnitInfo[]>
Chrome 91 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
)
Bir ekran için geçerli fazla tarama eklerini ayarlar. Genellikle bu, ekranı bir eksen boyunca hareket ettirmeli (ör. sol+sağ aynı değere sahiptir) veya bir eksen boyunca ölçeklendirilmelidir (ör. üst+altın zıt değerleri vardır). Her Adjust çağrısı, Start'tan sonraki önceki çağrılarla kümülatiftir.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
Delta
Fazla tarama eklerinin değiştirileceği miktar.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
)
Mevcut değerleri kaydedip bindirmeyi gizleyerek bir ekran için tarama ayarlarını tamamlayın.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
)
Bir ekranın taşma eklerini son kaydedilen değere sıfırlar (ör.Start çağrılmadan önce).
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
)
Bir ekran için taşma kalibrasyonunu başlatır. Bu, ekranda mevcut fazla tarama eklerini gösteren bir yer paylaşımı gösterir. id
ekranı için fazla tarama kalibrasyonu devam ediyorsa bu işlem kalibrasyonu sıfırlar.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
setDisplayLayout()
chrome.system.display.setDisplayLayout(
layouts: DisplayLayout[],
callback?: function,
)
Tüm ekranların düzenini ayarlayın. Dahil edilmeyen tüm ekranlar varsayılan düzeni kullanır. Bir düzen çakışırsa veya geçersiz olursa geçerli bir düzene ayarlanır. Düzen çözümlendikten sonra bir onDisplayChanged etkinliği tetiklenir. NOT: Bu özellik yalnızca Chrome OS Kiosk uygulamaları ve Web kullanıcı arayüzü için kullanılabilir.
Parametreler
-
düzenler
Birincil ekran hariç tüm ekranlar için gereken düzen bilgileri.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
)
info
içinde sağlanan bilgilere göre, id
tarafından belirtilen ekran özelliklerini günceller. Hata oluşursa runtime.lastError
ayarlanır. NOT: Bu özellik yalnızca Chrome OS Kiosk uygulamaları ve Web kullanıcı arayüzü için kullanılabilir.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
bilgi
Değiştirilmesi gereken görüntüleme özellikleri hakkındaki bilgiler. Bir özellik, yalnızca
info
içinde kendisi için yeni bir değer belirtilirse değiştirilir. -
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
)
Görüntü modunu belirtilen yansıtma moduna ayarlar. Her arama, önceki aramaların durumunu sıfırlar. Yansıtma hedef ekranları için setDisplayProperties() çağrısı başarısız olur. NOT: Bu özellik yalnızca Chrome OS Kiosk uygulamaları ve Web kullanıcı arayüzü için kullanılabilir.
Parametreler
-
bilgi
Ekran moduna uygulanması gereken ayna moduyla ilgili bilgiler.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
)
Ekran kimliği olarak id
olacak şekilde, ekran için yerel dokunma kalibrasyon kullanıcı deneyimini gösterir. Bu işlem, nasıl devam edeceğinizle ilgili talimatları içeren ekranda bir yer paylaşımı gösterir. Geri çağırma, yalnızca başarılı kalibrasyon olması durumunda çağrılır. Kalibrasyon başarısız olursa hataya neden olur.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(success: boolean) => void
-
başarılı
boolean
-
İlerlemeler
-
Promise<boolean>
Chrome 91 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
)
Bir ekran için özel dokunma kalibrasyonunu başlatır. Bu, kalibrasyon verilerini toplamak için özel bir kullanıcı deneyimi kullanılırken çağrılmalıdır. Başka bir dokunma kalibrasyonu devam ediyorsa hata mesajı görüntülenir.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
Etkinlikler
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
Ekran yapılandırmasında herhangi bir değişiklik yapıldığında tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:() => void