refresh date: 2026-09-25 robots: noindex
Açıklama
Yayınlanan içerik meta verilerini sorgulamak için system.display API'yi kullanın.
İzinler
system.displayTürler
ActiveState
Ekranın sistem tarafından algılanıp algılanmadığını ve kullanılıp kullanılmadığını belirten bir enum. Sistem tarafından algılanmayan ekranlar "etkin değil" olarak kabul edilir (bağlantısı kesilmiş olabilir veya uyku modu vb. nedeniyle bağlantısı kesilmiş olarak kabul edilebilir). Bu durum, tüm ekranların bağlantısı kesildiğinde mevcut ekranı korumak için kullanılır.
Enum
"etkin"
"etkin değil"
Bounds
Özellikler
-
yükseklik
sayı
Ekranın piksel cinsinden yüksekliği.
-
sol
sayı
Sol üst köşenin x koordinatı.
-
üst
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ı.
-
telafi etmek
sayı
Ekranın bağlı kenar boyunca ofseti. 0, en üstteki veya en soldaki köşelerin hizalandığını gösterir.
-
parentId
dize
Üst ekranın benzersiz tanımlayıcısı. Kök ise boş bırakılır.
-
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ü modu cihaz ölçeklendirme 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ı
Doğal piksel cinsinden görüntüleme modu yüksekliği.
-
isInterlaced
boole isteğe bağlı
Chrome 74 ve sonraki sürümlerBu mod geçişliyse doğru, sağlanmamışsa yanlış değerini döndürür.
-
isNative
boole
Mod, ekranın yerel moduysa doğru değerini döndürür.
-
isSelected
boole
Görüntü modu seçiliyse doğru değerini döndürür.
-
refreshRate
sayı
Chrome 67 ve sonraki sürümlerHertz cinsinden görüntüleme modu yenileme hızı.
-
uiScale
number isteğe bağlı
Chrome 70'ten itibaren desteği sonlandırıldıdisplayZoomFactorhareketini kullanınGörüntü modu kullanıcı arayüzü ölçeklendirme faktörü.
-
genişlik
sayı
Cihazdan bağımsız (kullanıcı tarafından görülebilen) piksel cinsinden görüntüleme modu genişliği.
-
widthInNativePixels
sayı
Doğal piksel cinsinden görüntüleme modu genişliği.
DisplayProperties
Özellikler
-
boundsOriginX
number isteğe bağlı
Ayarlanırsa ekranın mantıksal sınırlarının başlangıç noktasını X ekseni boyunca günceller.
boundsOriginYile birlikte uygulandı. Ayarlanmamışsa veboundsOriginYayarlanmışsa varsayılan olarak geçerli değere ayarlanır. Görüntüleme başlangıç noktasını güncellerken bazı kısıtlamalar uygulanır. Bu nedenle, nihai sınır başlangıç noktası, ayarlanan noktadan farklı olabilir. Nihai sınırlargetInfokullanılarak alınabilir. Sınırların başlangıç noktası birincil ekranda değiştirilemez. -
boundsOriginY
number isteğe bağlı
Ayarlanırsa ekranın mantıksal sınırlarının başlangıç noktasını y ekseni boyunca günceller.
boundsOriginXparametresiyle ilgili belgelere bakın. -
displayMode
DisplayMode isteğe bağlı
Chrome 52+Ayarlanırsa görüntüleme modunu bu değerle eşleşen moda günceller. Diğer parametreler geçersizse bu parametre uygulanmaz. Görüntüleme modu geçersizse uygulanmaz ve bir hata ayarlanır ancak diğer özellikler uygulanmaya devam eder.
-
displayZoomFactor
number isteğe bağlı
Chrome 65+Ayarlanırsa ekranla ilişkili yakınlaştırmayı günceller. Bu yakınlaştırma, yeniden düzenleme ve yeniden boyama işlemlerini gerçekleştirir. Bu sayede, yalnızca piksel piksel genişletme işleminden daha kaliteli bir yakınlaştırma elde edilir.
-
isPrimary
boole isteğe bağlı
Doğru değerine ayarlanırsa ekranı birincil yapar. Yanlış değerine ayarlanırsa işlem yapılmaz. Not: Ayarlanırsa ekran, diğer tüm özellikler için birincil olarak kabul edilir (ör.
isUnifiedayarlanabilir ve sınırların başlangıç noktası ayarlanmayabilir). -
isUnified
boole isteğe bağlı
Chrome 59+Yalnızca ChromeOS. Doğru değerine ayarlanırsa görüntüleme modunu birleşik masaüstü olarak değiştirir (ayrıntılar için
enableUnifiedDesktopsayfasına bakın). Politika, yanlış değerine ayarlanırsa birleşik masaüstü modu devre dışı bırakılır. Bu yalnızca birincil ekran için geçerlidir. Bu özellik sağlanırsa mirroringSourceId sağlanmamalıdır ve diğer özellikler yoksayılır. Sağlanmazsa bu ayarın bir etkisi olmaz. -
mirroringSourceId
string isteğe bağlı
Chrome 68'den itibaren desteği sonlandırıldısetMirrorModekullanın.Yalnızca ChromeOS. Ayarlandıysa ve boş değilse yalnızca bu ekran için yansıtmayı etkinleştirir. Aksi takdirde tüm ekranlar için yansıtmayı devre dışı bırakır. Bu değer, yansıtılacak kaynak ekranın kimliğini belirtmelidir. Bu kimlik, setDisplayProperties'e iletilen kimlikle aynı olmamalıdır. Bu özellik ayarlanırsa başka bir özellik ayarlanamaz.
-
fazla tarama
Ekler isteğe bağlı
Ayarlanırsa ekranın aşırı tarama eklerini sağlanan değerlere ayarlar. Overscan değerleri negatif veya ekran boyutunun yarısından büyük olamaz. Dahili monitörde aşırı tarama değiştirilemez.
-
döndürme
number 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 algılanır ve sistem tarafından kullanılırsa etkin olur.
-
availableDisplayZoomFactors
number[]
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+Ekranın mevcut ve varsayılan yakınlaştırma oranı. Örneğin, 1 değeri% 100 yakınlaştırmaya, 1,5 değeri ise% 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ı.
-
edid
Edid isteğe bağlı
Chrome 67 ve sonraki sürümlerNOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir.
-
hasTouchSupport
boole
Chrome 57 ve sonraki sürümlerBu ekranla ilişkili bir dokunmatik giriş cihazı varsa True (Doğru) değerini döndürür.
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
isEnabled
boole
Bu ekran etkinse doğru değerini döndürür.
-
isPrimary
boole
Bu birincil ekransa doğru değerini döndürür.
-
isUnified
boole
Chrome 59+Birleşik masaüstü modundayken tüm ekranlar için geçerlidir.
enableUnifiedDesktopile ilgili belgelere bakın. -
mirroringDestinationIds
string[]
Chrome 64+Yalnızca ChromeOS. Kaynak ekranın yansıtıldığı ekranların tanımlayıcıları. Yansıtılan ekran yoksa boş bırakılır. Bu değer, tüm ekranlar için aynı değere ayarlanır. Bu,
mirroringSourceIdiçermemelidir. -
mirroringSourceId
dize
Yalnızca ChromeOS. Yansıtma etkinse yansıtılan ekranın tanımlayıcısı, aksi takdirde boş. Bu ayar, tüm ekranlar (yansıtılan ekran dahil) için geçerli olur.
-
modlarChrome 52+
Kullanılabilir görüntüleme modlarının listesi. Mevcut modda isSelected=true olur. Yalnızca ChromeOS'te kullanılabilir. Diğer platformlarda boş bir diziye ayarlanır.
-
ad
dize
Kullanıcı dostu ad (ör. "HP LCD monitör").
-
fazla tarama
Ekranın sınırları içindeki ekran iç kısımları. Şu anda yalnızca ChromeOS'te kullanılabilir. Diğer platformlarda boş iç kısımlar olarak ayarlanır.
-
döndürme
sayı
Ekranın dikey konuma göre saat yönünde dönüşü (derece cinsinden). Şu anda yalnızca ChromeOS'te kullanılabilir. Diğer platformlarda 0 olarak ayarlanır. -1 değeri, cihaz fiziksel olarak tablet durumundayken otomatik döndürme olarak yorumlanır.
-
workArea
Ekran sınırları içinde ekranın kullanılabilir çalışma alanı. Çalışma alanı, ekranın işletim sistemi için ayrılmış alanlarını (ör. görev çubuğu ve başlatıcı) içermez.
Edid
Özellikler
-
manufacturerId
dize
3 karakterli üretici kodu. Bölüm 3.4.1, sayfa 21'e bakın. v1.4'te zorunludur.
-
productId
dize
Üretici tarafından atanan 2 baytlık kod, Bölüm 3.4.2 sayfa 21. v1.4'te zorunludur.
-
yearOfManufacture
sayı
Üretim yılı, Bölüm 3.4.4, sayfa 22. v1.4'te zorunludur.
GetInfoFlags
Özellikler
-
singleUnified
boole isteğe bağlı
Doğru değerine ayarlanırsa birleşik masaüstü modundayken (
enableUnifiedDesktopbölümüne bakın)getInfotarafından yalnızca tek birDisplayUnitInfodöndürülür. Varsayılan olarak yanlış değerine ayarlıdır.
Insets
Özellikler
-
alt
sayı
Alt sınırdan y ekseni mesafesi.
-
sol
sayı
Sol sınırdan x ekseni mesafesi.
-
sağ
sayı
Sağ sınırdan x ekseni mesafesi.
-
üst
sayı
Üst sınırdan y ekseni mesafesi.
LayoutPosition
Düzen konumu, yani ekranın bağlı olduğu üst öğenin kenarı.
Enum
"top"
"right"
"bottom"
"left"
MirrorMode
Ayna modu (ör. bir ekranın diğer ekranlara farklı şekillerde yansıtılması)
Enum
"off"
Varsayılan modu (genişletilmiş veya birleşik masaüstü) belirtir.
"normal"
Varsayılan kaynak ekranı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. Bağlı diğer tüm ekranlar genişletilir.
MirrorModeInfo
Özellikler
-
mirroringDestinationIds
string[] isteğe bağlı
Yansıtma hedefi ekranlarının kimlikleri. Bu yalnızca "karma" için geçerlidir.
-
mirroringSourceId
string isteğe bağlı
Yansıtma kaynağı 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
Ekran noktasına karşılık gelen dokunma noktasının koordinatları.
TouchCalibrationPairQuad
Özellikler
-
pair1
Dokunma kalibrasyonu için ilk dokunma ve görüntüleme noktası çifti gereklidir.
-
pair2
Dokunma kalibrasyonu için ikinci bir dokunma ve görüntüleme noktası çifti gerekir.
-
pair3
Dokunma kalibrasyonu için üçüncü dokunma ve görüntüleme noktası çifti gereklidir.
-
pair4
Dokunma kalibrasyonu için dördüncü dokunma ve görüntüleme noktası çifti gereklidir.
Yöntemler
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
): void
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Ekranın dokunma kalibrasyonunu sıfırlar ve ekranla ilişkili tüm dokunma kalibrasyonu verilerini temizleyerek ekranı varsayılan durumuna döndürür.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
): void
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Bir ekran için dokunma kalibrasyonu çiftlerini ayarlar. Bu pairs, startCustomTouchCalibration() içinde çağrılan id ile ekranın dokunmatik ekranını kalibre etmek için kullanılır. Bu yöntemi çağırmadan önce her zaman startCustomTouchCalibration yöntemini çağırın. Başka bir dokunma kalibrasyonu devam ediyorsa bu işlem hata verir.
Parametreler
-
Ekranı kalibre etmek için kullanılan nokta çiftleri.
-
sınırlar
Dokunma kalibrasyonu yapıldığında ekranın sınırları.
bounds.leftvebounds.topdeğerleri yok sayılır.
enableUnifiedDesktop()
chrome.system.display.enableUnifiedDesktop(
enabled: boolean,
): void
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Birleştirilmiş masaüstü özelliğini etkinleştirir/devre dışı bırakır. Yansıtma etkinken etkinleştirilirse yansıtma kapatılana kadar masaüstü modu değişmez. Aksi takdirde, masaüstü modu hemen birleşik moda geçer.
Parametreler
-
etkin
boole
Birleşik masaüstü etkinleştirilecekse True değerini alır.
getDisplayLayout()
chrome.system.display.getDisplayLayout(
callback?: function,
): Promise<DisplayLayout[]>
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Tüm ekranlar için düzen bilgilerini ister.
Parametreler
-
callback
function isteğe bağlı
callbackparametresi şu şekilde görünür:(layouts: DisplayLayout[]) => void
-
düzenler
-
İadeler
-
Promise<DisplayLayout[]>
Chrome 91 ve sonraki sürümlerSonuçlarla çözümlenen Promise.
Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
): Promise<DisplayUnitInfo[]>
Bağlı tüm ekran cihazlarının bilgilerini ister.
Parametreler
-
flags
GetInfoFlags isteğe bağlı
Chrome 59+Bilgilerin nasıl döndürüleceğini etkileyen seçenekler.
-
callback
function isteğe bağlı
callbackparametresi şu şekilde görünür:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
İadeler
-
Promise<DisplayUnitInfo[]>
Chrome 91 ve sonraki sürümlerSonuçlarla çözümlenen Promise.
Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
): void
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Bir ekran için geçerli aşırı tarama eklerini ayarlar. Genellikle bu, ekranı bir eksen boyunca hareket ettirmeli (ör. sol ve sağ aynı değere sahip) veya bir eksen boyunca ölçeklendirmelidir (ör. üst ve alt zıt değerlere sahip). Her Adjust çağrısı, Start çağrısından sonraki önceki çağrılarla kümülatiftir.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
Delta
Overscan eklerini değiştirmek için kullanılacak miktar.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
): void
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Mevcut değerleri kaydedip yer paylaşımını gizleyerek bir ekran için aşırı tarama ayarlamalarını tamamlayın.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
): void
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Bir ekranın aşırı tarama eklerini son kaydedilen değere (yani Start çağrılmadan önce) sıfırlar.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
overscanCalibrationStart()
chrome.system.display.overscanCalibrationStart(
id: string,
): void
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Bir ekran için aşırı tarama kalibrasyonunu başlatır. Bu işlem, ekranda mevcut aşırı tarama eklerini gösteren bir yer paylaşımı gösterir. id ekranı için aşırı 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,
): Promise<void>
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Tüm ekranların düzenini ayarlayın. Dahil edilmeyen ekranlarda varsayılan düzen kullanılır. Bir düzen çakışırsa veya başka bir şekilde geçersiz olursa geçerli bir düzene ayarlanır. Düzen çözümlendikten sonra bir onDisplayChanged etkinliği tetiklenir.
Parametreler
-
düzenler
Birincil ekran dışındaki tüm ekranlar için gerekli olan düzen bilgileri.
-
callback
function isteğe bağlı
callbackparametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerİşlev tamamlandığında çözümlenen Promise.
Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
): Promise<void>
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. id ile belirtilen ekranın özelliklerini info içinde sağlanan bilgilere göre günceller. Başarısız olursa runtime.lastError ayarlanır.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
bilgi
Görüntüleme özellikleriyle ilgili değiştirilmesi gereken bilgiler. Bir özellik yalnızca
infoiçinde yeni bir değer belirtilirse değiştirilir. -
callback
function isteğe bağlı
callbackparametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerİşlev tamamlandığında çözümlenen Promise.
Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
): Promise<void>
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Görüntüleme modunu belirtilen ayna moduna ayarlar. Her çağrı, önceki çağrılardan gelen durumu sıfırlar. Yansıtma hedefi ekranları için setDisplayProperties() çağrısı başarısız olur.
Parametreler
-
bilgi
Görüntü moduna uygulanması gereken ayna modu bilgileri.
-
callback
function isteğe bağlı
callbackparametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerİşlev tamamlandığında çözümlenen Promise.
Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
): Promise<boolean>
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Ekran kimliği id olan ekran için yerel dokunma kalibrasyonu kullanıcı deneyimini gösterir. Bu işlem, ekranda nasıl devam edileceğine dair gerekli talimatları içeren bir yer paylaşımı gösterir. Geri çağırma, yalnızca kalibrasyon başarılı olduğunda çağrılır. Kalibrasyon başarısız olursa hata mesajı gösterilir.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
callback
function isteğe bağlı
callbackparametresi şu şekilde görünür:(success: boolean) => void
-
başarılı
boole
-
İadeler
-
Promise<boolean>
Chrome 91 ve sonraki sürümlerDokunma kalibrasyonunun sona erdiğini arayana bildirmek için çözümlenen Promise. Boole değeri, kalibrasyonun başarılı olup olmadığını bildirir.
Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
): void
NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Bir ekran için özel dokunma kalibrasyonunu başlatır. Kalibrasyon verilerini toplamak için özel bir kullanıcı deneyimi kullanıldığında bu yöntem çağrılmalıdır. Başka bir dokunma kalibrasyonu devam ediyorsa bu işlem hata verir.
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 olduğunda tetiklenir.
Parametreler
-
callback
işlev
callbackparametresi şu şekilde görünür:() => void