chrome.system.display

Açıklama

Yayınlanan içerik 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 kullanıldığını belirten bir enum. Sistem tarafından algılanmayan (belki bağlantısı kesilmiş veya uyku modu nedeniyle bağlantısı kesilmiş olarak kabul edilen) ekranlar "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 veya sonraki sürümler

Özellikler

• id

  dize

  Ekranın benzersiz tanımlayıcısı.

• telafi etmek

  sayı

  Ekranın bağlı kenar boyunca olan uzaklığı. 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ş olur.

• position

  LayoutPosition

  Bu gösterimin üst öğeye göre düzen konumu. Bu, kök için yoksayılır.

DisplayMode

Chrome 52 ve sonraki sürümler

Özellikler

• deviceScaleFactor

  sayı

  Görüntüleme modu cihaz ölçeklendirme faktörü.

• yükseklik

  sayı

  Cihazdan bağımsız (kullanıcı tarafından görülebilen) piksellerde ekran modu yüksekliği.

• heightInNativePixels

  sayı

  Görüntüleme modunun doğal pikseller cinsinden yüksekliği.

• isInterlaced

  boolean isteğe bağlı

  Chrome 74 veya daha yeni bir sürüm

  Bu mod interlaced ise doğru, sağlanmamışsa yanlış değerini döndürür.

• isNative

  boolean

  Mod, ekranın yerel moduysa doğru (true) değerini alır.

• isSelected

  boolean

  Görüntü modu şu anda seçiliyse doğru değerini döndürür.

• refreshRate

  sayı

  Chrome 67 veya daha yeni bir sürüm

  Hertz cinsinden ekran modu yenileme hızı.

• uiScale

  number isteğe bağlı

  Chrome 70'ten beri kullanımdan kaldı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) piksellerde ekran modu genişliği.

• widthInNativePixels

  sayı

  Yerel piksellerde ekran 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ıcını x ekseni boyunca günceller. boundsOriginY ile birlikte uygulanır. Ayarlanmamışsa ve boundsOriginY ayarlanmışsa varsayılan olarak geçerli değer kullanılır. Görüntüleme kaynağı güncellenirken bazı kısıtlamalar uygulanacağından nihai sınır kaynağının ayarlanan kaynaktan farklı olabileceğini unutmayın. Son sınırlar getInfo kullanı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ıcını y ekseni boyunca günceller. boundsOriginX parametresiyle ilgili dokümanları inceleyin.

• displayMode

  DisplayMode isteğe bağlı

  Chrome 52 ve sonraki sürümler

  Ayarlanırsa ekran 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 yine de uygulanır.

• displayZoomFactor

  number isteğe bağlı

  Chrome 65 veya daha yeni bir sürüm

  Ayarlanırsa ekranla ilişkili yakınlaştırmayı günceller. Bu yakınlaştırma, yeniden düzenleme ve yeniden boyama işlemleri gerçekleştirerek piksel piksel genişletme işlemine kıyasla daha kaliteli bir yakınlaştırma sağlar.

• isPrimary

  boolean isteğe bağlı

  Doğru değerine ayarlanırsa ekranı birincil yapar. Yanlış olarak ayarlanırsa işlemsizdir. Not: Ayarlanırsa gösterim, diğer tüm özellikler için birincil olarak kabul edilir (ör. isUnified ayarlanabilir ve sınırların kaynağı ayarlanmayabilir).

• isUnified

  boolean isteğe bağlı

  Chrome 59 veya daha yeni bir sürüm

  Yalnızca ChromeOS Doğru değerine ayarlanırsa ekran modunu birleşik masaüstü olarak değiştirir (ayrıntılar için enableUnifiedDesktop bölümüne bakın). Yanlış olarak ayarlanırsa birleşik masaüstü modu devre dışı bırakılır. Bu yalnızca birincil ekran için geçerlidir. Bu değer sağlanırsa mirroringSourceId sağlanmamalıdır ve diğer özellikler yoksayılır. Bu değer sağlanmazsa herhangi bir etkisi olmaz.

• mirroringSourceId

  dize isteğe bağlı

  Chrome 68'den beri kullanımdan kaldırıldı

  setMirrorMode kullanın.

  Yalnızca ChromeOS Ayarlanırsa ve boş değilse yalnızca bu ekranda yansıtma etkinleştirilir. Aksi takdirde, tüm ekranlarda yansıtma devre dışı bırakılır. Bu değer, yansıtılacak kaynak ekranın kimliğini belirtmelidir. Bu kimlik, setDisplayProperties'e iletilen kimlikle aynı olmamalıdır. Ayarlanırsa başka bir özellik ayarlanamaz.

• fazla tarama

  İç kısımlar isteğe bağlı

  Ayarlanırsa ekranın overscan iç kısımlarını sağlanan değerlere ayarlar. Overscan değerlerinin negatif olamayacağını veya ekran boyutunun yarısından büyük olamayacağını unutmayın. Aşırı tarama, dahili monitörde değiştirilemez.

• döndürme

  number isteğe bağlı

  Ayarlandığında 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 algılanır ve sistem tarafından kullanılırsa etkin olur.

• availableDisplayZoomFactors

  number[]

  Chrome 67 veya daha yeni bir sürüm

  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 veya daha yeni bir sürüm

  Ekranın mevcut ve varsayılan yakınlaştırması arasındaki 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 düşen piksel sayısı.

• dpiY

  sayı

  Y ekseni boyunca inç başına düşen piksel sayısı.

• edid

  Edid isteğe bağlı

  Chrome 67 veya daha yeni bir sürüm

  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 ekrana dokunma giriş cihazı bağlıysa doğru (True).

• id

  dize

  Ekranın benzersiz tanımlayıcısı.

• isEnabled

  boolean

  Bu ekran etkinse doğru.

• isPrimary

  boolean

  Birincil ekransa doğru değerini alır.

• isUnified

  boolean

  Chrome 59 veya daha yeni bir sürüm

  Birleşik masaüstü modundayken tüm ekranlar için geçerlidir. enableUnifiedDesktop ile ilgili dokümanlara bakın.

• mirroringDestinationIds

  string[]

  Chrome 64 veya daha yeni bir sürüm

  Yalnızca ChromeOS Kaynak ekranın yansıtıldığı ekranların tanımlayıcıları. Hiçbir ekran yansıtılmıyorsa boş olur. Bu değer, tüm ekranlar için aynı değere ayarlanır. Bu, mirroringSourceId değerini içermemelidir.

• mirroringSourceId

  dize

  Yalnızca ChromeOS Yansıtma etkinse yansıtılan ekranın tanımlayıcısı, aksi takdirde boş. Bu ayar, yansıtılan ekran da dahil olmak üzere tüm ekranlar için geçerli olur.

• modlar

  DisplayMode[]

  Chrome 52 ve sonraki sürümler

  Kullanılabilir ekran modlarının listesi. Geçerli modda isSelected=true olur. Yalnızca ChromeOS'te kullanılabilir. Diğer platformlarda boş bir dizi olarak ayarlanır.

• ad

  dize

  Kullanıcı dostu ad (ör. "HP LCD monitör").

• fazla tarama

  İç boşluklar

  Ekranın, ekran sınırları içindeki yerleşimi. Şu anda yalnızca ChromeOS'te kullanılabilir. Diğer platformlarda boş ekler 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 tablet durumundayken otomatik döndürme olarak yorumlanır.

• workArea

  Sınırlar

  Ekran sınırları içindeki kullanılabilir çalışma alanı. Çalışma alanı, işletim sistemi için ayrılmış ekran alanlarını (ör. görev çubuğu ve başlatıcı) içermez.

Edid

Chrome 67 veya daha yeni bir sürüm

Özellikler

• manufacturerId

  dize

  3 karakterlik üretici kodu. Bkz. Bölüm 3.4.1, sayfa 21. v1.4'te zorunludur.

• productId

  dize

  2 baytlık üretici tarafından atanmış 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

Chrome 59 veya daha yeni bir sürüm

Özellikler

• singleUnified

  boolean isteğe bağlı

  Doğru olarak ayarlanırsa birleşik masaüstü modundayken getInfo tarafından yalnızca tek bir DisplayUnitInfo döndürülür (enableUnifiedDesktop bölümüne bakın). Varsayılan olarak false (yanlış) değerine ayarlanır.

Insets

Özellikler

• alt

  sayı

  Y ekseninin alt sınıra olan uzaklığı.

• sol

  sayı

  Sol sınırdan x ekseni uzaklığı.

• sağ

  sayı

  Sağ sınırdan x ekseni mesafesi.

• üst

  sayı

  Üst sınırdan y ekseni uzaklığı.

LayoutPosition

Chrome 53 veya 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 veya daha yeni bir sürüm

Ayna modu: 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. Diğer tüm bağlı ekranlar genişletilir.

MirrorModeInfo

Chrome 65 veya daha yeni bir sürüm

Özellikler

• mirroringDestinationIds

  string[] isteğe bağlı

  Yansıtma hedefinin kimlikleri gösterilir. Bu yalnızca "karma" için geçerlidir.

• mirroringSourceId

  dize isteğe bağlı

  Yansıtma kaynağı ekranının kimliği. Bu yalnızca "karma" 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

  Point

  Görüntü noktasının koordinatları.

• touchPoint

  Point

  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 kalibrasyonu için ilk dokunma ve görüntüleme noktası gerekir.

• pair2

  TouchCalibrationPair

  Dokunma kalibrasyonu için ikinci bir dokunma ve görüntüleme noktası gerekir.

• pair3

  TouchCalibrationPair

  Dokunma kalibrasyonu için üçüncü dokunma ve görüntüleme noktası gerekir.

• pair4

  TouchCalibrationPair

  Dokunma kalibrasyonu için dördüncü dokunma ve görüntüleme noktası gerekir.

Yöntemler

clearTouchCalibration()

Chrome 57 ve sonraki sürümler

chrome.system.display.clearTouchCalibration(
  id: string,
): void

Ekrana dokunma kalibrasyonunu sıfırlar ve ekranla ilişkili dokunma kalibrasyonu verilerini temizleyerek ekranı varsayılan durumuna geri getirir.

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,
): void

Bir ekran için dokunma kalibrasyonu çiftlerini ayarlar. Bu pairs, startCustomTouchCalibration() içinde çağrılan id ile ekranı kalibre etmek için kullanılır. Bu yöntemi çağırmadan önce her zaman startCustomTouchCalibration çağrısı yapın. Başka bir dokunma kalibrasyonu zaten devam ediyorsa bu işlem hata verir.

Parametreler

• çiftler

  TouchCalibrationPairQuad

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

• sınırlar

  Sınırlar

  Dokunma kalibrasyonu gerçekleştirildiğinde ekranın sınırları. bounds.left ve bounds.top değerleri yok sayılır.

enableUnifiedDesktop()

Chrome 46 ve sonraki sürümler

chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

Birleşik masaüstü özelliğini etkinleştirir/devre dışı bırakır. Yansıtma etkinken etkinleştirilirse yansıtma devre dışı bırakılana kadar masaüstü modu değişmez. Aksi takdirde, masaüstü modu hemen birleşik moda 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 (true) değerini alır.

getDisplayLayout()

Chrome 53 veya sonraki sürümler

chrome.system.display.getDisplayLayout(): Promise<DisplayLayout[]>

Tüm ekranların düzen bilgileri istenir. NOT: Bu özellik yalnızca ChromeOS kiosk uygulamaları ve web kullanıcı arayüzünde kullanılabilir.

İadeler

• Promise<DisplayLayout[]>

  Chrome 91 veya daha yeni bir sürüm

  Sonuçlarla çözümlenen Promise.

getInfo()

chrome.system.display.getInfo(
  flags?: GetInfoFlags,
): Promise<DisplayUnitInfo[]>

Tüm bağlı ekran cihazlarının bilgilerini ister.

Parametreler

• flags

  GetInfoFlags isteğe bağlı

  Chrome 59 veya daha yeni bir sürüm

  Bilgilerin nasıl döndürüleceğini etkileyen seçenekler.

İadeler

• Promise<DisplayUnitInfo[]>

  Chrome 91 veya daha yeni bir sürüm

  Sonuçlarla çözümlenen Promise.

overscanCalibrationAdjust()

Chrome 53 veya sonraki sürümler

chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
): void

Bir ekran için mevcut fazla tarama içlerini ayarlar. Bu genellikle ekranı bir eksen boyunca hareket ettirmeli (ör. sol+sağ aynı değere sahip) veya bir eksen boyunca ölçeklendirmelidir (ör. üst+alt zıt değerlere sahip). Her Adjust çağrısı, Başlangıç'tan bu yana yapılan önceki çağrılarla birlikte kümülatif olarak hesaplanır.

Parametreler

• id

  dize

  Ekranın benzersiz tanımlayıcısı.

• Delta

  İç boşluklar

  Aşırı tarama iç kısımlarını değiştirme miktarı.

overscanCalibrationComplete()

Chrome 53 veya sonraki sürümler

chrome.system.display.overscanCalibrationComplete(
  id: string,
): void

Mevcut değerleri kaydedip yer paylaşımını gizleyerek bir ekran için fazla tarama ayarlamalarını tamamlayın.

Parametreler

• id

  dize

  Ekranın benzersiz tanımlayıcısı.

overscanCalibrationReset()

Chrome 53 veya sonraki sürümler

chrome.system.display.overscanCalibrationReset(
  id: string,
): void

Bir ekranda aşırı tarama içlerini 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 veya sonraki sürümler

chrome.system.display.overscanCalibrationStart(
  id: string,
): void

Bir ekran için overscan kalibrasyonunu başlatır. Bu işlem, ekranda mevcut fazla tarama iç kısımlarını 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 53 veya sonraki sürümler

chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
): Promise<void>

Tüm ekranların düzenini ayarlayın. Dahil edilmeyen tüm ekranlarda varsayılan düzen kullanılır. Çakışan veya başka bir şekilde geçersiz olan düzenler geçerli bir düzene göre ayarlanır. Düzen çö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

• düzenler

  DisplayLayout[]

  Birincil ekran dışındaki tüm ekranlar için gerekli olan düzen bilgileri.

İadeler

• Promise<void>

  Chrome 91 veya daha yeni bir sürüm

  İşlev tamamlandığında çözümlenen söz.

setDisplayProperties()

chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
): Promise<void>

id ile belirtilen ekranın özelliklerini, info içinde verilen 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

  Görüntüleme özellikleriyle ilgili değiştirilmesi gereken bilgiler. Bir özellik yalnızca info içinde yeni bir değer belirtilirse değiştirilir.

İadeler

• Promise<void>

  Chrome 91 veya daha yeni bir sürüm

  İşlev tamamlandığında çözümlenen söz.

setMirrorMode()

Chrome 65 veya daha yeni bir sürüm

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
): Promise<void>

Görüntüleme modunu belirtilen ayna moduna ayarlar. Her arama, önceki aramalardan kalan durumu sıfırlar. setDisplayProperties() işlevi, yansıtma hedefi ekranlarda 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

  Görüntüleme moduna uygulanması gereken ayna modu bilgileri.

İadeler

• Promise<void>

  Chrome 91 veya daha yeni bir sürüm

  İşlev tamamlandığında çözümlenen söz.

showNativeTouchCalibration()

Chrome 57 ve sonraki sürümler

chrome.system.display.showNativeTouchCalibration(
  id: string,
): Promise<boolean>

Ekran kimliği id olan ekran için yerel dokunma kalibrasyonu kullanıcı deneyimini gösterir. Bu işlem, ekranda nasıl devam edeceğinizle ilgili gerekli talimatların yer aldığı bir yer paylaşımı gösterir. 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ı.

İadeler

• Promise<boolean>

  Chrome 91 veya daha yeni bir sürüm

  Arayana dokunma kalibrasyonunun sona erdiğini bildirmek için çözümlenen söz. Boole değeri, kalibrasyonun başarılı olup olmadığını bildirir.

startCustomTouchCalibration()

Chrome 57 ve sonraki sürümler

chrome.system.display.startCustomTouchCalibration(
  id: string,
): void

Bir ekran için özel dokunma kalibrasyonunu başlatır. Bu işlev, kalibrasyon verilerini toplamak için özel bir kullanıcı deneyimi kullanılırken çağrılmalıdır. Başka bir dokunma kalibrasyonu zaten 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,
)

Görüntü yapılandırmasında herhangi bir değişiklik olduğunda tetiklenir.

Parametreler

• callback

  işlev

  callback parametresi şu şekilde görünür:

  () => void