chrome.system.display

Açıklama

Görüntülü reklam meta verilerini sorgulamak için system.display API'yi kullanın.

İzinler

system.display

Türler

ActiveState

Chrome 117 ve sonraki sürümler

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

Chrome 53 ve sonraki sürümler

Ö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

  LayoutPosition

  Bu ekranın üst öğeye göre düzen konumu. Kök için bu değer yoksayılır.

DisplayMode

Chrome 52 ve sonraki sürümler

Ö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ümler

  Bu 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ümler

  Hertz cinsinden ekran modu yenileme hızı.

• uiScale

  number isteğe bağlı

  Chrome 70'den beri desteği sonlandırıldı

  displayZoomFactor hareketini kullanın

  Ekran 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 ve boundsOriginY 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ırlar getInfo 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ümler

  Ayarlanı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ümler

  Ayarlanı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ümler

  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 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

• activeState

  ActiveState

  Chrome 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ümler

  Ekran için ayarlanabilecek yakınlaştırma faktörü değerlerinin listesi.

• sınırlar

  Sınırlar

  Ekranın mantıksal sınırları.

• displayZoomFactor

  sayı

  Chrome 65 ve üzeri sürümler

  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ş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ümler

  NOT: Bu özellik yalnızca ChromeOS Kiosk uygulamaları ve web kullanıcı arayüzünde kullanılabilir.

• hasTouchSupport

  boolean

  Chrome 57 ve sonraki sürümler

  Bu 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ümler

  Birleş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ümler

  Yalnı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.

• modlar

  DisplayMode[]

  Chrome 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

  Ekli alanlar

  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

  Sınırlar

  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

Chrome 67 ve sonraki sürümler

Ö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

Chrome 59 ve sonraki sürümler

Özellikler

• singleUnified

  boole isteğe bağlı

  Doğru olarak ayarlanırsa birleşik masaüstü modundayken getInfo yalnızca tek bir DisplayUnitInfo 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

Chrome 53 ve sonraki sürümler

Düzen konumu (ör. ekranın bağlı olduğu üst öğenin kenarı).

Enum

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65 ve üzeri sürümler

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

Chrome 65 ve üzeri sürümler

Ö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

  MirrorMode

  Ayarlanması gereken ayna modu.

Point

Chrome 57 ve sonraki sürümler

Özellikler

• x

  sayı

  Noktanın x koordinatı.

• y

  sayı

  Noktanın y koordinatı.

TouchCalibrationPair

Chrome 57 ve sonraki sürümler

Özellikler

• displayPoint

  Nokta

  Gösterge noktasının koordinatları.

• touchPoint

  Nokta

  Görüntüleme noktasına karşılık gelen dokunma noktasının koordinatları.

TouchCalibrationPairQuad

Chrome 57 ve sonraki sürümler

Özellikler

• pair1

  TouchCalibrationPair

  Dokunma kalibreasyonu için gereken ilk dokunma ve ekran noktası çifti.

• pair2

  TouchCalibrationPair

  Dokunma kalibreasyonu için ikinci bir dokunma ve ekran noktası gerekir.

• pair3

  TouchCalibrationPair

  Dokunma kalibreasyonu için üçüncü bir dokunma ve ekran noktası çifti gerekir.

• pair4

  TouchCalibrationPair

  Dokunma kalibreasyonu için dördüncü dokunma ve ekran noktası çifti gerekir.

Yöntemler

clearTouchCalibration()

Chrome 57 ve sonraki sürümler

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 57 ve sonraki sürümler

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

• çift

  TouchCalibrationPairQuad

  Ekranı kalibre etmek için kullanılan nokta çiftleri.

• sınırlar

  Sınırlar

  Dokunma kalibrasyonu yapıldığında ekranın sınırları. bounds.left ve bounds.top değerleri yoksayılır.

enableUnifiedDesktop()

Chrome 46 ve sonraki sürümler

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()

Promise Chrome 53 ve sonraki sürümler

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

    DisplayLayout[]

İadeler

• Promise<DisplayLayout[]>

  Chrome 91 ve sonraki sürümler

  Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getInfo()

Promise

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ümler

  Bilgilerin 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

    DisplayUnitInfo[]

İadeler

• Promise<DisplayUnitInfo[]>

  Chrome 91 ve sonraki sürümler

  Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

overscanCalibrationAdjust()

Chrome 53 ve üzeri sürümler

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

  Ekli alanlar

  Aşırı tarama iç içe yerleştirilmelerini değiştirme miktarı.

overscanCalibrationComplete()

Chrome 53 ve sonraki sürümler

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 53 ve sonraki sürümler

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 53 ve üzeri sürümler

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()

Promise Chrome 53 ve sonraki sürümler

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

  DisplayLayout[]

  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ümler

  Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setDisplayProperties()

Promise

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

  DisplayProperties

  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ümler

  Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setMirrorMode()

Promise Chrome 65 ve üzeri sürümler

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

  MirrorModeInfo

  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ümler

  Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

showNativeTouchCalibration()

Promise Chrome 57 ve sonraki sürümler

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ümler

  Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

startCustomTouchCalibration()

Chrome 57 ve sonraki sürümler

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