Açıklama
Ekran meta verilerini sorgulamak için system.display
API'sini kullanın.
İzinler
system.display
Türler
ActiveState
Ekranın sistem tarafından algılanıp kullanıldığını anlamaya yönelik bir sıralama. Sistem tarafından algılanmazsa (bağlantı kesilmiş olabilir veya uyku modu nedeniyle bağlantısının kesilmiş olabileceği kabul edilirse) ekran "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
"active"
"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 üst veya en soldaki köşelerin hizalandığını gösterir.
-
parentId
dize
Üst ekranın benzersiz tanımlayıcısı. Bu kökse boştur.
-
position
Bu ekranın üst öğeye göre düzen konumu. Bu değer, 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ülebilir) 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ümler 'nı inceleyin.Bu mod aralıklıysa doğru, sağlanmamışsa 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ümler 'nı inceleyin.Hertz cinsinden görüntüleme modu yenileme hızı.
-
uiScale
sayı isteğe bağlı
Chrome 70'ten bu yana desteği sonlandırıldıdisplayZoomFactor
hareketini kullanınGörüntüleme modu kullanıcı arayüzü ölçek faktörü.
-
genişlik
sayı
Cihazdan bağımsız (kullanıcı tarafından görülebilir) piksel cinsinden görüntüleme modu genişliği.
-
widthInNativePixels
sayı
Yerel piksel cinsinden görüntüleme modu genişliği.
DisplayProperties
Özellikler
-
boundsOriginX
sayı isteğe bağlı
Ayarlanırsa ekranın x eksenindeki mantıksal sınır kaynağını günceller.
boundsOriginY
ile birlikte uygulanır. Ayarlanmazsa veboundsOriginY
ayarlanmışsa varsayılan olarak geçerli değer kullanılır. Görüntüleme kaynağını güncellerken bazı kısıtlamalar uygulanacağını, bu nedenle son sınırın başlangıç noktasının gruptan 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
sayı isteğe bağlı
Ayarlanırsa ekranın y eksenindeki mantıksal sınır kaynağını günceller.
boundsOriginX
parametresiyle ilgili dokümanlara bakın. -
displayMode
DisplayMode isteğe bağlı
Chrome 52 ve sonraki sürümler 'nı inceleyin.Ayarlanırsa görüntü modunu bu değerle eşleşen moda günceller. Diğer parametreler geçersizse bu uygulanmaz. Görüntüleme modu geçersizse uygulanmaz ve bir hata ayarlanır, ancak diğer özellikler uygulanmaya devam eder.
-
displayZoomFactor
sayı isteğe bağlı
Chrome 65 ve sonraki sürümler 'nı inceleyin.Ayarlanırsa ekranla ilişkili yakınlaştırmayı günceller. Bu yakınlaştırma özelliği, yeniden yerleşim ve yeniden boyama gerçekleştirir. Böylece, piksel x piksel genişletmeye kıyasla daha kaliteli bir yakınlaştırma elde edersiniz.
-
Birincil
boole isteğe bağlı
Doğru değerine ayarlanırsa ekranı birincil yapar. Yanlış değerine ayarlanırsa işlem yok. Not: Ayarlanırsa ekran, diğer tüm mülkler için birincil olarak kabul edilir (ör.
isUnified
ayarlanabilir ancak sınır kaynağı ayarlanamayabilir). -
isUnified
boole isteğe bağlı
Chrome 59 ve sonraki sürümler 'nı inceleyin.Yalnı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). 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. Sağlanırsa mirroringSourceId sağlanmamalıdır ve diğer özellikler yoksayılır. Sağlanmazsa herhangi bir etkisi olmaz. -
mirroringSourceId
dize isteğe bağlı
Chrome 68'den bu yana desteği sonlandırıldısetMirrorMode
kullanın.Yalnızca Chrome OS. Ayarlanır ve boş bırakılırsa yalnızca bu ekran için yansıtmayı etkinleştirir. Aksi takdirde, tüm ekranlarda 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. Politika ayarlanırsa başka hiçbir mülk ayarlanamaz.
-
fazla tarama
Ekler isteğe bağlı
Ayarlanırsa ekranın aşırı tarama eklerini sağlanan değerlere ayarlar. Fazla tarama değerlerinin negatif veya ekran boyutunun yarısından büyük olmayabileceğini unutmayın. Fazla tarama, dahili monitörde değiştirilemez.
-
rotasyon
sayı isteğe bağlı
Ayarlanırsa ekranın dönme ayarı güncellenir. 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 'nı inceleyin.
Ekran algılanır ve sistem tarafından kullanılırsa etkindir.
-
availableDisplayZoomFactors
numara[]
Chrome 67 ve sonraki sürümler 'nı inceleyin.Ekran 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ümler 'nı inceleyin.Ekranın mevcut ve varsayılan yakınlaştırma oranı arasındaki oran. Örneğin, 1 değer% 100 yakınlaştırmaya ve 1, 5 değeri% 150 yakınlaştırmaya eşittir.
-
dpiX
sayı
X ekseni boyunca inç başına piksel sayısı.
-
dpiY
sayı
Y ekseninde inç başına düşen piksel sayısı.
-
edid
Edid isteğe bağlı
Chrome 67 ve sonraki sürümler 'nı inceleyin.NOT: Bu özellik yalnızca Chrome OS Kiosk uygulamalarında ve Web Kullanıcı Arayüzü'nde kullanılabilir.
-
hasTouchSupport
boolean
Chrome 57 ve sonraki sürümler 'nı inceleyin.Bu ekranla ilişkilendirilmiş bir dokunmatik giriş cihazı varsa doğru değerini alır.
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
isEnabled
boolean
Bu ekran etkinleştirilirse doğru değerini alır.
-
Birincil
boolean
Bu birincil ekransa doğru değerini alır.
-
isUnified
boolean
Chrome 59 ve sonraki sürümler 'nı inceleyin.Birleşik masaüstü modundayken tüm ekranlar için doğru değerini alır.
enableUnifiedDesktop
ile ilgili belgeleri inceleyin. -
mirroringDestinationIds
dize[]
Chrome 64 ve sonraki sürümler 'nı inceleyin.Yalnızca Chrome OS. Kaynak ekranın yansıtıldığı ekranların tanımlayıcıları. Hiçbir ekran yansıtılmıyorsa boştur. 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ılan ekranın tanımlayıcısı, aksi takdirde boştur. Bu ayar, tüm ekranlar (yansıtılan ekran dahil) için ayarlanır.
-
modlarChrome 52 ve sonraki sürümler 'nı inceleyin.
Kullanılabilir görüntü modlarının listesi. Geçerli modda isSelected=true değeri bulunur. Yalnızca Chrome OS'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ı dahilinde olan ekler. Şu anda yalnızca ChromeOS'te kullanıma sunulmuştur. Diğer platformlarda boş ek olarak ayarlanır.
-
rotasyon
sayı
Ekranın dikey konuma göre derece cinsinden saat yönünde dönüşü. Şu anda yalnızca ChromeOS'te kullanıma sunulmuştur. Diğer platformlarda 0 olarak ayarlanır. -1 değeri, cihaz fiziksel bir tablet durumundayken otomatik döndürme olarak yorumlanır.
-
workArea
Ekranın ekran sınırları dahilinde kullanılabilir çalışma alanı. Çalışma alanı, ekranın görev çubuğu ve başlatıcı gibi işletim sistemi için ayrılmış alanlarını içermez.
Edid
Özellikler
-
manufacturerId
dize
3 karakterden oluşan üretici kodu. Bkz. Sn. 3.4.1 sayfa 21. 1.4 sürümünde zorunludur.
-
productId
dize
2 bayt üretici tarafından atanmış kod, 3.4.2 sayfa 21. 1.4 sürümünde zorunludur.
-
yearOfManufacture
sayı
Üretici yılı, Sn. 3.4.4 sayfa 22. 1.4 sürümünde zorunludur.
GetInfoFlags
Özellikler
-
singleUnified
boole isteğe bağlı
Doğru değerine ayarlanırsa birleştirilmiş masaüstü modundayken
getInfo
tarafından yalnızca tek birDisplayUnitInfo
döndürülür (bkz.enableUnifiedDesktop
). Varsayılan olarak yanlış değerine ayarlanır.
Insets
Özellikler
-
alt
sayı
Y ekseninin alt sınırdan uzaklığı.
-
sol
sayı
X ekseninin sol sınırdan uzaklığı.
-
sağ
sayı
Sağ sınırdan x ekseni mesafesi.
-
üst
sayı
Üst sınırdan y ekseni mesafesi.
LayoutPosition
Düzen konumu (ör. ekranın bağlı olduğu üst öğenin kenarı).
Enum
"top"
"right"
"bottom"
"left"
MirrorMode
Yansıtma modu, bir başka deyişle bir ekranın diğer ekranlara nasıl yansıtıldığının farklı yollarıdır.
Enum
"off"
Varsayılan modu belirtir (genişletilmiş veya birleştirilmiş masaüstü).
"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. Diğer tüm bağlı ekranlar genişletilir.
MirrorModeInfo
Özellikler
-
mirroringDestinationIds
string[] isteğe bağlı
Yansıtılan hedefin kimlikleri görüntülenir. Bu yalnızca "karma" için geçerlidir.
-
mirroringSourceId
dize isteğe bağlı
Yansıtılan 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 gereklidir. İlk temas ve görüntüleme noktası çifti.
-
pair2
Dokunma kalibrasyonu için ikinci dokunma ve görüntüleme noktası çifti gereklidir.
-
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ı gereklidir.
Yöntemler
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
)
Ekranın dokunma kalibrasyonunu sıfırlar ve ekranla ilişkili tüm dokunma kalibrasyonu verilerini temizleyerek varsayılan durumuna geri döndürür.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
completeCustomTouchCalibration()
chrome.system.display.completeCustomTouchCalibration(
pairs: TouchCalibrationPairQuad,
bounds: Bounds,
)
Bir ekran için dokunma kalibrasyonu çiftlerini ayarlar. Bu pairs
, startCustomTouchCalibration() çağrısında id
ile dokunmatik ekranın kalibre edilmesinde kullanılır. Bu yöntemi çağırmadan önce her zaman startCustomTouchCalibration
yöntemini çağırın. Halihazırda başka bir dokunma kalibrasyonu devam ediyorsa bu bir hata verir.
Parametreler
-
çiftler
Ekranı kalibre etmek için kullanılan nokta çiftleri.
-
sınırlar
Dokunmatik kalibrasyon gerçekleştiğinde 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 kapatılana kadar masaüstü modu değişmez. Aksi takdirde, masaüstü modu hemen birleşik moduna geçer. NOT: Bu özellik yalnızca Chrome OS Kiosk uygulamalarında ve Web Kullanıcı Arayüzü'nde kullanılabilir.
Parametreler
-
etkin
boolean
Birleşik masaüstü etkinleştirilmesi gerekiyorsa doğru değerini alı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ında ve Web Kullanıcı Arayüzü'nde kullanılabilir.
Parametreler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(layouts: DisplayLayout[]) => void
-
düzenler
-
İadeler
-
Promise<DisplayLayout[]>
Chrome 91 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
)
Ekli tüm ekran cihazları için bilgi ister.
Parametreler
-
flags
GetInfoFlags isteğe bağlı
Chrome 59 ve sonraki sürümler 'nı inceleyin.Bilgilerin nasıl döndürüldüğünü etkileyen seçenekler.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(displayInfo: DisplayUnitInfo[]) => void
-
displayInfo
-
İadeler
-
Promise<DisplayUnitInfo[]>
Chrome 91 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
)
Bir ekran için mevcut fazla tarama eklerini ayarlar. Tipik olarak, bu işlem ekranı bir eksen boyunca hareket ettirmeli (ör. sol+sağ aynı değere sahiptir) veya bir eksen boyunca ölçeklendirilmelidir (ör. üst+altta zıt değerler bulunur). Her Adjust çağrısı, Başlangıç'tan itibaren önceki çağrılarla kümülatiftir.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
Delta
Fazla tarama eklerini değiştirecek miktar.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
)
Mevcut değerleri kaydedip yer paylaşımını gizleyerek bir ekranın fazla tarama düzenlemelerini tamamlayın.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
overscanCalibrationReset()
chrome.system.display.overscanCalibrationReset(
id: string,
)
Bir ekranın fazla tarama eklerini son kaydedilen değere (ör.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,
)
Bir ekran için fazladan tarama kalibrasyonunu başlatır. Bu, ekranda mevcut fazla tarama eklerini gösteren bir yer paylaşımı gösterir. id
ekranının 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 için düzeni ayarlayın. Dahil edilmeyen ekranlar varsayılan düzeni kullanır. Çakışan veya geçersiz olan bir düzen geçerli bir düzene göre ayarlanır. Düzen çözümlendikten sonra bir onDisplayChanged etkinliği tetiklenir. NOT: Bu özellik yalnızca Chrome OS Kiosk uygulamalarında ve Web Kullanıcı Arayüzü'nde kullanılabilir.
Parametreler
-
düzenler
Birincil ekran hariç tüm ekranlar için gereken düzen bilgileri.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<void>
Chrome 91 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
)
id
tarafından belirtilen ekran özelliklerini info
içinde sağlanan bilgilere göre günceller. Hata durumunda runtime.lastError
ayarlanır. NOT: Bu özellik yalnızca Chrome OS Kiosk uygulamalarında ve Web Kullanıcı Arayüzü'nde kullanılabilir.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
bilgi
Değiştirilmesi gereken görüntüleme özellikleriyle ilgili bilgiler. Bir özellik, yalnızca
info
içinde onun için yeni bir değer belirtilmişse değiştirilir. -
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<void>
Chrome 91 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
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ıtılan hedef ekranlar için setDisplayProperties() çağrısı başarısız olur. NOT: Bu özellik yalnızca Chrome OS Kiosk uygulamalarında ve Web Kullanıcı Arayüzü'nde kullanılabilir.
Parametreler
-
bilgi
Görüntü moduna uygulanması gereken ayna modu bilgileri.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<void>
Chrome 91 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
)
Ekran kimliği olarak id
ile ekran için yerel dokunma kalibrasyonu kullanıcı deneyimini gösterir. Bunu yaptığınızda, ekranda nasıl devam edeceğinizle ilgili gerekli talimatların bulunduğu bir yer paylaşımı gösterilir. Geri çağırma yalnızca başarılı kalibrasyon durumunda çağrılır. Kalibrasyon başarısız olursa hata oluşur.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(success: boolean) => void
-
başarılı
boolean
-
İadeler
-
Promise<boolean>
Chrome 91 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
)
Ekran için özel dokunma kalibrasyonunu başlatır. Kalibrasyon verilerini toplamak için özel bir kullanıcı deneyimi kullanılırken bu çağrılmalıdır. Halihazırda başka bir dokunma kalibrasyonu devam ediyorsa bu bir 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
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:() => void