Açıklama
Görüntülü reklam 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 algılanmadığını ve kullanılıp kullanılmadığını belirten bir enum. Sistem tarafından algılanmazsa (bağlantısı kesilmiş olabilir veya uyku modu vb. nedeniyle bağlantısı kesilmiş olarak kabul edilir) 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"
"inactive"
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ı.
-
ofset
sayı
Ekranın, bağlı kenar boyunca ofseti. 0, en üstteki veya en soldaki köşelerin hizalandığını gösterir.
-
parentId
dize
Ana ekranın benzersiz tanımlayıcısı. Kök ise boştur.
-
position
Bu ekranın üst öğeye göre düzen konumu. Kök için bu değer 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 ekran modu yüksekliği.
-
heightInNativePixels
sayı
Doğal piksel cinsinden ekran modu yüksekliği.
-
isInterlaced
boole isteğe bağlı
Chrome 74 ve sonraki sürümlerBu mod ardışıksa doğru, sağlanmamışsa yanlış değerini döndürür.
-
isNative
boolean
Mod, ekranın doğal moduysa doğru değerini alır.
-
isSelected
boolean
Görüntüleme modu şu anda seçiliyse doğru değerini döndürür.
-
refreshRate
sayı
Chrome 67 ve sonraki sürümlerHertz cinsinden ekran modu yenileme hızı.
-
uiScale
number isteğe bağlı
Chrome 70'den beri desteği sonlandırıldıdisplayZoomFactor
hareketini kullanınEkran 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 ekran modu genişliği.
-
widthInNativePixels
sayı
Doğal piksel cinsinden ekran modu genişliği.
DisplayProperties
Özellikler
-
boundsOriginX
number isteğe bağlı
Ayarlanırsa ekranın mantıksal sınırlarının orijinini x ekseni boyunca günceller.
boundsOriginY
ile birlikte uygulanır. Ayarlanmamışsa veboundsOriginY
ayarlanmışsa varsayılan değeri mevcut değerdir. Görünen kaynak güncellenirken bazı kısıtlamaların uygulanacağını, bu nedenle nihai sınır kaynağının ayarlanandan farklı olabileceğini unutmayın. Nihai sınırlargetInfo
kullanılarak alınabilir. Birincil ekranda sınırlar kaynağı değiştirilemez. -
boundsOriginY
number isteğe bağlı
Ayarlanırsa ekranın y ekseni boyunca mantıksal sınırlarının orijinini günceller.
boundsOriginX
parametresinin belgelerini inceleyin. -
displayMode
DisplayMode isteğe bağlı
Chrome 52 ve sonraki sürümlerAyarlanırsa görüntüleme 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 yine de uygulanır.
-
displayZoomFactor
number isteğe bağlı
Chrome 65 ve üzeri sürümlerAyarlanırsa ekranla ilişkili yakınlaştırmayı günceller. Bu yakınlaştırma, yeniden düzenleyerek ve yeniden boyayarak piksel piksel genişletme işlemine kıyasla 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ış olarak ayarlanırsa işlem yapılmaz. Not: Ayarlanırsa görüntüleme diğer tüm özellikler için birincil olarak kabul edilir (ör.
isUnified
ayarlanabilir ancak sınır kaynağı ayarlanamaz). -
isUnified
boole isteğe bağlı
Chrome 59 ve sonraki sürümlerYalnı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
enableUnifiedDesktop
bölümüne 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. Bu ayar sağlanmazsa hiçbir etkisi olmaz. -
mirroringSourceId
dize isteğe bağlı
Chrome 68'den beri desteği sonlandırıldısetMirrorMode
kullanın.Yalnızca ChromeOS. Ayarlanmışsa ve boş değilse yalnızca bu ekran için yansıtmayı etkinleştirir. Aksi takdirde tüm ekranlar için yansıtma devre dışı bırakılır. Bu değer, yansıtılacak kaynak ekranın kimliğini belirtmelidir. Bu kimlik, setDisplayProperties işlevine iletilen kimlikle aynı olmamalıdır. Ayarlanırsa başka bir özellik ayarlanamaz.
-
aşırı tarama
İçerikler isteğe bağlı
Ayarlanırsa ekranın aşırı tarama eklerinin sağlanan değerlere ayarlanır. Aşırı tarama değerlerinin negatif veya ekranın boyutunun yarısından büyük olamayacağını unutmayın. İç 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. Geçerli 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ır ve kullanılırsa etkindir.
-
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 ve üzeri sürümlerEkranı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şittir.
-
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ı ve web kullanıcı arayüzünde kullanılabilir.
-
hasTouchSupport
boolean
Chrome 57 ve sonraki sürümlerBu ekranla ilişkili bir dokunmatik giriş cihazı varsa doğru değerini döndürür.
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
isEnabled
boolean
Bu ekran etkinse doğru değerini döndürür.
-
isPrimary
boolean
Birincil ekransa doğru değerini alır.
-
isUnified
boolean
Chrome 59 ve sonraki sürümlerBirleşik masaüstü modundayken tüm ekranlar için doğrudur.
enableUnifiedDesktop
dokümanlarına bakın. -
mirroringDestinationIds
dize[]
Chrome 64 ve üzeri sürümlerYalnızca ChromeOS. Kaynak ekranın yansıtıldığı ekranların tanımlayıcıları. Yansıtılan ekran yoksa boştur. Bu değer, tüm ekranlar için aynı değere ayarlanır. Bu,
mirroringSourceId
içermemelidir. -
mirroringSourceId
dize
Yalnızca ChromeOS. Yansıtma etkinse yansıtılan ekranın tanımlayıcısıdır, aksi takdirde boştur. Bu ayar, tüm ekranlar (yansıtılan ekran dahil) için belirlenir.
-
modlarChrome 52 ve üzeri sürümler
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 dizeye ayarlanır.
-
ad
dize
Kullanıcı dostu ad (ör. "HP LCD monitör").
-
aşırı tarama
Ekranın, ekranının sınırları içinde kalan içe yerleştirilmiş kısımları. Şu anda yalnızca ChromeOS'te kullanılabilir. Diğer platformlarda boş iç içe yerleştirilmiş öğeler olarak ayarlanır.
-
döndürme
sayı
Dikey konuma göre ekranın saat yönünde derece cinsinden dönüşü. Şu anda yalnızca ChromeOS'te sunulmaktadır. 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ı. Çalışma alanında, işletim sistemi için ayrılmış ekran alanları (ör. görev çubuğu ve başlatıcı) yer almaz.
Edid
Özellikler
-
manufacturerId
dize
3 karakterli üretici kodu. Bkz. 21. sayfadaki 3.4.1 numaralı bölüm. 1.4 sürümünde gereklidir.
-
productId
dize
2 baytlık üretici tarafından atanan kod, Bölüm 3.4.2, sayfa 21. 1.4 sürümünde gereklidir.
-
yearOfManufacture
sayı
Üretici yılı, Bölüm 3.4.4, sayfa 22. 1.4 sürümünde gereklidir.
GetInfoFlags
Özellikler
-
singleUnified
boole isteğe bağlı
Doğru olarak ayarlanırsa birleşik masaüstü modundayken
getInfo
yalnızca tek birDisplayUnitInfo
döndürülür (enableUnifiedDesktop
bölümüne bakın). Varsayılan olarak yanlıştır.
Insets
Özellikler
-
alt
sayı
Y ekseninin alt sınıra olan mesafesi.
-
sol
sayı
Sol sınıra olan x ekseni mesafesi.
-
sağ
sayı
Sağ sınıra olan x ekseni mesafesi.
-
üst
sayı
Üst sınıra olan 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, yani bir ekranın diğer ekranlara yansıtılmasının farklı yolları.
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 uzatılır.
MirrorModeInfo
Özellikler
-
mirroringDestinationIds
string[] isteğe bağlı
Yansıtma hedefinin kimlikleri gösterilir. Bu yalnızca "karışık" için geçerlidir.
-
mirroringSourceId
dize isteğe bağlı
Yansıtma kaynak ekranının kimliği. Bu yalnızca "karışık" 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österge noktasının koordinatları.
-
touchPoint
Görüntüleme noktasına karşılık gelen dokunma noktasının koordinatları.
TouchCalibrationPairQuad
Özellikler
-
pair1
Dokunma kalibreasyonu için gereken ilk dokunma ve ekran noktası çifti.
-
pair2
Dokunma kalibreasyonu için ikinci bir dokunma ve ekran noktası gerekir.
-
pair3
Dokunma kalibreasyonu için üçüncü bir dokunma ve ekran noktası çifti gerekir.
-
pair4
Dokunma kalibreasyonu için dördüncü dokunma ve ekran noktası çifti gerekir.
Yöntemler
clearTouchCalibration()
chrome.system.display.clearTouchCalibration(
id: string,
)
Ekranla ilişkili tüm dokunmatik kalibrasyon verilerini temizleyerek ekranın dokunmatik kalibrasyonunu sıfırlar ve 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,
)
Bir ekran için dokunma kalibrasyon çiftlerini ayarlar. Bu pairs
, startCustomTouchCalibration() içinde çağrılan id
ile dokunmatik ekranı ekran için kalibre etmek üzere kullanılır. Bu yöntemi çağırmadan önce her zaman startCustomTouchCalibration
çağrın. Devam eden başka bir dokunmatik ekran kalibrasyonunuz varsa hata mesajı gösterilir.
Parametreler
-
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şik 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 ChromeOS Kiosk uygulamaları ve web kullanıcı arayüzünde kullanılabilir.
Parametreler
-
etkin
boolean
Birleşik masaüstü etkinleştirilecekse 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 ChromeOS Kiosk uygulamaları 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
-
layouts
-
İadeler
-
Promise<DisplayLayout[]>
Chrome 91 ve sonraki sürümlerSözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.
getInfo()
chrome.system.display.getInfo(
flags?: GetInfoFlags,
callback?: function,
)
Bağlı tüm ekran cihazlarının bilgilerini 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
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ümlerSözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.
overscanCalibrationAdjust()
chrome.system.display.overscanCalibrationAdjust(
id: string,
delta: Insets,
)
Bir ekran için mevcut aşırı tarama iç içe yerleştirilmelerini ayarlar. Genellikle bu, ekranı bir eksen boyunca hareket ettirir (ör. sol+sağ aynı değere sahiptir) veya bir eksen boyunca ölçeklendirir (ör. üst+alt zıt değerlere sahiptir). Her Adjust çağrısı, Başlangıç'tan sonraki önceki çağrılarla kümülatiftir.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
-
Delta
Aşırı tarama iç içe yerleştirilmelerini değiştirme miktarı.
overscanCalibrationComplete()
chrome.system.display.overscanCalibrationComplete(
id: string,
)
Mevcut değerleri kaydedip yer paylaşımını gizleyerek bir ekran için aşırı 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 aşırı tarama iç içe yerleştirilmelerini, 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,
)
Ekran için aşırı tarama kalibrasyonunu başlatır. Bu işlem, ekranda mevcut aşırı tarama eklerinin gösterildiği 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,
)
Tüm ekranların düzenini ayarlayın. Dahil edilmeyen tüm ekranlarda varsayılan düzen kullanılır. Bir düzen örtüşüyorsa veya başka bir şekilde geçersizse geçerli bir düzene ayarlanır. Düzenleme çözüldükten sonra onDisplayChanged etkinliği tetiklenir. NOT: Bu özellik yalnızca ChromeOS Kiosk uygulamaları ve web kullanıcı arayüzünde kullanılabilir.
Parametreler
-
layouts
Birincil ekran dışındaki tüm ekranlar için gerekli olan düzen bilgileri.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerSözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.
setDisplayProperties()
chrome.system.display.setDisplayProperties(
id: string,
info: DisplayProperties,
callback?: function,
)
id
tarafından belirtilen ekranın özelliklerini, info
'te sağlanan bilgilere göre günceller. Başarısızlık durumunda runtime.lastError
ayarlanır. NOT: Bu özellik yalnızca ChromeOS Kiosk uygulamaları 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 mülkleri hakkındaki bilgiler. Bir özellik yalnızca
info
içinde yeni bir değer belirtilirse değiştirilir. -
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerSözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.
setMirrorMode()
chrome.system.display.setMirrorMode(
info: MirrorModeInfo,
callback?: function,
)
Görüntü modunu belirtilen ayna moduna ayarlar. Her arama, önceki aramalardaki durumu sıfırlar. setDisplayProperties() çağrısı, yansıtma hedef ekranları için başarısız olur. NOT: Bu özellik yalnızca ChromeOS Kiosk uygulamaları ve web kullanıcı arayüzünde kullanılabilir.
Parametreler
-
bilgi
Ekran moduna uygulanması gereken yansıtma modu bilgileri.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Chrome 91 ve sonraki sürümlerSözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.
showNativeTouchCalibration()
chrome.system.display.showNativeTouchCalibration(
id: string,
callback?: function,
)
Ekran kimliği olarak id
olan ekran için yerel dokunmatik kalibrasyon kullanıcı deneyimini gösterir. Bu işlem, ekranda nasıl devam edeceğinizle ilgili gerekli talimatları içeren bir yer paylaşımı gösterir. Geri çağırma işlevi yalnızca başarılı bir kalibrasyon durumunda çağrılır. Kalibrasyon başarısız olursa hata mesajı gösterilir.
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ümlerSözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.
startCustomTouchCalibration()
chrome.system.display.startCustomTouchCalibration(
id: string,
)
Bir ekran için özel dokunma kalibrasyonunu başlatır. Bu işlev, kalibrasyon verileri toplamak için özel bir kullanıcı deneyimi kullanılırken çağrılmalıdır. Devam eden başka bir dokunmatik ekran kalibrasyonunuz varsa hata mesajı gösterilir.
Parametreler
-
id
dize
Ekranın benzersiz tanımlayıcısı.
Etkinlikler
onDisplayChanged
chrome.system.display.onDisplayChanged.addListener(
callback: function,
)
Görüntüleme 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